Modem

Modem conecta la IA con los comentarios de los clientes a través de Slack, soporte, correo electrónico, llamadas y rastreadores de incidencias para convertirlos en información consultable sobre la que puedes actuar.

Ver en modem.dev

Documentación

El servidor MCP de Modem permite que clientes compatibles con MCP trabajen con Modem desde fuera del panel de Modem. Úsalo cuando quieras que un asistente externo busque en tus comentarios de clientes, temas, personas y empresas, ejecute el Agente de Modem con tus herramientas conectadas o actualice tu espacio de trabajo de Modem directamente.

La forma más rápida de conectarse es mediante un plugin oficial de Modem para Claude, ChatGPT, Codex o Cursor. Para cualquier otro cliente, añade la URL del servidor tú mismo.

:::info Esta página trata sobre cómo conectar un cliente MCP externo a Modem. Para conectar servidores de herramientas MCP externos que use el Agente de Modem, consulta la Página de Servidores MCP Externos. :::

Instalar un Plugin

Modem publica un plugin oficial en cada uno de estos directorios. Un plugin se conecta a este mismo servidor e inicia sesión con OAuth, por lo que obtienes las mismas herramientas sin editar un archivo de configuración.

Cliente	Directorio	Instalación
Claude	Directorio de Conectores de Claude	Instalar en Claude
ChatGPT y Codex	Directorio de plugins de ChatGPT	Instalar en ChatGPT
Cursor	Marketplace de Cursor	Instalar en Cursor

Abre el listado

Abre el listado de Modem para tu cliente desde la tabla anterior.
Instala el plugin

Sigue el flujo de instalación del listado. En Cursor también puedes ejecutar /add-plugin modem.
Autoriza Modem

Inicia sesión y aprueba el acceso en la pantalla de consentimiento de Modem. Consulta Autorizar Modem.

El listado del directorio de plugins de ChatGPT cubre tanto ChatGPT como Codex. Para un cliente que no esté en la lista, o para configurar el servidor tú mismo, usa la URL del servidor y los pasos de configuración del cliente a continuación.

URL del Servidor

Usa esta URL en tu cliente MCP:

https://mcp.modem.dev/mcp

El servidor usa HTTP Streamable y OAuth. No necesitas crear ni pegar una clave de API.

Herramientas

El servidor expone siete tipos de herramientas: una que ejecuta el Agente de Modem completo, una que sirve habilidades para usar este servidor, una que lee tus datos directamente, una que lee la documentación de Modem, un conjunto que escribe en tu espacio de trabajo de Modem, un conjunto que gestiona automatizaciones y dos para comentarios: crear un canal de comentarios para tu aplicación y enviar comentarios sobre Modem.

Qué herramientas ve tu cliente depende de los alcances que apruebes durante la autorización. Consulta Seguridad y Acceso.

Para la lista completa de parámetros de cada herramienta, la forma de los resultados y ejemplos de invocación, consulta la Referencia de Herramientas MCP.

Ejecutar el agente

Las ejecuciones del agente son asíncronas. Iniciar una ejecución devuelve sus IDs de inmediato. La ejecución continúa en Modem, incluso si tu cliente MCP se desconecta.

Herramienta	Qué hace	Entradas
`modem_agent_invoke`	Inicia una nueva conversación con el agente y devuelve su `conversation_id` y `run_id`.	`prompt`, `idempotency_key`
`modem_agent_get_run`	Devuelve el estado actual y, una vez completada, la respuesta del agente.	`conversation_id`, `run_id`
`modem_agent_send_message`	Inicia un turno de seguimiento en una conversación MCP existente.	`conversation_id`, `prompt`, `idempotency_key`
`modem_agent_cancel_run`	Solicita la cancelación de una ejecución. Las acciones que el agente ya completó no se revierten.	`conversation_id`, `run_id`

Usa estas herramientas cuando la tarea requiera razonamiento, varios pasos o tus herramientas conectadas, como Linear, Slack o GitHub. Las ejecuciones del agente consumen créditos.

Cómo funciona una ejecución del agente

Inicia la ejecución

Llama a modem_agent_invoke con un prompt y un idempotency_key. Modem devuelve conversation_id, run_id y un estado working.
Comprueba el resultado

Llama a modem_agent_get_run con ambos IDs. Sigue comprobando hasta que el estado sea completed, failed o cancelled. Una ejecución completada incluye la respuesta en result.text.
Continúa la conversación

