Integración del servidor MCP
ChatReact implementa el Model Context Protocol (MCP), 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 — actualizar instrucciones, personalidad y ajustes del widget
- Crear y actualizar preguntas frecuentes (FAQ) usando lenguaje natural
- Ver analíticas, historial de chat y leads
- Revisar propuestas del Improvement Agent y aprobarlas o rechazarlas
- Monitorizar sesiones de chat en vivo y la cola de espera
Comenzando
1. Genere una clave API
- Vaya a su Dashboard → Company → pestaña API
- Haga clic en Create API Key
- Dé a su clave un nombre descriptivo (p. ej., "Claude Desktop") y seleccione al menos un permiso
- Copie la clave generada (comienza con
cr_)
Las claves API están disponibles en planes de pago — consulte nuestra Pricing page.
Guarde su clave API de forma segura. No puede recuperarse después de creada.
2. Configure su cliente MCP
El servidor MCP de ChatReact está alojado en https://www.chatreact.ai/api/mcp y se comunica por HTTP (JSON-RPC). Autentíquese con un encabezado Authorization: Bearer — también se acepta un encabezado X-API-Key con la misma clave.
Cursor IDE
Cursor admite servidores MCP remotos directamente. Añádalo a la configuración MCP de Cursor:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
El archivo de configuración de Claude Desktop admite servidores basados en comandos, por lo que use el puente estándar mcp-remote para conectarse al endpoint alojado:
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"
]
}
}
}
Esta configuración requiere tener Node.js instalado. El ejemplo usa el encabezado X-API-Key porque algunos clientes no manejan espacios en los argumentos de forma fiable.
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 un conjunto completo de herramientas organizadas en categorías:
Su cuenta
| Herramienta | Descripción |
|---|---|
user_profile | Obtener información de su perfil |
user_companies | Listar la empresa a la que está vinculada su clave API |
user_notifications | Obtener sus notificaciones recientes |
Gestión de la empresa y el equipo
| Herramienta | Descripción |
|---|---|
company_list | Listar la empresa a la que está vinculada su clave API |
company_get | Obtener detalles de una empresa específica |
company_members_list | Listar miembros de la empresa con sus roles |
company_chatbots_list | Listar todos los chatbots de una empresa |
company_update | Actualizar nombre, descripción o ajustes de la empresa |
Gestión de chatbots
| Herramienta | Descripción |
|---|---|
chatbot_list | Listar todos los chatbots con estadísticas resumidas |
chatbot_get | Obtener detalles y configuración de un chatbot |
chatbot_get_instructions | Obtener las instrucciones principales de un chatbot |
chatbot_add_instruction | Añadir una nueva instrucción principal |
chatbot_update_instruction | Actualizar una instrucción principal existente |
chatbot_delete_instruction | Eliminar una instrucción principal |
chatbot_update_personality | Actualizar tonalidad, idioma y mensajes |
chatbot_toggle_active | Activar o desactivar un chatbot |
chatbot_toggle_learning | Habilitar o deshabilitar la fase de aprendizaje |
widget_settings_get | Obtener la configuración actual del widget |
widget_settings_update | Actualizar la apariencia del widget (colores, tamaño, posición) |
Gestión de FAQ
| Herramienta | Descripción |
|---|---|
faq_list | Listar todas las FAQ de un chatbot |
faq_get | Obtener detalles de una FAQ |
faq_create | Crear una nueva FAQ |
faq_update | Actualizar una FAQ existente |
faq_delete | Eliminar una FAQ |
faq_categories_list | Listar categorías de FAQ |
faq_suggestions_list | Listar sugerencias de FAQ pendientes generadas a partir de conversaciones de chat |
Base de conocimientos
| Herramienta | Descripción |
|---|---|
knowledge_documents_list | Listar documentos en la base de conocimientos de un chatbot |
knowledge_document_get | Obtener detalles de un documento específico |
knowledge_document_delete | Eliminar un documento de la base de conocimientos |
knowledge_stats | Obtener estadísticas de la base de conocimientos |
El rastreo de sitios web se gestiona desde el dashboard — vea Knowledge Base.
Gestión de leads
| Herramienta | Descripción |
|---|---|
lead_list | Listar leads con filtrado opcional por estado o categoría |
lead_get | Obtener detalles completos del lead, incluida la sesión de chat de origen |
lead_update | Actualizar el estado, categoría o notas de un lead |
lead_delete | Eliminar un lead de forma permanente |
lead_categories_list | Listar categorías de leads |
lead_stats | Obtener estadísticas de leads, incluidos recuentos por estado |
lead_field_config_get | Obtener la configuración de los campos de captura de leads |
Historial de chat
| Herramienta | Descripción |
|---|---|
chat_sessions_list | Listar sesiones de chat con filtros opcionales |
chat_session_get | Obtener una sesión de chat con todos sus mensajes |
chat_session_search | Buscar sesiones de chat por contenido de mensajes o información del visitante |
Analíticas
| Herramienta | Descripción |
|---|---|
analytics_overview | Obtener conteos de chats, conteos de mensajes y tasas de satisfacción |
analytics_chat_volume | Obtener volumen de chats a lo largo del tiempo para gráficos y tendencias |
Improvement Agent
| Herramienta | Descripción |
|---|---|
improvement_sessions_list | Listar sesiones de mejora |
improvement_session_get | Obtener detalles de la sesión, incluidas las propuestas |
improvement_proposals_pending | Listar propuestas pendientes a la espera de revisión |
improvement_proposal_approve | Aprobar una propuesta y aplicar el cambio |
improvement_proposal_reject | Rechazar una propuesta |
Chat en vivo
| Herramienta | Descripción |
|---|---|
live_chat_sessions_list | Listar sesiones de chat en vivo |
live_chat_session_get | Obtener una sesión de chat en vivo con todos los mensajes |
live_chat_queue | Obtener sesiones en espera de un agente |
Las herramientas de chat en vivo son de solo lectura. Para chatear con visitantes directamente, use el dashboard de Live Chat.
Flujos de trabajo de ejemplo
Añadir una instrucción principal
Pídale a su asistente de IA:
"Añada una instrucción principal a mi chatbot 'Support Bot': ofrecemos envío gratuito en pedidos superiores a €50"
El asistente usará chatbot_add_instruction con los parámetros adecuados.
Revisar sugerencias de mejora
"Muéstrame todas las propuestas de mejora pendientes para mi chatbot y explícale qué cambios sugieren"
El asistente:
- Usará
improvement_proposals_pendingpara obtener las propuestas - Analizará y resumirá cada sugerencia
- Las aprobará o rechazará en su nombre con
improvement_proposal_approveoimprovement_proposal_reject
Analizar el rendimiento del chat
"Dame un informe semanal del volumen de chats y la satisfacción de los clientes para mi chatbot"
El asistente usará analytics_overview y analytics_chat_volume para compilar un informe completo.
Seguridad
- Las claves API están vinculadas a su empresa
- Las claves pueden revocarse en cualquier momento desde el dashboard
- El acceso API está disponible en planes de pago — consulte nuestra Pricing page
Solución de problemas
Conexión fallida
- Verifique que su clave API sea correcta
- Compruebe que la clave no haya sido revocada
- Asegúrese de que su plan incluya acceso API
- Reinicie su cliente MCP
Herramienta no encontrada
Reinicie su cliente MCP después de cambiar la configuración para que vuelva a cargar las herramientas disponibles. Los nombres de las herramientas están en minúsculas con guiones bajos (p. ej., faq_list).
¿Necesita ayuda? Contact our support team →