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 é o MCP?

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

• Gerenciar chatbots — atualizar instruções, personalidade e configurações do widget
• Criar e atualizar FAQs usando linguagem natural
• Visualizar análises, histórico de chats e leads
• Revisar propostas do Improvement Agent e aprová-las ou rejeitá-las
• Monitorar sessões de chat em tempo real e a fila de espera

Primeiros Passos

1. Gerar uma Chave de API

1. Navegue até seu Dashboard → Company → aba API
2. Clique em Create API Key
3. Dê à sua chave um nome descritivo (por exemplo, "Claude Desktop") e selecione pelo menos uma permissão
4. Copie a chave gerada (começa com cr_)

2. Configure Seu Cliente MCP

O servidor MCP do ChatReact está hospedado em https://www.chatreact.ai/api/mcp e se comunica via HTTP (JSON-RPC). Autentique usando um cabeçalho Authorization: Bearer — um cabeçalho X-API-Key com a mesma chave também é aceito.

Cursor IDE

O Cursor suporta servidores MCP remotos diretamente. Adicione nas suas configurações MCP do Cursor:

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

Claude Desktop

O arquivo de configuração do Claude Desktop suporta servidores baseados em comandos, então use a ponte padrão mcp-remote para conectar ao endpoint hospedado:

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

{
  "mcpServers": {
    "chatreact": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.chatreact.ai/api/mcp",
        "--header",
        "X-API-Key:cr_your_api_key_here"
      ]
    }
  }
}

3. Reinicie Seu Assistente de IA

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

Ferramentas Disponíveis

O MCP do ChatReact fornece um conjunto abrangente de ferramentas organizadas por categorias:

Sua Conta

Gestão de Empresa & Equipe

Gestão de Chatbot

Gestão de FAQ

Base de Conhecimento

Gestão de Leads

Histórico de Chat

Analytics

Improvement Agent

Chat em Tempo Real

Exemplos de Fluxos de Trabalho

Adicionando uma Instrução Principal

Peça ao seu assistente de IA:

"Adicione uma instrução principal ao meu chatbot 'Support Bot': oferecemos frete grátis em pedidos acima de €50"

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

Revisando Sugestões de Melhoria

"Mostre-me todas as propostas de melhoria pendentes para meu chatbot e explique quais mudanças elas sugerem"

O assistente irá:

1. Usar improvement_proposals_pending para buscar propostas
2. Analisar e resumir cada sugestão
3. Aprovar ou rejeitar em seu nome com improvement_proposal_approve ou improvement_proposal_reject

Analisando o Desempenho do Chat

"Forneça um relatório semanal do volume de chats e satisfação dos clientes para meu chatbot"

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

Segurança

• As chaves de API estão vinculadas à sua empresa
• As chaves podem ser revogadas a qualquer momento a partir do dashboard
• O acesso à API está disponível em planos pagos — veja nossa Pricing page

Solução de Problemas

Conexão Falhou

1. Verifique se sua chave de API está correta
2. Verifique se a chave não foi revogada
3. Certifique-se de que seu plano inclui acesso à API
4. Reinicie seu cliente MCP

Ferramenta Não Encontrada

Reinicie seu cliente MCP após alterar a configuração para que ele recarregue as ferramentas disponíveis. Os nomes das ferramentas são em letras minúsculas com underscores (por exemplo, faq_list).

Precisa de ajuda? Contact our support team →