Llama a modem_agent_send_message con el mismo conversation_id, un nuevo prompt y un nuevo idempotency_key. Espera a que la ejecución actual termine antes de iniciar el seguimiento.
Cancela si es necesario

Llama a modem_agent_cancel_run con los IDs de conversación y ejecución. La cancelación detiene el trabajo restante pero no deshace las acciones que el agente ya completó.

Guarda los IDs de conversación y ejecución después de cada llamada de inicio. Puedes usarlos para comprobar la ejecución desde una nueva conexión si el cliente original sale.

Claves de idempotencia

Asigna a cada turno lógico una idempotency_key estable y única.

Reintenta el mismo turno con la misma clave y exactamente el mismo prompt. Modem devuelve la ejecución existente en lugar de iniciar otra.
No reutilices una clave con un prompt modificado. Modem la rechaza como conflicto.
Inicia cada seguimiento con una clave nueva. Solo un turno puede ejecutarse en una conversación a la vez.

Los prompts pueden contener hasta 50 000 caracteres. Las cuatro herramientas de ejecución del agente requieren el alcance agent:invoke.

Habilidades

Herramienta	Qué hace	Alcance
`modem_skills`	Habilidades para usar este servidor. Omite `name` para el catálogo; pasa `name` (por ejemplo, `search-modem`) para esa habilidad.	`data:read` o `agent:invoke`

Tu cliente MCP las lee por sí solo, así que no hay nada que instalar. Consulta Habilidades para Clientes MCP para saber cómo funciona. modem_skills no es la página de Habilidades del panel de Modem.

Buscar en tus datos

Herramienta	Qué hace	Alcance
`search_modem`	Responde una pregunta en lenguaje natural sobre tus datos de Modem y devuelve las filas coincidentes.	`data:read`

search_modem es de solo lectura y no ejecuta el Agente de Modem completo ni consume créditos de agente. Prefiérela para búsquedas y búsqueda semántica. Es más rápida y barata que modem_agent_invoke.

Leer la documentación

Herramienta	Qué hace	Alcance
`modem_docs`	Busca o lee la documentación de Modem para responder cómo funciona Modem: configuración, integraciones, alcances y la API.	`data:read` o `agent:invoke`

modem_docs es de solo lectura y no consume créditos de agente.

Escribir en tu espacio de trabajo

Estas herramientas aplican cambios directamente, sin pasar por el agente.

Herramienta	Qué hace
`update_topic`	Actualiza un solo tema: prioridad, estado del ciclo de vida o estado de archivado.
`bulk_update_topics`	Actualiza hasta 100 temas a la vez, como archivar o cambiar la prioridad de un conjunto.
`merge_topics`	Aún no compatible: devuelve un error y no cambia nada.
`create_companies`	Crea hasta 50 empresas. Cada una necesita un `name` y un `domain`.
`update_companies`	Actualiza hasta 50 empresas existentes: nombre, dominio principal, logotipo, estado VIP o conexiones.
`merge_companies`	Fusiona empresas de origen en una empresa de destino, que es la que se conserva.
`add_people_to_company`	Asocia una o más personas con una empresa.
`update_people`	Actualiza hasta 50 personas existentes: nombre para mostrar, correo electrónico, descripción, estado VIP o conexiones.
`merge_people`	Fusiona personas de origen en una persona de destino, que es la que se conserva.

Todas las herramientas de escritura requieren el alcance agent:invoke. Las herramientas de actualización y fusión están marcadas como destructivas, por lo que la mayoría de los clientes MCP te piden confirmar cada llamada antes de que se ejecute. create_companies y add_people_to_company solo añaden datos y no lo están.

:::warning Las herramientas de escritura aplican cambios de inmediato y Modem no los deshace por ti. Las fusiones en particular no son reversibles desde el cliente MCP, así que confirma que el destino sea correcto antes de aprobar la llamada. :::

Permisos

Las herramientas de escritura actúan como tú, no como una cuenta de servicio. Cada una se ejecuta según tu rol existente en la organización que seleccionaste durante la autorización, aplicado de la misma manera que el panel de Modem. Si tu cuenta no puede hacer un cambio en el panel, la herramienta tampoco puede hacerlo. Si tu cuenta no es miembro de la organización seleccionada, la llamada se rechaza.

Valores de campo

Algunos campos solo aceptan un conjunto fijo de valores:

Campo	Valores aceptados
`priority`	`very_low`, `low`, `default`, `high`, `very_high`
`lifecycleState`	`open`, `in_progress`, `completed`, `dismissed`
`issueType`	`bug_report`, `feature_request`, `complaint`, `praise`, `discussion`

