Integração do Servidor MCP

ChatReact implementa o Model Context Protocol (MCP), permitindo que você conecte sua conta ChatReact a assistentes de IA como Claude Desktop, Cursor e outras ferramentas compatíveis com MCP.

O que é MCP?

O Model Context Protocol é um padrão aberto que permite que assistentes de IA interajam com serviços externos e fontes de dados. Com a integração MCP do ChatReact, você pode:

Gerenciar chatbots diretamente do seu assistente de IA
Criar e atualizar FAQs usando linguagem natural
Visualizar análises e histórico de chats
Controlar o Improvement Agent para otimização do chatbot
Gerenciar sessões de chat ao vivo sem sair da sua ferramenta de IA

Começando

1. Gere uma Chave de API

Navegue até seu Dashboard → Settings → API Keys
Clique em Create API Key
Dê à sua chave um nome descritivo (por exemplo, "Claude Desktop")
Copie a chave gerada (começa com cr_)

Armazene sua chave de API com segurança. Ela não pode ser recuperada após a criação.

2. Configure Seu Cliente MCP

Claude Desktop

Adicione o seguinte ao arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Cursor IDE

Adicione às configurações do seu Cursor MCP:

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Desenvolvimento Local (stdio)

Para desenvolvimento local, você pode usar nosso pacote npm:

npm install -g @chatreact/mcp

Configure no seu cliente MCP:

{
  "mcpServers": {
    "chatreact": {
      "command": "chatreact-mcp",
      "args": ["--api-key", "cr_your_api_key_here"]
    }
  }
}

3. Reinicie seu AI Assistant

Após salvar a configuração, reinicie o Claude Desktop ou o Cursor para estabelecer a conexão.

Ferramentas Disponíveis

O ChatReact MCP oferece mais de 30 ferramentas organizadas em categorias:

Gestão de Empresa e Equipe

Tool	Description
`company_list`	List all companies you have access to
`company_get`	Get details of a specific company
`company_team_list`	List team members of a company

Gestão de Chatbot

Tool	Description
`chatbot_list`	List all chatbots in a company
`chatbot_get`	Get chatbot details and configuration
`chatbot_create`	Create a new chatbot
`chatbot_update`	Update chatbot settings
`chatbot_get_instructions`	Get core instructions for a chatbot
`chatbot_add_instruction`	Add a new core instruction

Gestão de FAQ

Tool	Description
`faq_list`	List all FAQs for a chatbot
`faq_get`	Get FAQ details
`faq_create`	Create a new FAQ
`faq_update`	Update an existing FAQ
`faq_delete`	Delete an FAQ
`faq_categories_list`	List FAQ categories
`faq_suggest`	Generate AI-suggested FAQs

Knowledge Base

Tool	Description
`knowledge_list_documents`	List uploaded documents
`knowledge_list_websites`	List crawled websites
`knowledge_crawl_website`	Start a website crawl
`knowledge_get_crawl_status`	Check crawl progress

Analytics

Tool	Description
`analytics_overview`	Get overall performance metrics
`analytics_chat_volume`	Get chat volume over time
`analytics_feedback`	Get feedback and ratings
`analytics_chat_history`	Browse chat sessions
`analytics_get_session`	Get detailed session data

Improvement Agent

Tool	Description
`improvement_list_sessions`	List improvement sessions
`improvement_start_session`	Start a new analysis session
`improvement_list_proposals`	List improvement proposals
`improvement_get_proposal`	Get proposal details
`improvement_create_proposal`	Create a custom proposal
`improvement_simulate_proposal`	Preview proposal effects
`improvement_apply_proposal`	Apply a proposal
`improvement_reject_proposal`	Reject a proposal

Live Chat

Tool	Description
`livechat_get_queue`	Get waiting chat sessions
`livechat_get_active_sessions`	List active human agent sessions
`livechat_get_session`	Get session details
`livechat_assign_session`	Assign yourself to a session
`livechat_send_message`	Send a message as agent
`livechat_close_session`	Close a chat session
`livechat_check_availability`	Check agent availability

Exemplos de Fluxos de Trabalho

Criando um Novo Chatbot

Peça ao seu assistente de IA:

"Create a new chatbot called 'Support Bot' for my company 'acme-corp' with a friendly, professional tone"

O assistente usará chatbot_create com os parâmetros apropriados.

Revisando Sugestões de Melhoria

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

O assistente irá:

Usar improvement_list_proposals para buscar propostas
Analisar e resumir cada sugestão
Ajudar você a decidir quais aplicar

Analisando o Desempenho de Conversas

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

O assistente usará analytics_overview e analytics_feedback para compilar um relatório abrangente.

Segurança

As chaves de API são vinculadas à sua conta de usuário e ao acesso da empresa
Todas as requisições são registradas no trilho de auditoria
As chaves podem ser revogadas a qualquer momento a partir do painel
Aplicam-se limites de taxa: 60 requests/minute

Solução de Problemas

Conexão Falhou

Verifique se sua chave de API está correta
Confira se a chave não foi revogada
Garanta que você tenha uma conexão com a internet ativa
Reinicie seu cliente MCP

Ferramenta Não Encontrada

Algumas ferramentas exigem permissões específicas. Certifique-se de que você tenha a função apropriada na empresa (Owner, Admin, ou Manager).

Limite de Taxa Excedido

Se você vir erros de limite de taxa, aguarde um minuto antes de tentar novamente. Considere agrupar operações quando possível.

Precisa de ajuda? Contact our support team →