Telerivet MCP

npx add-mcp 'https://api.telerivet.com/mcp'

Telerivet proporciona un servidor de Model Context Protocol (MCP) que permite a los agentes de IA y a las herramientas basadas en LLM, como Claude y ChatGPT, interactuar con la API REST de Telerivet mediante la interfaz estándar de MCP.

El servidor MCP de Telerivet permite a los agentes de IA realizar una amplia variedad de acciones en Telerivet, como enviar y programar mensajes, recuperar datos y estadísticas de uso, importar contactos y configurar proyectos, rutas y servicios automatizados.

El endpoint de MCP está disponible en:

https://api.telerivet.com/mcp

Los clientes MCP se conectan mediante el transporte HTTP Streamable, usando mensajes JSON-RPC 2.0 en solicitudes HTTP POST.

Configuración del cliente

El endpoint de MCP requiere autenticación mediante OAuth 2.0.

Los clientes MCP que admiten OAuth Client ID Metadata Documents (CIMD) pueden conectarse sin ninguna configuración manual: Telerivet los registra automáticamente la primera vez que un usuario los autoriza. Telerivet no admite Dynamic Client Registration.

Hay instrucciones de configuración disponibles para los siguientes clientes MCP:

• Claude (claude.ai y Claude Desktop)
• Claude Code
• ChatGPT
• Codex
• Antigravity CLI
• Hermes Agent

Para los clientes MCP que no admiten Client ID Metadata Documents, se debe configurar manualmente un OAuth Client. Para permitir el uso de otro cliente MCP que no admita CIMD, puedes añadir un nuevo OAuth Client en tu organización de Telerivet y configurar las URL de callback de OAuth que requiera el cliente MCP. (El servicio que proporciona el cliente MCP puede especificar las URL de callback de OAuth en su documentación). Cuando se configura manualmente un OAuth Client de esta manera, solo podrán acceder a él los usuarios de tu propia organización de Telerivet.

Autorizar un cliente MCP

Al conectar un cliente MCP, este te redirige a Telerivet para autorizar el acceso. En esta página, eliges:

• Permisos: los tipos de datos y acciones a los que puede acceder la aplicación (por ejemplo, Ver mensajes, Enviar mensajes o Editar servicios automatizados). Desmarca los permisos que no quieras conceder a la aplicación. La aplicación nunca podrá hacer más de lo que permite tu propia cuenta de usuario, y los métodos de API que requieran un permiso que no hayas concedido estarán ocultos para el cliente MCP.
• Organización: a cuál de tus organizaciones puede acceder la aplicación. Cada autorización corresponde a una sola organización; para usar la aplicación con otra organización, vuelve a conectarla.

Aprobar aplicaciones para tu organización. Un administrador de la organización debe aprobar cada cliente MCP (como Claude o ChatGPT) antes de que pueda usarse en una organización. Si eres administrador de la organización, la página de autorización te permite aprobar la aplicación para tu organización y elegir ¿Quién puede usar esta aplicación?: todos los usuarios de la organización, solo los administradores de la organización o solo los administradores de la organización y de los proyectos. Los demás usuarios verán un mensaje en el que se les pide que se pongan en contacto con un administrador de la organización para que apruebe la aplicación.

Revocar el acceso. Puedes revocar en cualquier momento el acceso de una aplicación a tu cuenta desde la sección Aplicaciones autorizadas de la configuración de Seguridad de la cuenta. Los administradores de la organización pueden revisar y revocar los tokens de acceso de todos los usuarios desde la página Tokens de acceso OAuth, o revocar por completo una aplicación desde la página Aplicaciones conectadas.

Controles de la organización

Los administradores de la organización pueden controlar qué puede hacer cada cliente MCP aprobado dentro de su organización en la página Aplicaciones conectadas (también enlazada desde la página de API para desarrolladores de la organización). Haz clic en una aplicación para ver o cambiar su configuración. Esta configuración se aplica al acceso de todos los usuarios a esa aplicación dentro de la organización, independientemente de los permisos que hayan concedido al conectarla.

Permiso requerido: qué usuarios de la organización pueden autorizar la aplicación (todos los usuarios, solo los administradores de la organización o solo los administradores de la organización y de los proyectos).

Acciones permitidas: para cada categoría de acciones, si la aplicación puede realizarlas por su cuenta, si un usuario debe aprobar cada acción o si no están permitidas:

