InicioDocumentación

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

  1. Vaya a su DashboardCompany → pestaña API
  2. Haga clic en Create API Key
  3. Dé a su clave un nombre descriptivo (p. ej., "Claude Desktop") y seleccione al menos un permiso
  4. 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

HerramientaDescripción
user_profileObtener información de su perfil
user_companiesListar la empresa a la que está vinculada su clave API
user_notificationsObtener sus notificaciones recientes

Gestión de la empresa y el equipo

HerramientaDescripción
company_listListar la empresa a la que está vinculada su clave API
company_getObtener detalles de una empresa específica
company_members_listListar miembros de la empresa con sus roles
company_chatbots_listListar todos los chatbots de una empresa
company_updateActualizar nombre, descripción o ajustes de la empresa

Gestión de chatbots

HerramientaDescripción
chatbot_listListar todos los chatbots con estadísticas resumidas
chatbot_getObtener detalles y configuración de un chatbot
chatbot_get_instructionsObtener las instrucciones principales de un chatbot
chatbot_add_instructionAñadir una nueva instrucción principal
chatbot_update_instructionActualizar una instrucción principal existente
chatbot_delete_instructionEliminar una instrucción principal
chatbot_update_personalityActualizar tonalidad, idioma y mensajes
chatbot_toggle_activeActivar o desactivar un chatbot
chatbot_toggle_learningHabilitar o deshabilitar la fase de aprendizaje
widget_settings_getObtener la configuración actual del widget
widget_settings_updateActualizar la apariencia del widget (colores, tamaño, posición)

Gestión de FAQ

HerramientaDescripción
faq_listListar todas las FAQ de un chatbot
faq_getObtener detalles de una FAQ
faq_createCrear una nueva FAQ
faq_updateActualizar una FAQ existente
faq_deleteEliminar una FAQ
faq_categories_listListar categorías de FAQ
faq_suggestions_listListar sugerencias de FAQ pendientes generadas a partir de conversaciones de chat

Base de conocimientos

HerramientaDescripción
knowledge_documents_listListar documentos en la base de conocimientos de un chatbot
knowledge_document_getObtener detalles de un documento específico
knowledge_document_deleteEliminar un documento de la base de conocimientos
knowledge_statsObtener estadísticas de la base de conocimientos

El rastreo de sitios web se gestiona desde el dashboard — vea Knowledge Base.

Gestión de leads

HerramientaDescripción
lead_listListar leads con filtrado opcional por estado o categoría
lead_getObtener detalles completos del lead, incluida la sesión de chat de origen
lead_updateActualizar el estado, categoría o notas de un lead
lead_deleteEliminar un lead de forma permanente
lead_categories_listListar categorías de leads
lead_statsObtener estadísticas de leads, incluidos recuentos por estado
lead_field_config_getObtener la configuración de los campos de captura de leads

Historial de chat

HerramientaDescripción
chat_sessions_listListar sesiones de chat con filtros opcionales
chat_session_getObtener una sesión de chat con todos sus mensajes
chat_session_searchBuscar sesiones de chat por contenido de mensajes o información del visitante

Analíticas

HerramientaDescripción
analytics_overviewObtener conteos de chats, conteos de mensajes y tasas de satisfacción
analytics_chat_volumeObtener volumen de chats a lo largo del tiempo para gráficos y tendencias

Improvement Agent

HerramientaDescripción
improvement_sessions_listListar sesiones de mejora
improvement_session_getObtener detalles de la sesión, incluidas las propuestas
improvement_proposals_pendingListar propuestas pendientes a la espera de revisión
improvement_proposal_approveAprobar una propuesta y aplicar el cambio
improvement_proposal_rejectRechazar una propuesta

Chat en vivo

HerramientaDescripción
live_chat_sessions_listListar sesiones de chat en vivo
live_chat_session_getObtener una sesión de chat en vivo con todos los mensajes
live_chat_queueObtener 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:

  1. Usará improvement_proposals_pending para obtener las propuestas
  2. Analizará y resumirá cada sugerencia
  3. Las aprobará o rechazará en su nombre con improvement_proposal_approve o improvement_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

  1. Verifique que su clave API sea correcta
  2. Compruebe que la clave no haya sido revocada
  3. Asegúrese de que su plan incluya acceso API
  4. 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 →