Integración del servidor MCP
ChatReact implementa el Model Context Protocol (MCP), lo que le permite conectar su cuenta de ChatReact a 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 y fuentes de datos externas. Con la integración MCP de ChatReact, usted puede:
- Gestionar chatbots — crear, configurar (persona, idiomas, widget, comportamiento, restricciones), insertar y eliminar chatbots
- Construir la base de conocimientos — añadir documentos, rastrear sitios web, gestionar páginas rastreadas e instrucciones principales
- Gestionar FAQs — FAQs, categorías, sugerencias, traducciones y el widget de FAQ
- Revisar chats — calificar conversaciones, asignar categorías de confianza, ejecutar el Improvement Agent
- Trabajar con leads y formularios — leads, categorías de leads, ajustes de captura, formularios de contacto y envíos
- Actuar como agente de chat en vivo — establecer su disponibilidad, hacerse cargo de chats en espera, responder y cerrar sesiones
- Administrar su empresa — perfil, colores de marca, miembros del equipo e invitaciones
- Usar el Email Assistant — conexiones de buzón, categorías, contactos y actividad
- Leer analíticas y notificaciones
Todo lo que puede hacer en el panel está disponible mediante MCP (y la REST API); solo las acciones ligadas al navegador como pagos, OAuth de buzones, passkeys, eliminación de cuenta y gestión de claves API permanecen en el panel.
Primeros pasos
1. Genere una clave API
- Navegue a su Panel de control → Empresa → API pestaña
- Haga clic en Crear Clave API
- 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 — vea nuestra página de Precios.
Guarde su clave API de forma segura. No se puede recuperar después de crearla.
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). Autentique 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 sus ajustes 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, así 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 instalado Node.js. El ejemplo usa el encabezado X-API-Key porque algunos clientes no manejan bien los espacios en los argumentos.
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 expone las herramientas siguientes, agrupadas por área. La columna Scope muestra el permiso de la clave API que una herramienta requiere (any = toda clave válida). Las herramientas se ejecutan con los mismos permisos aplicables, límites del plan y efectos secundarios que las operaciones soportadas en el panel. Los flujos de trabajo ligados al navegador para pagos, autorización de buzón, passkeys, eliminación de cuenta y gestión de claves permanecen en el panel.
Las herramientas destructivas (eliminar, reiniciar, cerrar, fusionar) piden confirmación cuando se usan a través del Dashboard Assistant. Mediante clave API se ejecutan de inmediato.
Cuenta
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Obtenga el plan actual (nivel, estado), los contadores de uso del periodo de facturación actual (empresas, chatbots, miembros del equipo, chats, tokens) y los límites del plan, además de los límites efectivos y flags de características de la empresa a la que la llamada está limitada. | any |
user_companies | Liste todas las empresas a las que el usuario actual tiene acceso, con el rol del usuario en cada una. | any |
user_notification_mark_read | Marque una de las notificaciones del usuario actual como leída. | any |
user_notification_preferences_get | Obtenga las preferencias de notificación del usuario actual: conmutadores globales email/push, frecuencia/hora/día de resumen, zona horaria, quiet hours y ajustes de canal por tipo. | any |
user_notification_preferences_update | Actualice las preferencias globales de notificación del usuario actual (conmutadores email/push, horario de resumen, quiet hours). | any |
user_notification_type_setting_update | Habilite o deshabilite la entrega por email / en la app para un único tipo de notificación del usuario actual (por ejemplo | any |
user_notification_types_list | Liste todos los tipos de notificación agrupados por categoría (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Obtenga el número de notificaciones no leídas del usuario actual. | any |
user_notifications | Liste las notificaciones del usuario actual, de la más nueva a la más antigua, con paginación por cursor. | any |
user_notifications_delete_old | Tareas de mantenimiento: eliminar permanentemente las notificaciones del usuario actual que ya están leídas y tengan más de 30 días. | any |
user_notifications_mark_all_read | Marcar todas las notificaciones del usuario actual como leídas. | any |
user_profile | Obtenga el perfil del usuario actual (id, nombre, email, rol, nivel de suscripción). | any |
Empresa y equipo
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Liste todos los chatbots de una empresa específica con estadísticas resumidas. | chatbots:read |
company_get | Obtenga información detallada sobre una empresa: perfil, propietario, ajustes de marca (colores, email de notificaciones) y conteos. | any |
company_invite_cancel | Cancele (elimine) una invitación de equipo para que el enlace deje de funcionar. | company:write |
company_invite_resend | Reenvíe una invitación de equipo pendiente: emite un nuevo token, extiende la expiración 7 días y envía el email de invitación nuevamente. | company:write |
company_invites_list | Liste las invitaciones de equipo de una empresa (pendientes por defecto; establezca includeExpired para también devolver las expiradas). | company:read |
company_list | Liste todas las empresas a las que el usuario tiene acceso (las claves API y el Dashboard Assistant solo ven su propia empresa). | any |
company_logo_remove | Elimine el logo de la empresa (borra la imagen almacenada y limpia la URL del logo). | company:write |
company_member_invite | Invite a un miembro del equipo por email con un rol (ADMIN, MANAGER, AGENT o VIEWER). | company:write |
company_member_remove | Elimine un miembro del equipo de la empresa. | company:write |
company_member_update_role | Cambie el rol de un miembro del equipo (ADMIN, MANAGER, AGENT o VIEWER). | company:write |
company_members_list | Liste los miembros de una empresa con sus roles (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Actualice los ajustes de marca de la empresa: primaryColor / secondaryColor (#RRGGBB) y el notificationEmail para revisiones de chat. | company:write |
company_update | Actualice el perfil de la empresa: nombre (2-100 caracteres), descripción (máx. 1000 caracteres) o sitio web (https:// se añade automáticamente; pase una cadena vacía para borrar sitio web/descrpción). | company:write |
Gestión de chatbots
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Añada una nueva instrucción principal a un chatbot (1-5000 caracteres). | chatbots:write |
chatbot_confirm_embed | Marque un chatbot como insertado en el sitio web (oculta el recordatorio de configuración en el panel). | chatbots:write |
chatbot_create | Cree un nuevo chatbot (igual que el asistente del panel). | chatbots:write |
chatbot_delete | Elimine permanentemente un chatbot con todas sus FAQs, documentos, chats, leads y formularios (no deshacer). | chatbots:write |
chatbot_delete_instruction | Elimine una instrucción principal de un chatbot. | chatbots:write |
chatbot_get | Obtenga información detallada sobre un chatbot: ajustes generales, personalidad (persona, tonalidad, idiomas, restricciones), ajustes del widget, chat en vivo, fase de aprendizaje, estado de inserción y conteos. | chatbots:read |
chatbot_get_embed_code | Obtenga el fragmento HTML para instalar un chatbot en un sitio web (URL del script + etiqueta <script>) y si la inserción ha sido confirmada. | chatbots:read |
chatbot_get_instructions | Obtenga todas las instrucciones principales de un chatbot. | chatbots:read |
chatbot_improve_instructions | Reescriba el texto de una instrucción principal con el mejorador de IA de la plataforma (igual que "Improve with AI" del panel). | chatbots:write |
chatbot_learning_phase_get | Obtenga los ajustes de la fase de aprendizaje de un chatbot: preset de comportamiento (CAUTIOUS, BALANCED, CONFIDENT), prompt personalizado y si el bot aún está en fase de aprendizaje. | chatbots:read |
chatbot_learning_phase_update | Establezca el preset de comportamiento de la fase de aprendizaje (CAUTIOUS = remitir a humano cuando no está seguro, BALANCED, CONFIDENT) y/o un prompt personalizado para la fase de aprendizaje. | chatbots:write |
chatbot_list | Liste todos los chatbots a los que el usuario tiene acceso, con estadísticas resumidas. | chatbots:read |
chatbot_reorder_instructions | Establezca el orden de las instrucciones principales de un chatbot. | chatbots:write |
chatbot_templates_list | Liste las plantillas de chatbot (presets para persona, tonalidad, mensajes y comportamiento del widget) que pueden pasarse como templateId a chatbot_create, y si el plan de la empresa puede usarlas. | chatbots:read |
chatbot_toggle_active | Active o desactive un chatbot. | chatbots:write |
chatbot_toggle_learning | Finalice (false) o vuelva a habilitar (true) la fase de aprendizaje de un chatbot. | chatbots:write |
chatbot_update | Actualice los ajustes generales de un chatbot: nombre, descripción, isActive, live chat (liveChatEnabled/liveChatMode, característica del plan), showBranding (planes white-label), emails de revisión de chat, generación automática de FAQs, texto legacy de coreInstructions, fase de aprendizaje (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Actualice una instrucción principal existente (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Actualice la personalidad de un chatbot: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), barras de tonalidad 1-5, idiomas (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), mensajes (welcomeMessage, fallbackMessage, proactive greeting) y restricciones (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Obtenga los ajustes actuales del widget para un chatbot (toda la apariencia, branding, comportamiento y campos de pre-chat). | chatbots:read |
widget_settings_update | Actualice el widget de chat de un chatbot: posición (incl. | chatbots:write |
widget_translations_get | Obtenga las traducciones del widget por idioma de un chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Establezca traducciones del widget por idioma. | chatbots:write |
Base de conocimientos
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Cancele un trabajo de rastreo PENDING o RUNNING; las páginas restantes se omiten. | knowledge:write |
crawler_job_get | Obtenga el estado de un trabajo de rastreo, progreso (pagesCrawled/pagesFound, tokensUsed) y el estado de cada página. | knowledge:read |
crawler_jobs_list | Liste los trabajos de rastreo de un chatbot (del más nuevo al más antiguo) con estado y progreso. | knowledge:read |
crawler_limits | Obtenga los límites de rastreo del plan para un chatbot (máx. páginas por rastreo, tokens por página, rastreos por mes) y si se puede iniciar un nuevo rastreo este mes. | knowledge:read |
crawler_preview_scan | Escanee un sitio web y liste sus páginas rastreables (url, title, isRecommended) sin importar nada. | knowledge:write |
crawler_start | Inicie un trabajo de rastreo que importe las URLs seleccionadas a la base de conocimientos del chatbot (procesado en segundo plano; sondee crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Descargue un documento (PDF, TXT, MD, CSV, JSON, DOCX; máx. 10 MB) desde una URL pública http(s) y añádalo a la base de conocimientos de un chatbot. | knowledge:write |
knowledge_document_add_text | Añada un documento de texto o markdown a la base de conocimientos de un chatbot desde contenido inline (máx. 10 MB). | knowledge:write |
knowledge_document_delete | Elimine un documento subido de la base de conocimientos. | knowledge:write |
knowledge_document_get | Obtenga detalles de un documento subido incluyendo el estado de procesamiento, mensaje de error y una URL de descarga de corta duración. | knowledge:read |
knowledge_documents_list | Liste los documentos subidos (PDF, TXT, MD, CSV, JSON, DOCX) en la base de conocimientos de un chatbot con estado y tamaño. | knowledge:read |
knowledge_page_add | Rastree una única URL y añádala a la base de conocimientos del chatbot (falla con CONFLICT cuando la URL ya está indexada, FORBIDDEN cuando se alcanza el límite de tokens). | knowledge:write |
knowledge_page_delete | Elimine una página rastreada de la base de conocimientos (elimina su archivo de vector-store). | knowledge:write |
knowledge_page_get | Obtenga una página rastreada incluyendo el contenido en markdown que se indexó para el chatbot (útil para verificar lo que el bot sabe sobre una página). | knowledge:read |
knowledge_page_recrawl | Vuelva a obtener una página rastreada y reemplace su contenido indexado (p. ej. | knowledge:write |
knowledge_pages_delete | Elimine varias páginas rastreadas de un chatbot a la vez. | knowledge:write |
knowledge_pages_list | Liste las páginas rastreadas en la base de conocimientos de un chatbot, opcionalmente filtradas por dominio, estado o término de búsqueda (URL/title). | knowledge:read |
knowledge_stats | Visión general de la base de conocimientos de un chatbot: documentos (por estado, tamaño), páginas rastreadas y sitios web (por estado), trabajos de rastreo, instrucciones principales divididas por fuente (manual vs improvement agent), FAQs, estado/tamaño del vector store y uso de almacenamiento vs. | knowledge:read |
knowledge_website_delete | Elimine todas las páginas rastreadas de un sitio web (dominio) de la base de conocimientos del chatbot. | knowledge:write |
knowledge_website_recrawl | Vuelva a rastrear todas las páginas de un sitio web (dominio) en la base de conocimientos del chatbot para refrescar su contenido. | knowledge:write |
knowledge_website_recrawl_cancel | Cancele una reindexación de sitio en curso: las páginas en cola (PENDING) del dominio se revierten a su estado indexado anterior. | knowledge:write |
knowledge_websites_list | Liste los sitios web (dominios) cuyas páginas están en la base de conocimientos de un chatbot, con conteos de páginas por estado y totales de tokens. | knowledge:read |
Gestión de precios
Estas herramientas gestionan borradores de precios estructurados y aprobaciones explícitas. Guardar un borrador está separado de aprobar la versión exacta; la elegibilidad también depende del estado y la validez. Las claves API existentes no obtienen permisos de precios automáticamente. Solo el propietario de la empresa puede otorgar prices:write o prices:approve. Las llamadas con clave API se ejecutan directamente, así que revise la entrada exacta antes de invocar una mutación. Consulte Prices & services para el flujo de trabajo del cliente.
| Tool | Description | Scope |
|---|---|---|
price_list | Pagine a través de price heads y la elegibilidad de versión aprobada por separado. | prices:read |
price_get | Lea el estado completo del ítem y sus revisiones. | prices:read |
price_detail | Lea el detalle del ítem con historial de revisiones paginado. | prices:read |
price_suggestions_list | Pagine a través de sugerencias de precio. | prices:read |
price_create | Cree un borrador con un ID de ítem generado por el servidor. | prices:write |
price_edit | Cree un nuevo borrador desde una versión de ítem explícitamente esperada. | prices:write |
price_import_csv | Importe borradores con un formato explícito y un ID de importación estable para reintentos seguros. | prices:write |
price_suggestion_apply | Aplique el candidato de sugerencia seleccionado como un borrador. | prices:write |
price_approve | Apruebe una versión de ítem explícitamente esperada. | prices:approve |
price_approve_many | Apruebe una selección de ID/versiones explícitas de forma atómica; cualquier versión desactualizada rechaza toda la selección. | prices:approve |
price_archive | Archive un ítem en su versión explícitamente esperada. | prices:approve |
Las ediciones de borrador preservan la revisión aprobada anterior. El formato CSV y el separador decimal deben ser explícitos; el contenido CSV cambiado requiere un nuevo import ID. Todas las operaciones están ligadas a la empresa de la clave API y al chatbot especificado.
Gestión de FAQ
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Borre los datos en caché del widget de FAQ en todos los sitios CMS conectados (plugin de WordPress). | faqs:write |
faq_categories_list | Liste las categorías de FAQ de un chatbot con sus conteos de FAQ, slugs, modo de orden y traducciones. | faqs:read |
faq_categories_reorder | Establezca el orden de las categorías de FAQ en el widget: la posición en categoryIds se convierte en sortOrder. | faqs:write |
faq_category_create | Cree una categoría de FAQ para un chatbot (el slug se genera a partir del nombre). | faqs:write |
faq_category_delete | Elimine una categoría de FAQ. | faqs:write |
faq_category_translations_update | Reemplace las traducciones de una categoría de FAQ, p. ej. | faqs:write |
faq_category_update | Renombre una categoría de FAQ o cambie su descripción, icono o modo de orden. | faqs:write |
faq_create | Cree una FAQ para un chatbot. | faqs:write |
faq_delete | Elimine permanentemente una FAQ (también la remueve de la base de conocimientos del chatbot y purga las cachés del widget CMS). | faqs:write |
faq_embed_code_get | Obtenga los snippets de inserción para el widget de FAQ: etiqueta de script, shortcode de WordPress y snippet de Shopify Liquid, además de variantes por categoría (use categorySlug de faq_categories_list para insertar solo una categoría). | chatbots:read |
faq_get | Obtenga los detalles completos de una FAQ: pregunta, respuesta, categoría, estado de publicación, orden, traducciones, campos SEO y estadísticas de feedback. | faqs:read |
faq_list | Liste las FAQs de un chatbot (use chatbot_list para encontrar el chatbotId). | faqs:read |
faq_reorder | Establezca el orden de visualización de las FAQs en el widget. | faqs:write |
faq_suggestion_approve | Apruebe una sugerencia de FAQ en estado PENDING: crea una FAQ publicada (opcionalmente con pregunta/respuesta/categoría editadas) y marca la sugerencia como APPROVED. | faqs:write |
faq_suggestion_get | Obtenga los detalles completos de una sugerencia de FAQ (respuesta completa, razonamiento de la IA, categoría sugerida, estado de revisión). | faqs:read |
faq_suggestion_reject | Rechace una sugerencia de FAQ PENDING con una razón opcional. | faqs:write |
faq_suggestions_generate | Permita que la IA proponga nuevas FAQs desde la base de conocimientos del chatbot (páginas rastreadas / documentos subidos), opcionalmente para una categoría. | faqs:write |
faq_suggestions_list | Liste las sugerencias de FAQ generadas por IA de un chatbot (desde conversaciones de chat o faq_suggestions_generate). | faqs:read |
faq_translate | Traduza la pregunta y respuesta de una FAQ con IA a los otros idiomas soportados por el chatbot (o a los targetLanguages dados) y guarde el resultado. | faqs:write |
faq_translations_update | Guarde traducciones de una FAQ por idioma, p. ej. | faqs:write |
faq_update | Actualice la pregunta, respuesta, categoría, estado de publicación u orden manual de una FAQ. | faqs:write |
faq_widget_settings_get | Obtenga los ajustes de apariencia y comportamiento del widget de FAQ embebible (colores, radio de borde, título, espaciado, ancho máximo, allowMultipleOpen, autoOpenFirst, modo de orden, traducciones de título). | chatbots:read |
faq_widget_settings_update | Actualice los ajustes del widget de FAQ: colores (hex), borderRadius 0-32, título (máx. 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = ancho completo), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name y traducciones de título por idioma. | chatbots:write |
Historial de chat y feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Marque un chat como revisado sin calificarlo (lo elimina de la cola pendiente, no cambia la puntuación de confianza). | chats:write |
chat_feedback_get | Obtenga una revisión de chat (feedback) con análisis de IA, severidad, categoría de confianza, cambio de puntuación y la sesión de mejora vinculada. | chats:read |
chat_feedback_list | Liste las revisiones de chat (filas de feedback) de un chatbot con filtro por estado y conteos. | chats:read |
chat_feedback_set_severity | Anule la clasificación de severidad (MINOR|MODERATE|MAJOR|CRITICAL) de un chat negativo revisado; la severidad pondera la caída de la puntuación de confianza. | chats:write |
chat_feedback_stats | Conteos de sesiones por bucket de revisión para un chatbot (total, none, pending, positive, negative, reviewed, improved) — las tarjetas de estadística de la página de chats del panel. | chats:read |
chat_feedback_submit | Califique una sesión de chat como Good (isPositive=true) o Needs Work (isPositive=false). | chats:write |
chat_session_get | Obtenga una sesión de chat con la transcripción completa (por mensaje token/model/latency/pageUrl), detalles del visitante, URL de la página iniciadora, categoría de confianza, feedback (severidad, análisis de IA, sesión de mejora vinculada) y etiquetas. | chats:read |
chat_session_search | Busque sesiones de chat de un chatbot por contenido de mensaje y/o email del visitante. | chats:read |
chat_session_set_category | Asigne o cambie la categoría de confianza de una sesión de chat (corrige la categorización de la IA; la confianza por categoría se recalcula cuando el chat fue revisado). | chats:write |
chat_sessions_list | Liste las sesiones de chat de un chatbot, del más nuevo al más antiguo, con los mismos filtros de la cola de revisión que la página de chats del panel. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Liste las categorías de confianza de un chatbot con puntuación de confianza por categoría, conteo de revisiones y frecuencia de email de revisión. | chats:read |
confidence_category_create | Cree una categoría de confianza para un chatbot. | chatbots:write |
confidence_category_delete | Elimine una categoría de confianza. | chatbots:write |
confidence_category_merge | Fusione una categoría de confianza en otra del mismo chatbot: todos los chats/revisiones se mueven al objetivo, la fuente se elimina y las puntuaciones se recalculan. | chatbots:write |
confidence_category_update | Renombre una categoría de confianza y/o establezca su frecuencia de email de revisión (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 solo para HOURLY). | chatbots:write |
confidence_status_get | Estado de confianza de un chatbot: puntuación, umbral de graduación, flag de fase de aprendizaje, comportamiento de fase de aprendizaje (CAUTIOUS|BALANCED|CONFIDENT) y prompt personalizado, conteos de revisión y puntuaciones de confianza por categoría. | analytics:read |
improvement_proposal_approve | Apruebe una propuesta de mejora PENDING y aplique el cambio al chatbot (agregar/actualizar instrucción principal, crear/actualizar FAQ o actualizar persona) — misma lógica y límites del plan que en el panel. | chatbots:write |
improvement_proposal_reject | Rechace una propuesta de mejora PENDING. | chatbots:write |
improvement_proposal_simulate | Simule cómo respondería el chatbot al mensaje problemático con una propuesta aplicada (original vs. | chatbots:write |
improvement_proposals_pending | Liste las propuestas de mejora pendientes de revisión (estado PENDING) en la empresa o para un chatbot. | chatbots:read |
improvement_session_complete | Marque una sesión de mejora como COMPLETED (el chat entonces cuenta como Improved en la cola de revisión). | chatbots:write |
improvement_session_create | Abra el Improvement Agent para un chat calificado como Needs Work. | chatbots:write |
improvement_session_get | Obtenga una sesión de mejora con el chat original (los mensajes tienen un índice 1-based usable como targetMessageIndex), la conversación del agente, todas las propuestas (con su última simulación) y simulaciones. | chatbots:read |
improvement_session_reset | Reinicie una sesión de mejora: elimina todos los mensajes del agente, simulaciones y propuestas PENDING/REJECTED (las aplicadas se mantienen) y comienza una conversación nueva. | chatbots:write |
improvement_session_send_message | Envíe un mensaje al Improvement Agent (describa qué falló en la respuesta del bot; opcionalmente targetMessageIndex = el índice 1-based del mensaje del bot en originalChat.messages). | chatbots:write |
improvement_sessions_list | Liste las sesiones de mejora (conversaciones del Improvement Agent iniciadas a partir de revisiones negativas) para un chatbot o toda la empresa, del más nuevo al más antiguo, con conteos de propuestas. | chatbots:read |
improvement_simulation_assess | Califique un resultado de simulación: isApproved=true cuando la respuesta simulada es buena (la propuesta puede aplicarse), false cuando necesita más trabajo (comentario 'almost' = casi correcta). | chatbots:write |
Chat en vivo
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Obtenga la disponibilidad de chat en vivo del usuario actual, los agentes actualmente disponibles para chat en vivo (heartbeat reciente, la misma señal que usa el widget) y si el plan de la empresa incluye chat en vivo. | chats:read |
live_chat_heartbeat | Refresque el heartbeat de presencia de chat en vivo del usuario actual (solo mientras esté marcado como disponible mediante live_chat_set_availability). | chats:write |
live_chat_message_send | Envíe un mensaje al visitante como el agente asignado. | chats:write |
live_chat_queue | Obtenga la cola de chat en vivo: sesiones esperando un agente, de la más antigua a la más nueva (FIFO). | chats:read |
live_chat_session_assign | Tome una sesión de chat en vivo WAITING de la cola: la asigna al usuario actual (propietario de la empresa para claves API) y notifica al visitante que el agente se ha unido. | chats:write |
live_chat_session_close | Finalice una sesión de chat en vivo como agente (cualquier miembro de la empresa que no sea VIEWER). | chats:write |
live_chat_session_get | Obtenga una sesión de chat en vivo con información del visitante, agente asignado, todos los mensajes y la conversación previa del bot (contexto de handoff). | chats:read |
live_chat_sessions_list | Liste sesiones de chat en vivo (del más nuevo al más antiguo; sesiones WAITING las más antiguas primero) con filtros opcionales por chatbot, estado y agente asignado. | chats:read |
live_chat_set_availability | Alterne el conmutador 'Available for Live Chat' del usuario actual para una empresa. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Asigne un lead a un miembro de la empresa o desasignelo (assignedToId: null). | leads:write |
lead_bulk_update_status | Establezca el estado de varios leads (máx. 100) a la vez. | leads:write |
lead_categories_list | Liste las categorías de leads de un chatbot con conteos de leads y los miembros del equipo notificados por categoría. | leads:read |
lead_category_assign_user | Añada un miembro de la empresa a la lista de notificación de una categoría de lead (o actualice sus flags de notificación). | leads:write |
lead_category_create | Cree una categoría de lead para un chatbot. | leads:write |
lead_category_delete | Elimine una categoría de lead. | leads:write |
lead_category_remove_user | Quite un miembro de la empresa de la lista de notificación de una categoría de lead. | leads:write |
lead_category_update | Actualice el nombre, descripción y/o color de una categoría de lead. | leads:write |
lead_create | Cree un lead manualmente (p. ej. | leads:write |
lead_delete | Elimine un lead permanentemente. | leads:write |
lead_field_config_get | Obtenga la configuración de captura de leads de un chatbot: campos (ids mapean a claves en lead.data), mensaje de confirmación, traducciones de campo/UI y ajustes de reconocimiento por IA. | leads:read |
lead_field_config_update | Actualice la configuración de captura de leads de un chatbot. | leads:write |
lead_get | Obtenga detalles completos de un lead incluyendo asignado, categoría y la transcripción del chat fuente (paginada con messageOffset/messageLimit, por defecto los primeros 20 mensajes). | leads:read |
lead_list | Liste los leads de un chatbot (del más nuevo al más antiguo) con filtros opcionales por estado, categoría, asignado y búsqueda de texto libre (nombre/email/empresa). | leads:read |
lead_stats | Obtenga estadísticas de leads para un chatbot: conteos por estado, leads de los últimos 7 días y la tasa de conversión (porcentaje). | leads:read |
lead_update | Actualice el estado, categoría, notas, datos capturados y/o asignado de un lead. | leads:write |
Formularios
| Tool | Description | Scope |
|---|---|---|
form_create | Cree un formulario de contacto para un chatbot (básicos, campos, diseño y ajustes anti-spam en una sola llamada). | forms:write |
form_delete | Elimine permanentemente un formulario de contacto y TODOS sus envíos (en cascada). | forms:write |
form_get | Obtenga un formulario de contacto en su totalidad: campos, traducciones, estilo, ajustes anti-spam, estado activo, conteo de envíos y la etiqueta de inserción (embedCode). | forms:read |
form_list | Liste los formularios de contacto de un chatbot con conteo de campos, conteo de envíos y códigos de inserción. | forms:read |
form_stats | Conteos de envíos de un formulario de contacto: total, pending, approved, spam y rejected. | forms:read |
form_submission_delete | Elimine permanentemente un envío de un formulario de contacto (p. ej. | forms:write |
form_submission_get | Obtenga un envío de formulario de contacto en su totalidad: datos de campos enviados, puntuación de spam y análisis de spam por IA, metadata IP/user agent/referrer y información de revisión. | forms:read |
form_submission_update_status | Revise un envío de formulario de contacto: establezca su estado a APPROVED, SPAM o REJECTED con una nota de revisión opcional. | forms:write |
form_submissions_list | Liste los envíos de un formulario de contacto, del más nuevo al más antiguo, opcionalmente filtrados por estado (PENDING, APPROVED, SPAM, REJECTED) y fecha de creación. | forms:read |
form_update | Actualice un formulario de contacto: nombre, descripción, estado activo (isActive controla si el embed se renderiza), campos (reemplazo completo), diseño (colores, texto del botón, mensaje de éxito) y ajustes anti-spam (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Reemplace las traducciones de campo y/o UI de un formulario de contacto. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Liste el registro de actividad de email procesado de una conexión de buzón (del más nuevo al más antiguo): remitente, asunto, categoría asignada, resultado (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) y outcomeDetail. | email:read |
email_categories_list | Liste las categorías de email de una conexión de buzón (ordenadas por sortOrder). | email:read |
email_category_create | Cree una categoría de email para una conexión de buzón (máx. 20 por conexión). | email:write |
email_category_delete | Elimine una categoría de email. | email:write |
email_category_update | Actualice una categoría de email (parcial: solo cambian los campos dados). | email:write |
email_connection_disconnect | Desconecte un buzón de forma permanente. | email:write |
email_connection_get | Obtenga una conexión de buzón incl. | email:read |
email_connection_update | Actualice una conexión de buzón: pausar/reanudar la sincronización (paused true/false; solo alterna ACTIVE<->DISABLED, nunca sobrescribe TOKEN_EXPIRED/ERROR), active/desactive la redacción de borradores (draftingEnabled) y la categorización/organización (organizingEnabled), re-apunte el chatbot que lo potencia (chatbotId de la misma empresa) o establezca la firma de respuesta HTML (signatureHtml, máx. 20000 caracteres; cadena vacía la borra). | email:write |
email_connections_list | Liste las conexiones de buzón del Email Assistant de la empresa (dirección, estado ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, última sincronización, último error, conmutadores drafting/organizing, chatbot que lo potencia, draftReadyCategoryCount = categorías que pueden generar borradores, baseRuleCount = reglas a nivel de chatbot "Chat + Email" aplicadas a cada borrador) junto con los límites del plan (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Elimine un contacto de email aprendido (olvide el perfil del remitente, p. ej. | email:write |
email_contact_get | Obtenga un contacto de email aprendido con todos los hechos aprendidos, notas internas, relación, configuración de tratamiento formal/informal y estadísticas de email. | email:read |
email_contact_update | Actualice un contacto de email aprendido. | email:write |
email_contacts_list | Liste los contactos de email aprendidos de la empresa (email más reciente primero) con relación, tratamiento formal/informal (formalAddress: true = formal 'Sie', false = informal 'Du', null = automático), conteo de hechos y vista previa de notas. | email:read |
email_folder_create | Cree una carpeta de correo bajo la bandeja de entrada (devuelve la existente si el nombre está tomado) para usarla como objetivo de movimiento de categoría. | email:write |
email_folders_list | Liste las carpetas a las que una categoría de email puede mover el correo, en vivo desde el buzón: subcarpetas de la bandeja, carpetas top-level personalizadas, archive, junk y trash (id 'deleteditems'). | email:read |
email_general_rules_list | Liste las reglas a nivel de chatbot que se aplican a cada borrador de respuesta de un buzón: instrucciones principales activas con channel BOTH ("Chat + Email"), además de las legacy solo-email que todavía no se migraron a una categoría. | email:read |
Analíticas
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Volumen de chats (sesiones iniciadas) a lo largo del tiempo para gráficos y tendencias: periodo week/month/quarter/year, granularidad hour/day/week/month, opcionalmente para un chatbot. | analytics:read |
analytics_chatbot_stats | Rendimiento por chatbot de una empresa en una sola llamada (la tabla de rendimiento de chatbots del panel): id, nombre, slug, isActive, sesiones, mensajes, FAQs y leads por chatbot, ordenados por sesiones. | analytics:read |
analytics_forms | Estadísticas de envíos de formularios de contacto para una empresa o un chatbot (widget de analíticas del panel): envíos por estado (pending/approved/rejected/spam), número de formularios, total, tasa de spam en porcentaje y la serie de envíos por día de los últimos 7 días. | analytics:read |
analytics_leads | Embudo de leads para una empresa o un chatbot (widget de analíticas del panel): leads por estado (new/contacted/qualified/converted/lost), total, tasa de conversión en porcentaje y la serie de leads por día de los últimos 7 días. | analytics:read |
analytics_overview | Visión general de analíticas para una empresa o un chatbot: chats, mensajes, tasa de satisfacción y preguntas principales para un periodo rodante (day/week/month/year), además del widget de overview del panel (total chatbots/published FAQs/leads, sesiones hoy/esta semana/este mes, leads hoy/esta semana, envíos de formularios total/hoy/pending). | analytics:read |
dashboard_activity | Qué requiere atención actualmente (la vista principal del panel): por empresa, los chatbots con nuevos leads hoy, sugerencias de FAQ pendientes, envíos de formularios pendientes, chats en vivo en espera/activos o una fase de aprendizaje en curso. | any |
Ejemplos de flujos de trabajo
Añadir una instrucción principal
Pregúntele 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 explica 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 del cliente para mi chatbot"
El asistente usará analytics_overview y analytics_chat_volume para compilar un informe exhaustivo.
Importar un sitio web
"Escanee https://example.com, importe las páginas de producto y precios en mi 'Support Bot' y avíseme cuando el rastreo termine"
El asistente llamará a crawler_preview_scan, seleccionará las páginas relevantes, iniciará la importación con crawler_start y sondeará crawler_job_get hasta que el trabajo haya finalizado.
Revisar leads y envíos de formularios
"Muéstrame los nuevos leads de esta semana, asigne los cualificados a Anna y apruebe los envíos de formularios de contacto pendientes"
El asistente combina lead_list, lead_assign, form_submissions_list y form_submission_update_status.
Hacerse cargo de un chat en vivo
"Póngame disponible para chat en vivo y tome la conversación en espera más antigua"
El asistente usa live_chat_set_availability, live_chat_queue y live_chat_session_assign; las respuestas pasan por live_chat_message_send.
Seguridad
- Las claves API están limitadas a su empresa y a los permisos que seleccione al crearlas (vea la columna Scope arriba)
- Las claves se ejecutan con los permisos del propietario de la empresa; los límites del plan y las puertas de funciones aplican exactamente como en el panel
- Las claves pueden revocarse en cualquier momento desde el panel
- El acceso a la API está disponible en planes de pago — vea nuestra página de Precios
Resolución de problemas
Conexión fallida
- Verifique que su clave API es correcta
- Compruebe que la clave no haya sido revocada
- Asegúrese de que su plan incluya acceso a la API
- Reinicie su cliente MCP
Herramienta no encontrada
Reinicie su cliente MCP después de cambiar la configuración para que recargue las herramientas disponibles. Los nombres de las herramientas están en minúsculas con guiones bajos (p. ej., faq_list).
¿Necesita ayuda? Contacte con nuestro equipo de soporte →