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.devPrueba este MCPPatrocinado

Documentación

Servidor MCP de Modem

Busca, actualiza y ejecuta el Agente Modem desde clientes MCP externos

export const Prompt = ({text, variant = 'accent'}) => { const [copied, setCopied] = useState(false); const handleCopy = async () => { try { await navigator.clipboard.writeText(text); setCopied(true); setTimeout(() => setCopied(false), 2000); } catch {} }; const clipboardIcon = Copiar ; const checkIcon = Copiado ; const promptIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style={{ flexShrink: 0, opacity: 0.4 }}> Prompt ; return <div className={prompt prompt-${variant}} style={{ marginTop: '12px', marginBottom: '12px' }}> {promptIcon} {text} {copied ? checkIcon : clipboardIcon} ; };

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 Modem contra tus herramientas conectadas, o actualice tu espacio de trabajo de Modem directamente.

Información

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 Modem, consulta la página de Servidores MCP Externos.

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 tres tipos de herramientas: una que ejecuta el Agente Modem completo, una que lee tus datos directamente y un conjunto que escribe en tu espacio de trabajo de 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

Llama a `modem_agent_invoke` con un prompt y un `idempotency_key`. Modem devuelve `conversation_id`, `run_id` y un estado `working`. 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`. 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. 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 se cierra.

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 a la vez en una conversación.

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

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 Modem completo ni consume créditos del agente. Prefiérela para búsquedas y búsqueda semántica. Es más rápida y económica que modem_agent_invoke.

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, tipo de problema, palabras clave o estado de archivado.
`bulk_update_topics`	Actualiza hasta 100 temas a la vez, como archivar o re-priorizar un conjunto.
`merge_topics`	Fusiona hasta 50 temas de origen en un tema de destino.
`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 y 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.

Advertencia

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.

Requisitos previos

Una cuenta de Modem con acceso a la organización que quieras usar
Un cliente MCP que admita servidores remotos HTTP Streamable con OAuth

El soporte de clientes 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

Usa la ruta de configuración para tu cliente MCP. 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 en el navegador.

Cursor

En Cursor, abre Configuración → Configuración de Cursor → Herramientas y MCP, y 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 HTTP Streamable.

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

Codex puede agregar servidores MCP remotos desde la CLI.

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 tiene como valor predeterminado 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 pedirá autorizar la primera vez que uses el servidor, o puedes activar el flujo tú mismo:

opencode mcp auth modem

ChatGPT

ChatGPT se conecta a servidores MCP remotos a través del modo Desarrollador, 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. Según 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 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 y luego revisa las herramientas descubiertas.

En una conversación, habilita la conexión de Modem desde el menú de herramientas del compositor y 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 de HTTP remoto o HTTP Streamable del cliente. Si te pide campos, usa:

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

Documentación de MCP específica para clientes:

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

Autorizar Modem

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

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 sin agent:invoke ve search_modem y nada más.

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:

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

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

Para una tarea nueva, 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ú.	Cuatro herramientas de ejecución del agente y las herramientas de escritura del espacio de trabajo
`data:read`	Lee tus datos de Modem mediante búsqueda en lenguaje natural. No ejecuta el agente de pago.	`search_modem`

El servidor MCP resuelve la organización a partir de las declaraciones 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 y por herramienta, de 20 llamadas por minuto. Superar el límite devuelve un error de límite de velocidad que incluye una sugerencia de retryAfter contra la que tu cliente debería retroceder. modem_agent_invoke está además sujeto a los límites de créditos del agente de tu organización.

Solución de problemas

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.

Las herramientas se exponen según el alcance. Si ves `search_modem` 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.

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.

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. Las llamadas a herramientas MCP están limitadas a 20 por minuto por organización y por herramienta. Espera el intervalo de `retryAfter` en el error y reintenta con retroceso. Si `modem_agent_invoke` se rechaza por costo en lugar de velocidad, verifica el límite de créditos del agente de tu organización. `modem_agent_invoke` y `modem_agent_send_message` regresan tan pronto como Modem acepta la ejecución. Usa el `conversation_id` y el `run_id` devueltos con `modem_agent_get_run` hasta que la ejecución alcance un estado final. 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 la indicación no haya cambiado. Reconéctate 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. Elimina o desconecta el servidor MCP de Modem en tu cliente, luego autoriza nuevamente y selecciona la organización correcta en la pantalla de consentimiento de Modem.

Relacionado

Aprende qué puede consultar y hacer el Agente de Modem. Conecta servidores de herramientas MCP externos para que el Agente de Modem los use.