Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Chatwoot con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Chatwoot, la bandeja de soporte omnicanal, en la nube o autoalojada: conversaciones y mensajes de WhatsApp, e-mail, chat web y canales sociales, contactos, etiquetas, agentes, equipos, respuestas predefinidas e informes de soporte (primera respuesta, tiempos de resolución y de respuesta). Las respuestas, notas privadas y nuevas conversaciones están incluidas, pero desactivadas al instalar.
Prueba a pedir
Prompts de ejemplo para Chatwoot
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Chatwoot, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Chatwoot + ChatGPT
Chatwoot, la bandeja de soporte omnicanal, en la nube o autoalojada: conversaciones y mensajes de WhatsApp, e-mail, chat web y canales sociales, contactos, etiquetas, agentes, equipos, respuestas predefinidas e informes de soporte (primera respuesta, tiempos de resolución y de respuesta). Las respuestas, notas privadas y nuevas conversaciones están incluidas, pero desactivadas al instalar.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
CHATWOOT_URL, CHATWOOT_API_TOKEN, CHATWOOT_ACCOUNT_ID
Paso 1 — Obtener credenciales
La configuración lleva unos 2 minutos. Necesitas una cuenta de Chatwoot, en Chatwoot Cloud o autoalojada, y el access token del usuario con el que debe trabajar la IA.
- Inicia sesión en Chatwoot con ese usuario. Los agentes solo ven las conversaciones de las bandejas de las que son miembros y no pueden leer informes, así que para tener la visión completa usa un administrador.
- Haz clic en tu avatar, después en Profile Settings, y copia el Access Token del final de la página en
CHATWOOT_API_TOKEN. No caduca; puedes restablecerlo en la misma página. - Pon en
CHATWOOT_URLla dirección con la que abres Chatwoot:https://app.chatwoot.comen Chatwoot Cloud, o tu propio dominio, por ejemplohttps://chat.example.com, si lo alojas tú. Sin ruta, sin/app, sin/api. - Pon en
CHATWOOT_ACCOUNT_IDel número que aparece después de/app/accounts/en la barra de direcciones:https://app.chatwoot.com/app/accounts/3/dashboardsignifica 3. - Instala el conector y ejecuta
chatwoot_get_profile: muestra el usuario detrás del token, su rol y todas las cuentas a las que llega el token, con su id.
Token de cuenta, no Platform API: el token de una Platform App de un super admin (/platform/api) no sirve aquí. El conector usa la Application API de Chatwoot de una cuenta.
Autoalojado detrás de nginx: el token viaja en la cabecera api_access_token, y nginx descarta las cabeceras con guion bajo si no se configura underscores_in_headers on;. Se nota como un 401 en cada llamada aunque el token sea correcto. Un Chatwoot autoalojado que solo vive en una red privada no es accesible desde AnythingMCP Cloud; en ese caso usa un AnythingMCP autoalojado dentro de esa red.
Qué lee: la cuenta y el usuario detrás del token; tus bandejas (WhatsApp, e-mail, widget web, API, Instagram, Telegram y más) con sus miembros; agentes y administradores con su disponibilidad; equipos y sus miembros; etiquetas, respuestas predefinidas (canned responses) y definiciones de atributos personalizados; conversaciones con estado, prioridad, bandeja, etiquetas, contacto, agente asignado y equipo, como lista, como recuento o con filtros como creadas después de una fecha y asignadas a un agente; los mensajes de una conversación, incluidas notas privadas y adjuntos; contactos por nombre, e-mail, teléfono o identificador, con todas sus conversaciones en cualquier bandeja; y los informes de soporte: totales de un periodo junto al periodo anterior, una métrica a lo largo del tiempo, agentes, bandejas o equipos comparados y lo que está abierto y sin atender ahora mismo. Los secretos de canal de las bandejas y el access token del propio usuario se eliminan de las respuestas.
Horas y cifras: las horas de conversaciones y mensajes y los periodos de los informes son marcas de tiempo Unix en segundos (UTC), y la IA las convierte antes de darte una hora. La primera respuesta, el tiempo de resolución y el tiempo de respuesta de los informes están en segundos.
Pregunta antes de cada cambio: chatwoot_set_conversation_labels. Chatwoot sustituye la lista completa de etiquetas de una conversación, así que la IA lee primero las etiquetas actuales y las envía junto con la nueva (o sin la que hay que quitar). Las etiquetas tienen que existir ya en la cuenta. La IA te muestra la conversación y la nueva lista y espera tu sí.
Desactivadas al instalar: chatwoot_send_message (una respuesta, o una nota privada que solo ven los agentes) y chatwoot_create_conversation. Una respuesta o un primer mensaje llega al cliente al instante por WhatsApp, e-mail o chat, así que un administrador las activa a propósito. Incluso entonces la IA te muestra el texto y el destinatario y espera tu sí. En las bandejas de WhatsApp Cloud API, el texto libre solo llega a un contacto dentro de las 24 horas siguientes a su último mensaje; fuera de esa ventana Chatwoot necesita una plantilla aprobada, que este conector no envía.
Límites: las conversaciones llegan de 25 en 25 por página, los contactos de 15 en 15 y los mensajes de 20 en 20, así que la IA va pasando páginas; para una simple cifra cuenta en lugar de listar. Los informes y las estadísticas en vivo necesitan el token de un administrador.
Errores comunes: 401 significa un token incorrecto o restablecido, o nginx descartando la cabecera. Un 404 en todas las llamadas suele indicar un CHATWOOT_URL o un CHATWOOT_ACCOUNT_ID incorrecto; un 404 en una sola conversación indica un id que este usuario no puede ver. Los informes responden 401 o 403 a los agentes que no son administradores.
El conector no usa la Platform API, no envía plantillas de WhatsApp, no resuelve, reasigna ni borra conversaciones existentes y no edita ni borra contactos.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en ChatGPT
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa + y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
Chatwoot. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Tool | What it does |
|---|---|
chatwoot_get_profile | Get the user behind the access token: id, name, email, role, availability and every account the token can reach (accounts[].id and name) |
chatwoot_get_account | Get the Chatwoot account configured in CHATWOOT_ACCOUNT_ID: name, locale, domain, support e-mail, status, enabled features and custom… |
chatwoot_list_inboxes | List the inboxes (channels) of the account: id, name, channel type (WhatsApp, API, web widget, e-mail, Instagram, Telegram...), phone… |
chatwoot_list_inbox_agents | List the agents who are members of one inbox (id, name, email, role, availability) |
chatwoot_list_agents | List the agents and administrators of the account: id, name, email, role (agent or administrator), availability (online, busy, offline) and… |
chatwoot_list_teams | List the teams of the account (id, name, description, whether auto-assignment is on) |
chatwoot_list_team_members | List the agents in one team (id, name, email, role, availability) |
chatwoot_list_labels | List the labels defined in the account: id, title, description and color |
chatwoot_list_canned_responses | List the canned responses (saved replies) of the account: id, short code and content |
chatwoot_list_custom_attributes | List the custom attribute definitions of the account for conversations (attribute_model 0) or contacts (1): key, display name, type and… |
chatwoot_list_conversations | List conversations, 25 per page, newest activity first, with counts (mine, assigned, unassigned, all) |
chatwoot_count_conversations | Count conversations without listing them: mine_count, assigned_count, unassigned_count and all_count for a status, inbox, team or label |
chatwoot_filter_conversations | Filter conversations with Chatwoot's advanced filter, 25 per page: a list of conditions on status, assignee_id, inbox_id, team_id… |
chatwoot_get_conversation | Get one conversation by its id (the number shown in the Chatwoot URL): status, priority, inbox, labels, contact, assignee, team, custom and… |
chatwoot_list_messages | List the messages of a conversation, oldest first: the latest 20 by default, or 20 older than before. message_type 0 = incoming (from the… |
chatwoot_list_contacts | List contacts with an e-mail, phone number or identifier, 15 per page: id, name, e-mail, phone, identifier, custom and additional… |
chatwoot_search_contacts | Search contacts by name, e-mail, phone number or identifier (case-insensitive, partial), 15 per page. meta.has_more tells whether another… |
chatwoot_get_contact | Get one contact: name, e-mail, phone, identifier, custom and additional attributes, last activity and the inboxes the contact is reachable… |
chatwoot_list_contact_conversations | List the conversations of one contact across all inboxes, with status, labels, assignee and last message |
chatwoot_get_report_summary | Get the totals of a period for the account, an agent, an inbox, a label or a team: conversations, incoming and outgoing messages… |
chatwoot_get_report_timeseries | Get one metric over time as [{value, timestamp}] buckets, for the account, an agent, an inbox, a label or a team, grouped by hour, day… |
chatwoot_get_summary_by | Compare agents, inboxes or teams over a period, one row each: conversations, resolved and handled conversations, average resolution, first… |
chatwoot_get_live_conversation_stats | Right now: how many conversations are open, unattended (no reply yet) and unassigned for the whole account (type account), or open and… |
chatwoot_send_message | Send a reply in an existing conversation, or add a private note that only agents see (private true) |
chatwoot_set_conversation_labels | Set the labels of a conversation |
chatwoot_create_conversation | Start a new conversation with an existing contact in an inbox, optionally with a first message, status, assignee and team |
Ejemplos de prompts
- "¿Cuántas conversaciones abiertas están sin asignar ahora mismo, y qué agentes tienen chats sin atender?"
- "Lee la conversación 1284 y resúmeme qué quiere el cliente y qué le hemos prometido ya."
- "Busca el contacto [email protected] y lista todas sus conversaciones por WhatsApp y e-mail."
- "Compara a nuestros agentes en los últimos 30 días: conversaciones atendidas, tiempo de primera respuesta y tiempo de resolución."
- "Añade la etiqueta reembolso a la conversación 1284 sin quitar las demás. Enséñame antes la nueva lista."
FAQ
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Siguientes pasos
¿Te ha sido útil esta guía?
