Integración del servidor MCP

ChatReact implementa el Model Context Protocol (MCP), lo que le permite conectar su cuenta de ChatReact con asistentes de IA como Claude Desktop, Cursor y otras herramientas compatibles con MCP.

¿Qué es MCP?

El Model Context Protocol es un estándar abierto que permite a los asistentes de IA interactuar con servicios externos y fuentes de datos. Con la integración MCP de ChatReact, usted puede:

Gestionar chatbots directamente desde su asistente de IA
Crear y actualizar FAQs usando lenguaje natural
Ver analíticas e historial de chats
Controlar el Improvement Agent para la optimización del chatbot
Gestionar sesiones de chat en vivo sin salir de su herramienta de IA

Primeros pasos

1. Genere una clave API

Vaya a su Dashboard → Settings → API Keys
Haga clic en Create API Key
Dé a su clave un nombre descriptivo (p. ej., "Claude Desktop")
Copie la clave generada (comienza con cr_)

Guarde su clave API de forma segura. No se puede recuperar después de creada.

2. Configure su cliente MCP

Claude Desktop

Agregue lo siguiente al archivo de configuración de 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

Agregue a la configuración de Cursor MCP:

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

Desarrollo local (stdio)

Para el desarrollo local, puede usar nuestro paquete npm:

npm install -g @chatreact/mcp

Configure en su cliente MCP:

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

3. Reinicie su asistente de IA

Después de guardar la configuración, reinicie Claude Desktop o Cursor para establecer la conexión.

Herramientas disponibles

ChatReact MCP proporciona más de 30 herramientas organizadas en categorías:

Gestión de empresa y equipo

Tool	Description
`company_list`	Enumere todas las empresas a las que tiene acceso
`company_get`	Obtenga los detalles de una empresa específica
`company_team_list`	Liste los miembros del equipo de una empresa

Gestión de chatbots

Tool	Description
`chatbot_list`	Enumere todos los chatbots en una empresa
`chatbot_get`	Obtenga los detalles y la configuración del chatbot
`chatbot_create`	Cree un nuevo chatbot
`chatbot_update`	Actualice la configuración del chatbot
`chatbot_get_instructions`	Obtenga las instrucciones core para un chatbot
`chatbot_add_instruction`	Añada una nueva instrucción core

Gestión de FAQ

Tool	Description
`faq_list`	Enumere todas las FAQs de un chatbot
`faq_get`	Obtenga los detalles de una FAQ
`faq_create`	Cree una nueva FAQ
`faq_update`	Actualice una FAQ existente
`faq_delete`	Elimine una FAQ
`faq_categories_list`	Liste las categorías de FAQ
`faq_suggest`	Genere FAQs sugeridas por IA

Knowledge Base

Tool	Description
`knowledge_list_documents`	Liste los documentos subidos
`knowledge_list_websites`	Liste los sitios web rastreados
`knowledge_crawl_website`	Inicie un rastreo de sitio web
`knowledge_get_crawl_status`	Compruebe el progreso del rastreo

Analytics

Tool	Description
`analytics_overview`	Obtenga métricas de rendimiento generales
`analytics_chat_volume`	Obtenga el volumen de chats a lo largo del tiempo
`analytics_feedback`	Obtenga comentarios y valoraciones
`analytics_chat_history`	Explore sesiones de chat
`analytics_get_session`	Obtenga datos detallados de una sesión

Improvement Agent

Tool	Description
`improvement_list_sessions`	Liste sesiones de mejora
`improvement_start_session`	Inicie una nueva sesión de análisis
`improvement_list_proposals`	Liste propuestas de mejora
`improvement_get_proposal`	Obtenga detalles de una propuesta
`improvement_create_proposal`	Cree una propuesta personalizada
`improvement_simulate_proposal`	Previsualice los efectos de una propuesta
`improvement_apply_proposal`	Aplique una propuesta
`improvement_reject_proposal`	Rechace una propuesta

Live Chat

Tool	Description
`livechat_get_queue`	Obtenga las sesiones de chat en espera
`livechat_get_active_sessions`	Liste las sesiones activas de agentes humanos
`livechat_get_session`	Obtenga los detalles de una sesión
`livechat_assign_session`	Asígnese a una sesión
`livechat_send_message`	Envíe un mensaje como agente
`livechat_close_session`	Cierre una sesión de chat
`livechat_check_availability`	Compruebe la disponibilidad de agentes

Flujos de trabajo de ejemplo

Crear un nuevo chatbot

Pregunte a su asistente de IA:

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

El asistente utilizará chatbot_create con los parámetros apropiados.

Revisar sugerencias de mejora

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

El asistente:

Usará improvement_list_proposals para obtener las propuestas
Analizará y resumirá cada sugerencia
Le ayudará a decidir cuáles aplicar

Analizar el rendimiento de chat

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

El asistente usará analytics_overview y analytics_feedback para compilar un informe completo.

Seguridad

Las claves de API están limitadas a su cuenta de usuario y al acceso a la empresa
Todas las solicitudes se registran en la pista de auditoría
Las claves pueden revocarse en cualquier momento desde el panel
Se aplican límites de tasa: 60 requests/minute

Solución de problemas

Conexión fallida

Verifique que su clave de API sea correcta
Compruebe que la clave no haya sido revocada
Asegúrese de tener una conexión a Internet activa
Reinicie su cliente MCP

Herramienta no encontrada

Algunas herramientas requieren permisos específicos. Asegúrese de tener el rol apropiado en la empresa (Owner, Admin o Manager).

Límite de tasa alcanzado

Si ve errores de límite de tasa, espere un minuto antes de reintentar. Considere agrupar operaciones cuando sea posible.

¿Necesita ayuda? Contact our support team →