Chatway

npx add-mcp 'https://mcp.chatway.app/mcp'

Resumen de MCP

El servidor MCP de Chatway permite que un asistente de IA — Claude, ChatGPT, Cursor, Codex, Grok, Muse, o cualquier otro que hable el Model Context Protocol — trabaje dentro de tu espacio de trabajo de Chatway usando lenguaje natural.

Conecta Chatway a un asistente de IA

1. Copia la URL del servidor MCP:

https://mcp.chatway.app/mcp

2. Añádela como servidor MCP remoto en Claude, ChatGPT, Cursor, Codex, u otro cliente MCP.
3. Inicia sesión en Chatway y elige los widgets, canales y permisos a los que el asistente puede acceder.

Eso es todo — no hay clave API que pegar. Los pasos específicos por cliente están en Conectar clientes.

Prueba tu conexión preguntando a tu asistente:

Lista mis 5 conversaciones más recientes de Chatway.

¿MCP, webhooks o la API REST?

Chatway ofrece tres formas de conectar un sistema externo, y resuelven problemas diferentes.

	MCP	Webhooks	API REST
Dirección	Tu asistente → Chatway	Chatway → tu servidor	Tu código → Chatway
Qué lo inicia	Tú le pides a tu asistente	Un visitante hace algo	Tu código decide
Qué decide el resultado	El modelo	Tu código	Tu código
¿Escribes código?	No	Sí	Sí
Autenticación	OAuth	Secreto firmado	X-API-KEY
Configuración en	Tu cliente MCP	Configuración → Herramientas de desarrollo → Webhooks	Configuración → Herramientas de desarrollo → Claves API

Elige MCP cuando una persona quiera trabajar a través de un asistente bajo demanda — clasificando una cola, resumiendo un hilo, redactando una respuesta. No hay nada que construir, y el modelo decide qué herramientas llamar, que es exactamente por lo que se adapta a trabajo abierto y no a reglas fijas.

Elige webhooks cuando algo en Chatway deba activar tu sistema en tiempo real, normalmente para que un agente pueda responder a los visitantes automáticamente en el momento en que escriben.

Elige la API REST cuando quieras un comportamiento exacto y repetible, sin modelo en el bucle: sincronizando conversaciones en tu almacén de datos, aprovisionando contactos desde tu CRM, scripts de back-office, informes programados, o tu propio panel de control. Si una llamada incorrecta fuera costosa, o la misma entrada debe producir siempre el mismo resultado, usa la API REST en lugar de pedirle a un asistente que lo haga.

Se combinan bien. Una configuración común usa webhooks para notificar a un agente, la API REST para que ese agente responda de forma determinista, y MCP para que el equipo de soporte pueda seguir haciendo preguntas en lenguaje natural sobre la misma bandeja de entrada. Consulta la Referencia de API en la barra lateral para los endpoints, y Inicio rápido para el bucle de recibir-un-mensaje-y-responder.

Qué te ofrece MCP

Una vez conectado, tu asistente puede trabajar en tu bandeja de entrada de forma conversacional:

"¿Cuántas conversaciones siguen sin resolver en el widget de marketing?"

"Resume la última conversación con john@example.com, y luego responde pidiendo su número de pedido."

"Etiqueta cada conversación de hoy que mencione reembolsos."

Lo hace llamando a herramientas que autorizaste explícitamente. Nunca obtiene tu contraseña, y nunca pegas una clave API en él.

El endpoint es un servidor MCP HTTP transmisible y acepta solicitudes POST. Es independiente de la API REST: la API REST se autentica con un encabezado X-API-KEY, MCP con OAuth.

Autenticación

Los clientes MCP usan OAuth 2.1 con PKCE y solicitan el alcance mcp:use. Chatway admite registro dinámico de clientes, por lo que tu cliente maneja todo el intercambio y nunca creas un ID de cliente o secreto.

1. Tu cliente descubre el servidor de autorización de Chatway desde el endpoint MCP.
2. Se abre un navegador e inicias sesión en Chatway.
3. Nombres la conexión, para que puedas reconocerla más tarde.
4. Eliges qué widgets y canales puede acceder el asistente.
5. Eliges qué permisos otorgar, y como qué agente se envían las respuestas.
6. Chatway emite un token de acceso limitado exactamente a esas elecciones y te devuelve a tu cliente.

Cada conexión pertenece a tu espacio de trabajo de equipo, no a un miembro individual. Propietarios y administradores gestionan esa conexión en IA → IA externa. Reautorizar el mismo cliente asistente (por ejemplo Claude o Cursor) actualiza la conexión del equipo en lugar de crear una segunda.

Qué pueden hacer los asistentes

Hay veintiuna herramientas disponibles. Cada una requiere un permiso correspondiente, por lo que un asistente solo ve las herramientas que realmente concediste.

Grupo	Herramientas
Leer conversaciones	list-conversations, get-conversation, list-conversation-messages, search-conversations
Leer personas	get-visitor, search-contacts
Leer configuración	search-knowledge-base, view-tags, view-custom-fields, list-agents
Responder y clasificar	send-message, resolve-conversation, unresolve-conversation, assign-conversation
Anotar	add-note, add-tag, remove-tag
Datos personalizados	add-custom-data, update-custom-data, remove-custom-data
Escalar	handoff-to-human