Acción	Descripción	Opciones	Valor predeterminado
Leer datos	Consultar contactos, mensajes, estadísticas y otros datos del proyecto.	Permitido, No permitido	Permitido
Crear y actualizar datos	Crear y editar contactos, grupos, servicios, campañas en borrador, rutas y otros datos del proyecto.	Permitido, Requiere aprobación, No permitido	Permitido
Enviar mensajes y activar servicios	Enviar o programar mensajes y llamadas a contactos, activar servicios automatizados y ejecutar scripts.	Permitido, Requiere aprobación, No permitido	Requiere aprobación
Eliminar datos	Eliminar contactos, mensajes, servicios y otros datos del proyecto.	Permitido, Requiere aprobación, No permitido	Requiere aprobación
Realizar solicitudes web externas	Realizar solicitudes a sitios web externos y API de terceros desde los scripts que ejecuta esta aplicación.	Permitido, No permitido	Permitido

Cuando una categoría está configurada como No permitido, la herramienta MCP correspondiente (como send_api o delete_api) queda oculta para el cliente MCP y se rechaza cualquier solicitud de API de esa categoría. La herramienta run_script sigue la configuración más restrictiva entre las de envío, creación o actualización y eliminación de datos.

Algunas aplicaciones especifican sus propios valores predeterminados; por ejemplo, un agente autónomo que necesita enviar mensajes sin que haya un usuario presente. Cuando el valor predeterminado de una aplicación difiere del valor estándar, la página Aplicaciones conectadas indica el valor predeterminado de la aplicación junto a la configuración. La configuración de tu organización siempre tiene prioridad.

Permisos permitidos: los tipos de datos y acciones a los que puede acceder la aplicación en esta organización. Si desmarcas un permiso, se bloquean las acciones de API correspondientes para todos los usuarios de la aplicación en la organización, incluso si un usuario concedió ese permiso al conectarla.

Revocar el acceso: elimina la aplicación de las aplicaciones aprobadas de tu organización y revoca todos sus tokens de acceso existentes en la organización.

Las aplicaciones que pertenecen a tu propia organización (añadidas mediante Añadir OAuth Client) no necesitan aprobación, y sus acciones permitidas se configuran en la página de configuración de la propia aplicación.

Confirmación con intervención humana

Cuando una categoría de acciones está configurada como Requiere aprobación en la página Aplicaciones conectadas, el cliente MCP no puede realizar esas acciones hasta que un usuario apruebe explícitamente cada una. De forma predeterminada, esto se aplica al envío de mensajes y la activación de servicios, así como a la eliminación de datos.

Las acciones de la categoría de envío incluyen enviar o programar mensajes y llamadas, volver a enviar mensajes, activar servicios automatizados, crear tareas por lotes, simular mensajes entrantes, editar mensajes o campañas programados, activar un servicio automatizado o cambiar la configuración de un servicio activo, crear webhooks o cambiar sus URL, cambiar el número de teléfono o la configuración del proveedor de una ruta, cambiar la ruta predeterminada del proyecto y ejecutar scripts con la herramienta run_script. La categoría de eliminación incluye todos los métodos de eliminación, así como reducir el período de retención de mensajes de un proyecto.

Según el cliente MCP, puedes aprobar una acción de una de las siguientes maneras:

Solicitud de aprobación en el cliente MCP

Si el cliente MCP admite MCP elicitation (mediante la versión 2026-07-28 o posterior del protocolo MCP), te pedirá que apruebes la acción directamente y te mostrará una descripción en lenguaje sencillo de lo que hará y del proyecto al que afecta. Si la apruebas, la acción se realiza de inmediato. Si la rechazas, no se realiza y se indica al modelo de IA que no vuelva a intentarlo.

Borradores de mensajes

Si el cliente MCP admite la extensión MCP Apps, el modelo de IA puede usar la herramienta draft_message para mostrarte un borrador editable de un mensaje de texto, incluidos los destinatarios. Al hacer clic en Enviar, apruebas el envío de ese mensaje exacto a esos destinatarios.

Enlace de aprobación

Si el cliente MCP no admite ninguna de las opciones anteriores, o si la acción no se puede aprobar de esa manera, el modelo de IA recibe un enlace a una página Aprobar acción en la aplicación web de Telerivet y debe pedirte que la abras. Esta página muestra la aplicación, el proyecto, una descripción de la acción y todos los detalles de la solicitud. Después de hacer clic en Aprobar, vuelve al cliente MCP y pídele que lo intente de nuevo.

Para aprobar una acción, debes tener el permiso que requiere la propia acción (por ejemplo, permiso para enviar mensajes en el proyecto). Aprobar una acción no concede permisos adicionales a la aplicación.

Cómo funcionan las aprobaciones

