--- title: "Claude Code + OmniChannels.ai: desarrolle y pruebe la mensajería desde su terminal" description: "Conecte Claude Code al servidor MCP de OmniChannels.ai para enviar pruebas y ver entregas, y use nuestra especificación OpenAPI para integrar WhatsApp y SMS." canonical: "https://omnichannels.ai/es/integrations/claude-code/" language: "es" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Claude Code + OmniChannels.ai: desarrolle y pruebe la mensajería desde su terminal Canonical: https://omnichannels.ai/es/integrations/claude-code/ Language: es Publisher: OmniChannels.ai by BroadNet Technologies **En resumen:** Claude Code se conecta a OmniChannels.ai con un solo comando: claude mcp add --transport http apuntando a https://mcp.broadnet.me/mcp con un encabezado Authorization: Bearer. Así puede enviar mensajes de prueba, listar plantillas de WhatsApp y leer informes de entrega mientras escribe su código de integración a partir de nuestra especificación OpenAPI 3.1. Los equipos comparten el servidor en .mcp.json, y las reglas de permisos controlan qué herramientas se ejecutan sin preguntar. Conexión por MCP · Conexión por API y webhooks ## Qué puede hacer ### Escriba código a partir de las plantillas reales Claude Code lee sus plantillas de WhatsApp aprobadas mediante MCP y escribe una función con exactamente las variables que necesita cada una. > Pruebe a pedir: "Usa las herramientas de omnichannels para listar mis plantillas de WhatsApp aprobadas y luego escribe una función en TypeScript que envíe order_update con los campos que necesita." ### Cree un manejador de webhooks Indique a Claude Code la guía de webhooks y escribirá un endpoint que guarde los estados de entrega y los mensajes entrantes, tolerando campos que varían según el canal. > Pruebe a pedir: "Escribe un manejador de webhooks en Express que registre los estados SUBMITTED, SENT, DELIVERED, READ, FAILED y REJECTED por ID de mensaje y que registre en el log los campos desconocidos en lugar de fallar." ### Genere un cliente tipado a partir de la especificación Con la especificación OpenAPI guardada en su repositorio, Claude Code usa las rutas y los campos exactos en lugar de adivinarlos. > Pruebe a pedir: "Usando docs/omnichannels-openapi.yaml, escribe un módulo de Python que envíe un SMS con POST /sms/sendSms y enumera cada campo que usaste con su tipo según la especificación." ### Pruebe de principio a fin con su propio número Claude Code envía un mensaje de prueba cuando usted aprueba la llamada a la herramienta y luego revisa el informe de entrega para confirmar que su flujo de código funciona. > Pruebe a pedir: "Envía un SMS de prueba desde OmniDemo a mi número 447700900123 y luego revisa su informe de entrega." ### Depure envíos fallidos Con las herramientas de lectura, Claude Code compara los informes de entrega con sus logs y rastrea un fallo hasta la solicitud que lo causó. > Pruebe a pedir: "Lee el informe de entrega de la campaña de ayer, resume los motivos de fallo y revisa nuestro código de reintentos frente a la guía de errores." ## Cómo se conecta Claude Code añade servidores MCP remotos con claude mcp add --transport http y un encabezado Authorization. Su shell expande el token desde una variable de entorno al ejecutar el comando; en un equipo, un .mcp.json con ámbito de proyecto permite que cada desarrollador aporte su propio token mediante ${BROADNET_TOKEN}, y Claude Code pide a cada persona que apruebe el servidor antes de usarlo. MCP sirve para actuar sobre su cuenta: enviar mensajes de prueba y leer plantillas e informes de entrega. Para escribir el código de integración, dé a Claude Code nuestra especificación OpenAPI 3.1 como referencia de endpoints y campos, además de la guía de webhooks, ya que los payloads de los webhooks no están en la especificación. Reglas de permisos como mcp__omnichannels__get_* permiten que las herramientas de lectura se ejecuten sin preguntar, mientras que las de envío siguen pidiendo confirmación. - Comando: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp - Configuración de equipo: suba .mcp.json con Bearer ${BROADNET_TOKEN}, nunca una clave - Las reglas de permisos nombran las herramientas como mcp__omnichannels__ - Especificación OpenAPI 3.1 en /developers/openapi.json con los campos exactos de cada solicitud - El SMS individual es JSON; los envíos masivos y la mayoría de los demás canales usan multipart/form-data ## Configuración 1. **Solicite acceso a la API:** Solicite acceso de prueba y reciba un token de API. Los envíos de prueba solo llegan a sus propios números verificados. 2. **Obtenga una clave temporal:** En el portal de administración abra Integrations y luego MCP Integration, elija Get temporary key y expórtela como BROADNET_TOKEN. (Guía: https://omnichannels.ai/developers/mcp/) 3. **Añada el servidor:** Ejecute claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp con el encabezado Authorization, o suba un .mcp.json de proyecto para su equipo, y compruébelo con /mcp. (Guía: https://omnichannels.ai/developers/mcp-claude-code/) 4. **Defina las reglas de permisos:** Permita, si lo desea, herramientas de lectura como mcp__omnichannels__get_*, mantenga todas las herramientas de envío con confirmación y deniegue las que el proyecto no necesita. (Guía: https://omnichannels.ai/developers/mcp-claude-code/) 5. **Añada la especificación OpenAPI:** Descargue openapi.yaml en su repositorio e indique a Claude Code que la use para las rutas de los endpoints, los campos y los enums. (Guía: https://omnichannels.ai/developers/openapi/) 6. **Pruebe con su propio número:** Pida a Claude Code que envíe un mensaje de prueba a su número verificado y luego consulte el informe de entrega. ## Flujo de ejemplo Claude Code (Escribe su integración y llama a herramientas cuando usted se lo pide) → MCP y API de OmniChannels.ai (Herramientas MCP para pruebas; su código llama a la REST API) → Su teléfono de prueba (SMS o WhatsApp de prueba a su número verificado) → Su manejador de webhooks (Recibe estados de entrega y mensajes entrantes) ## Preguntas ### ¿Existe un plugin oficial de OmniChannels.ai para Claude Code? No. Claude Code se conecta mediante su soporte estándar para servidores MCP remotos, usando nuestro endpoint público y su token de API, y lee nuestra especificación OpenAPI pública como cualquier otro archivo de su repositorio. ### ¿Cómo comparto el servidor con mi equipo sin compartir una clave? Suba un .mcp.json con ámbito de proyecto cuyo encabezado Authorization use ${BROADNET_TOKEN}. Cada desarrollador define esa variable en su propia shell, y Claude Code le pide que apruebe el servidor del proyecto antes de usarlo. ### ¿Puede Claude Code enviar mensajes sin preguntar? Por defecto, Claude Code pregunta antes de usar una herramienta MCP. Manténgalo así para las herramientas de envío, ya que cada envío es un mensaje real que se factura. Permita solo herramientas de lectura en sus reglas de permisos, y revise antes los nombres de las herramientas en /mcp, porque dependen de la versión del servidor y de su cuenta. ### ¿Debo usar MCP o la REST API en mi producto? Use MCP para que Claude Code pueda probar e inspeccionar su cuenta mientras desarrolla. El código que despliegue debe llamar directamente a la REST API con un token de su gestor de secretos, usando la especificación OpenAPI para los campos exactos. ## Guías para desarrolladores - https://omnichannels.ai/developers/mcp-claude-code/ - https://omnichannels.ai/developers/openapi/ - https://omnichannels.ai/developers/webhooks/ - https://omnichannels.ai/developers/mcp/ ## Documentación del fabricante - [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp) - [Claude Code permissions](https://code.claude.com/docs/en/permissions) ## Integraciones relacionadas - https://omnichannels.ai/es/integrations/claude/ - https://omnichannels.ai/es/integrations/cursor/ - https://omnichannels.ai/es/integrations/vs-code/ - https://omnichannels.ai/es/integrations/langchain/ Claude Code es una marca de su titular. OmniChannels.ai no está afiliado a Claude Code ni cuenta con su respaldo; esta página describe una conexión creada con las funciones MCP, HTTP o webhook propias de Claude Code. Actualizado: 2026-10-10