Los IDs de temas son UUID. Los IDs de empresas y personas son cadenas numéricas. Usa search_modem para encontrar los IDs que necesitas antes de llamar a una herramienta de escritura.

Gestionar automatizaciones

Estas herramientas listan, crean y cambian automatizaciones, los prompts que Modem ejecuta según un horario o cuando ocurre un evento.

Herramienta	Qué hace	Alcance
`list_automations`	Lista cada automatización en la organización, con su horario, salidas y ejecuciones recientes.	`data:read`
`create_automation`	Crea una automatización a partir de un nombre, zona horaria, horario y prompt.	`agent:invoke`
`update_automation`	Cambia los campos que envías en una automatización, como su prompt, horario o indicador de habilitación.	`agent:invoke`

Al igual que las herramientas de escritura, actúan como tú: eres dueño de las automatizaciones que creas y solo puedes cambiar aquellas que el panel te permita editar.

Comentarios

Herramienta	Qué hace	Alcance
`create_feedback_channel`	Crea un canal de comentarios en la aplicación y devuelve su token. Solo administradores de la organización.	`agent:invoke`
`send_feedback`	Envía comentarios sobre Modem al equipo de Modem, con tu aprobación.	`data:read` o `agent:invoke`

La habilidad install-feedback guía a un agente de codificación a través de la creación de un canal y la adición de comentarios a una aplicación. Consulta Comentarios en la aplicación.

Requisitos previos

Una cuenta de Modem con acceso a la organización que deseas usar
Claude, ChatGPT, Codex o Cursor para instalar un plugin
Cualquier otro cliente debe admitir servidores MCP remotos Streamable HTTP con OAuth

El soporte del cliente cambia rápidamente. Los ejemplos a continuación cubren clientes MCP comunes con soporte HTTP remoto. Tu cliente puede usar etiquetas ligeramente diferentes para los mismos campos, y debe admitir OAuth para el servidor de Modem.

Configura tu cliente

Estos pasos agregan el servidor a tu cliente manualmente. Para Claude, ChatGPT, Codex y Cursor, instalar un plugin es más rápido. En todos los casos, la URL del servidor es:

https://mcp.modem.dev/mcp

Claude Code

Claude Code puede agregar servidores MCP HTTP remotos desde la CLI.

claude mcp add --transport http modem https://mcp.modem.dev/mcp

Luego ejecuta /mcp dentro de Claude Code y completa el flujo de autorización del navegador.

Cursor

Para instalar el plugin en su lugar, abre la lista de Modem en el Marketplace de Cursor o ejecuta /add-plugin modem en Cursor.

El botón agrega el servidor con un clic (Cursor 3.15.12 o más reciente). Para agregarlo manualmente, abre Configuración → Configuración de Cursor → Herramientas y MCP, luego agrega un nuevo servidor MCP. Cursor almacena la configuración de MCP en un archivo mcp.json.