• Cada aprobación se aplica a una solicitud exacta —el mismo método de API con los mismos parámetros— y solo se puede usar una vez. Si el modelo de IA cambia cualquier aspecto de la solicitud, debe volver a aprobarse.
• Las aprobaciones caducan al cabo de 1 hora.
• Las solicitudes de API realizadas por un script que hayas aprobado mediante run_script no requieren una aprobación aparte.
• Si la aplicación llama directamente a la API REST con su token de acceso (en lugar de hacerlo mediante MCP), las solicitudes que requieran aprobación fallarán con el código de error confirmation_required, y el mensaje de error incluirá un enlace de aprobación. Para que las aplicaciones que necesiten realizar estas acciones sin un usuario presente (como las integraciones del lado del servidor o los agentes autónomos) puedan hacerlo, un administrador de la organización debe configurar la categoría como Permitido.

Revisión de mensajes. Independientemente de lo anterior, si Revisión de mensajes está habilitada en la configuración de mensajería de un proyecto, los mensajes enviados mediante la API (incluido MCP) que superen los límites configurados quedan retenidos como mensajes pendientes hasta que un revisor los apruebe, igual que los mensajes enviados desde la aplicación web.

Herramientas

Actualmente, el servidor MCP ofrece las siguientes herramientas:

• list_api_methods – Muestra los métodos de API disponibles con su nombre, descripción y resumen de parámetros. Permite filtrar por categoría.
• get_method_schema – Devuelve el esquema completo de parámetros y las descripciones de los campos de respuesta de un método de API específico.
• read_api – Ejecuta un método de API de solo lectura para recuperar datos.
• modify_api – Ejecuta un método de API que crea o actualiza datos.
• delete_api – Ejecuta un método de API que elimina datos.
• send_api – Ejecuta un método de API que envía, programa o recibe mensajes, invoca servicios automatizados o realiza tareas por lotes.
• run_analysis_script – Ejecuta JavaScript de solo lectura en el entorno aislado de Cloud Script API de Telerivet para analizar datos del proyecto; resulta útil para realizar agregaciones, combinar distintos tipos de entidades o examinar muchos registros sin paginarlos todos a través del modelo. El acceso a la API es de solo lectura y las solicitudes HTTP salientes están deshabilitadas.
• run_script – Ejecuta JavaScript con acceso a Cloud Script API (lecturas, escrituras, envíos y solicitudes HTTP) para operaciones masivas que, de otro modo, requerirían muchas llamadas individuales a la API. Las solicitudes a la API realizadas por los scripts se comprueban con los ámbitos del token de OAuth, por lo que los scripts nunca pueden hacer más de lo que permite el token con el que se ejecutaron.
• get_web_app_urls – Devuelve información sobre las funciones de la aplicación web y los patrones de URL. Permite que los agentes de IA generen enlaces a funciones que no están disponibles directamente mediante la API. Sin una consulta, devuelve un índice compacto de todas las páginas; al buscar por palabras clave o rutas URL, devuelve todos los detalles de las páginas coincidentes.
• draft_message – Redacta un mensaje de texto sencillo para uno o varios números de teléfono (o un grupo de contactos) y solicita la aprobación del usuario antes de enviarlo (consulta Borradores de mensajes). Solo está disponible si el cliente MCP admite la extensión MCP Apps.
• get_route_options – Devuelve información sobre las opciones disponibles de rutas y canales de mensajería. Al filtrar por país, tipo de canal o caso de uso (o buscar un tipo de ruta específico), devuelve todos los detalles, incluida la disponibilidad geográfica, los requisitos de cumplimiento, el proceso de registro, las modalidades de facturación (gestionada internamente/por Telerivet frente a externa/BYOC), los plazos de configuración y los precios.
• skillbook_search / skillbook_get – Devuelve información sobre patrones de soluciones habituales, servicios, tipos de campañas, funciones de la plataforma y plantillas de mensajes que coinciden con una intención o un caso de uso.
• search_documentation / get_documentation – Busca y recupera entradas del corpus de documentación de Telerivet, incluidos artículos de ayuda de la Guía del usuario, páginas legales y de políticas, documentación de la API para desarrolladores y contenido de marketing y corporativo de www.telerivet.com.

Las herramientas y los métodos de API que expone el servidor MCP pueden cambiar con el tiempo.

Los enlaces siguientes muestran el JSON que devuelve el servidor MCP y pueden ayudar a comprender las herramientas y los métodos de API disponibles:

• Definiciones de herramientas
• Resultado de la herramienta list_api_methods
• Resultado de la herramienta get_method_schema para el método Project_queryContacts (sustituye el último componente de la URL para ver el esquema de otros métodos de API)
• Resultado de la herramienta get_documentation para la referencia de Cloud Script API (sustituye el último componente de la URL para ver otras entradas de documentación)

Los ámbitos concedidos a tu token de OAuth, junto con los controles de tu organización para la aplicación, determinan qué herramientas y métodos de API están disponibles. Los métodos que requieren un ámbito que tu token no tiene, o que tu organización no permite para la aplicación, se excluirán de la lista.