handoff-to-human usa el mismo comportamiento de traspaso que el agente de IA integrado de Chatway, por lo que tu equipo recibe las notificaciones y el estado de la bandeja de entrada que ya esperan.

Para los parámetros de cada herramienta, forma de retorno y límites, consulta la Referencia de herramientas.

Alcance del acceso

Una conexión solo puede alcanzar los widgets y canales que seleccionaste. No ve nada de tus otros widgets, y nunca puede acceder a datos de otro equipo. Ambos se aplican en cada solicitud, independientemente de los permisos que concediste.

Los permisos también respetan tu rol en Chatway. Solo propietarios y administradores pueden ejecutar el flujo OAuth de MCP para conectar o reconectar un asistente y abrir IA → IA externa en Configuración. Miembros no tienen acceso a ese menú. Los permisos de escritura en una conexión solo pueden ser otorgados por un propietario o administrador.

Seguridad en acciones masivas y destructivas

Algunas acciones piden confirmación antes de que Chatway las ejecute. En lugar de actuar directamente, el asistente tiene que plantearte la pregunta primero, junto con cuánto va a afectar:

Esta acción resolverá 100 conversaciones. ¿Estás seguro?

Confirma y continúa. Tu aprobación dura 5 minutos y está vinculada a esa acción exacta, por lo que un asistente no puede reutilizarla para nada más.

Se requiere confirmación para resolver, desresolver o asignar más de una conversación a la vez, y para eliminar una etiqueta o eliminar datos personalizados.

Límites de velocidad

Las solicitudes MCP están limitadas a 120 solicitudes por minuto por conexión. Cada conexión tiene su propio presupuesto, por lo que un asistente ocupado no puede ralentizar tus otras conexiones. Por encima del límite, el servidor devuelve 429 y el asistente debe reintentar después de una breve pausa.

Responder en tiempo real con webhooks

MCP es bajo demanda: el asistente actúa cuando se lo pides. Si quieres que tu agente de IA responda a los visitantes automáticamente tan pronto como envíen un mensaje, usa los webhooks de Chatway junto con la API REST.

Visitor → Chatway → webhook → your AI agent → Chatway API → visitor

Chatway envía un evento firmado a tu endpoint, tu agente decide qué decir, y responde a través de la API REST. Junto con la respuesta, tu agente puede registrar detalles opcionales de confianza y modelo, lo que es útil para rastrear qué tan bien está funcionando antes de dejar que maneje todo.

También puedes conectar el mismo agente a través de MCP para acceso bajo demanda a tu espacio de trabajo de Chatway — clasificando la cola, resumiendo hilos, o tomando acciones en lenguaje natural. MCP es opcional para el bucle en tiempo real anterior; los webhooks y la API REST son suficientes por sí solos.

Hay trece eventos disponibles, incluidos los que la mayoría de los agentes necesitan:

Evento	Se activa cuando
conversation.created	Un nuevo chat ha comenzado
message.received	Un visitante envió un nuevo mensaje
conversation.resolved	Una conversación fue resuelta
agent.assigned	Un agente fue asignado a una conversación
contact.form.submitted	Un visitante envió un formulario de contacto o fuera de línea

Tu agente puede entonces usar la API REST para responder, resolver, desresolver, destacar, asignar, anotar, etiquetar, actualizar datos personalizados, o activar un traspaso humano — las mismas acciones disponibles a través de MCP.

Configura esto en Configuración → Herramientas de desarrollo → Webhooks, y consulta Documentación de webhooks → Resumen en la barra lateral para la lista completa de eventos, formas de payload, verificación de firma y reintentos. Inicio rápido recorre el bucle de recibir-un-mensaje-y-responder de principio a fin.

Siguientes pasos

• Conectar clientes — configura Claude, ChatGPT, Codex, Cursor, Muse y el resto.
• Referencia de herramientas — cada herramienta, sus parámetros y lo que devuelve.
• Permisos y acceso — qué desbloquea cada permiso.
• Gestionar conexiones — revisa, edita y revoca el acceso.

{"<?php $__contextArgs = [];\nif (context()->has($__contextArgs[0])) :\nif (isset($value)) { $__contextPrevious[] = $value; }\n$value = context()->get($__contextArgs[0]); ?>":"https://schema.org","@type":"TechArticle","headline":"Overview","description":"The Chatway MCP server lets an AI assistant — Claude, ChatGPT, Cursor, Codex, Grok, Muse, or anything else that speaks the [Model Context Protocol](https://mode…","url":"https://developers.chatway.app/mcp/guides.mcp_overview","image":"https://chatway.app/wp-content/themes/chatway-theme/assets/images/preview/chatway-v2-preview.webp","author":{"@type":"Organization","name":"Chatway"},"publisher":{"@type":"Organization","name":"Chatway","logo":{"@type":"ImageObject","url":"https://chatway.app/wp-content/themes/chatway-theme/assets/images/preview/chatway-v2-preview.webp"}}}