{
    "mcpServers": {
        "modem": {
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

Si Cursor pregunta por un tipo de transporte, elige Streamable HTTP.

VS Code y GitHub Copilot

VS Code almacena la configuración de MCP en un archivo mcp.json, ya sea en tu perfil de usuario o en .vscode/mcp.json para un espacio de trabajo.

{
    "servers": {
        "modem": {
            "type": "http",
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

Usa MCP: Agregar servidor o MCP: Abrir configuración de usuario desde la paleta de comandos si prefieres editar a través de VS Code.

Codex

El plugin de Modem en el directorio de plugins de ChatGPT también funciona en Codex. Para agregar el servidor desde la CLI en su lugar, ejecuta:

codex mcp add modem --url https://mcp.modem.dev/mcp

Luego autoriza el servidor, lo que abre el flujo del navegador:

codex mcp login modem

Codex almacena la configuración de MCP en ~/.codex/config.toml si prefieres editarla directamente. auth por defecto es oauth, por lo que se puede omitir.

[mcp_servers.modem]
url = "https://mcp.modem.dev/mcp"
auth = "oauth"

opencode

opencode almacena la configuración de MCP en opencode.json. Usa "type": "remote" para el servidor de Modem.

{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "modem": {
            "type": "remote",
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

Deja el campo headers fuera. Modem usa OAuth, por lo que no hay clave de API que pasar. opencode te solicita autorizar la primera vez que usas el servidor, o puedes activar el flujo tú mismo:

opencode mcp auth modem

ChatGPT

El camino más rápido es el plugin de Modem en el directorio de plugins de ChatGPT.

Para conectar el servidor tú mismo, usa el modo Desarrollador, que está disponible en planes de pago. La disponibilidad puede depender de tu cuenta y la política del espacio de trabajo, y OpenAI ha movido la configuración entre menús, así que revisa ambas ubicaciones a continuación.

Abre Configuración de ChatGPT y habilita el modo Desarrollador. Dependiendo de tu versión de ChatGPT, se encuentra en Seguridad e inicio de sesión, o en Aplicaciones (anteriormente Conectores) → Configuración avanzada.
En la lista de aplicaciones/conectores, haz clic en el botón de agregar (+) para crear una nueva conexión.
Dale un nombre como Modem e ingresa la URL del servidor https://mcp.modem.dev/mcp.
Si se te pide un tipo de autenticación, elige OAuth. Crea la conexión.
Completa el flujo de autorización de Modem en la ventana del navegador que se abre, luego revisa las herramientas descubiertas.

En una conversación, habilita la conexión de Modem desde el menú de herramientas del compositor, luego haz preguntas que la usen. ChatGPT pide confirmación antes de ejecutar herramientas de escritura.

Otros clientes MCP

Usa el flujo de configuración HTTP remoto o Streamable HTTP del cliente. Si pide campos, usa:

Campo	Valor
Nombre	`modem`
URL	`https://mcp.modem.dev/mcp`
Transporte	Streamable HTTP o HTTP
Autenticación	OAuth

Documentación MCP específica del cliente:

Cliente	Documentación
Claude Code	Conecta Claude Code a herramientas a través de MCP
ChatGPT	Conecta un servidor MCP remoto a ChatGPT
Cursor	Documentación de MCP de Cursor
VS Code	Referencia de configuración de MCP
Codex	Documentación de MCP de Codex
opencode	Servidores MCP de opencode

Autoriza Modem

Tu cliente MCP debería abrir una ventana del navegador para la autorización OAuth la primera vez que se conecta.

En la pantalla de consentimiento de Modem:

Confirma el nombre del cliente solicitante.
Revisa el destino de redirección.
Elige la organización de Modem si tu cuenta pertenece a más de una.
Aprueba los permisos solicitados.

Después de que se complete la autorización, tu cliente MCP puede llamar a las herramientas MCP de Modem.

Tu cliente solo ve las herramientas cubiertas por los alcances que aprobaste. Un token con data:read pero no agent:invoke ve modem_skills, modem_docs, search_modem, list_automations y send_feedback. modem_skills, modem_docs y send_feedback se exponen en cualquiera de los dos alcances.

Ejemplos de indicaciones

Tu cliente MCP elige la herramienta, así que formula la solicitud para el resultado que deseas. Los ejemplos a continuación tienden a seleccionar la herramienta indicada junto a ellos.

Consultas y preguntas, que normalmente se enrutan a search_modem:

Indicación: Busca en Modem los temas con más comentarios de cuentas empresariales este mes.

Indicación: Pregunta a Modem qué personas están asociadas con acme.com.

Trabajo de múltiples pasos y cualquier cosa que involucre herramientas conectadas, que normalmente se enruta a modem_agent_invoke:

Indicación: Usa Modem para resumir los informes de errores de mayor prioridad de los últimos 7 días.

Indicación: Pregunta a Modem qué clientes solicitaron SSO y si ya existen problemas relacionados en Linear.

Indicación: Continúa esa conversación de Modem y verifica qué clientes afectados están en planes anuales.

Cambios en tu espacio de trabajo, que normalmente se enrutan a las herramientas de escritura:

Indicación: En Modem, archiva cada tema sobre la antigua página de facturación y dime cuáles archivaste.

Indicación: Encuentra las empresas Acme duplicadas en Modem y combínalas en la que tiene el dominio acme.com.

Indicación: Marca el tema sobre fallos de inicio de sesión SSO como alta prioridad en Modem.

Automatizaciones, que normalmente se enrutan a las herramientas de automatización:

Indicación: Crea una automatización de Modem que publique cada nuevo elemento de comentarios en nuestro canal de Slack #feedback.

Indicación: Pausa mi automatización de resumen semanal de errores en Modem.

Para una nueva tarea, incluye el contexto que el agente necesita en la primera indicación. Para continuar una ejecución, pide a tu cliente que envíe un seguimiento en la conversación existente de Modem.

Seguridad y acceso

Modem autoriza al cliente MCP con OAuth. El token de acceso está limitado a la cuenta y organización de Modem seleccionadas durante el consentimiento.

Los permisos de MCP son:

Alcance	Significado	Herramientas que expone
`agent:invoke`	Ejecuta el Agente de Modem en tu nombre y aplica cambios a tu espacio de trabajo como tú.	`modem_skills`, `modem_docs`, `send_feedback`, cuatro herramientas de ejecución del agente, las herramientas de escritura del espacio de trabajo, `create_automation`, `update_automation` y `create_feedback_channel`
`data:read`	Lee tus datos de Modem a través de búsqueda en lenguaje natural y carga habilidades para este servidor. No ejecuta el agente de pago.	`modem_skills`, `modem_docs`, `send_feedback`, `search_modem`, `list_automations`

El servidor MCP resuelve la organización a partir de las afirmaciones del token OAuth, no de la URL. Mantén la URL del servidor como https://mcp.modem.dev/mcp.

Las herramientas de escritura además aplican tu propio rol en esa organización en cada llamada, por lo que un token aprobado nunca otorga más acceso del que tu cuenta de Modem ya tiene.

Límites de velocidad

Las llamadas a herramientas MCP tienen un límite de velocidad por organización, por herramienta, de 20 llamadas por minuto. Excederlo devuelve un error de límite de velocidad; espera aproximadamente un minuto y reintenta con retroceso. modem_agent_invoke y modem_agent_send_message están además sujetos a los límites de créditos de agente de tu organización.

Solución de problemas

Mi cliente MCP no muestra las herramientas de Modem

Confirma que la URL del servidor sea exactamente `https://mcp.modem.dev/mcp`.
Reinicia el cliente o recarga su lista de servidores MCP.
Asegúrate de que tu cliente admita servidores MCP remotos Streamable HTTP con OAuth.

Algunas herramientas faltan pero otras funcionan

Las herramientas se exponen por alcance. Si ves modem_skills, modem_docs, search_modem, list_automations y send_feedback pero no herramientas de agente o de escritura, tu token lleva data:read pero no agent:invoke. Vuelve a ejecutar el flujo OAuth y aprueba ambos permisos.

La autorización falla o devuelve no autorizado

Inicia sesión con la cuenta de Modem que pertenece a la organización que seleccionaste.
Vuelve a ejecutar el flujo OAuth y aprueba los permisos solicitados.
Si la autorización aún falla, contacta al soporte de Modem.

Una herramienta de escritura devuelve prohibido

Las herramientas de escritura se ejecutan como tú, bajo tu rol en la organización seleccionada. Confirma que tu cuenta puede hacer el mismo cambio en el panel de Modem y que es miembro de la organización que autorizaste.

Una llamada a herramienta tiene límite de velocidad

Las llamadas a herramientas MCP están limitadas a 20 por minuto por organización, por herramienta. Espera aproximadamente un minuto y reintenta con retroceso. Si una herramienta de agente se rechaza por costo en lugar de velocidad, los reintentos seguirán fallando hasta que el uso de las últimas 24 horas baje del límite diario, o, para el límite de uso mensual, hasta que tu asignación se restablezca.

La llamada del agente regresó antes de que la respuesta estuviera lista

modem_agent_invoke y modem_agent_send_message regresan tan pronto como Modem acepta la ejecución. Usa el conversation_id y run_id devueltos con modem_agent_get_run hasta que la ejecución alcance un estado final.

Un seguimiento devuelve un conflicto Espera a que la ejecución actual termine antes de enviar otro mensaje en la misma conversación. Si estás reintentando una solicitud, reutiliza su idempotency_key solo cuando el mensaje no haya cambiado.

Mi cliente se desconectó durante una ejecución del agente

Vuelve a conectarte y llama a modem_agent_get_run con el conversation_id y el run_id devueltos cuando comenzó la ejecución. Modem continúa las ejecuciones aceptadas después de que la conexión MCP original se cierre.

Conecté la organización equivocada

Elimina o desconecta el servidor MCP de Modem en tu cliente, luego autoriza de nuevo y selecciona la organización correcta en la pantalla de consentimiento de Modem.

Relacionado

Habilidades para clientes MCP

Las habilidades que el servidor le da a tu cliente MCP, y cómo el cliente las encuentra.

El agente Modem

Aprende qué puede consultar y hacer el agente Modem.

Servidores MCP externos

Conecta servidores de herramientas MCP externos para que el agente Modem los use.