Saltar al contenido
meruma Desarrolladores

Desarrolladores · Inteligencia artificial

Conecta tu IA a meruma

Claude, ChatGPT u otra IA trabajan en meruma como tú, con tus permisos. Buscan contactos y fichas, leen chats y la agenda, y anotan por ti.

Cómo conectarla

Pegas una dirección y entras a meruma: la IA trabaja como tú, en la organización que elijas. La dirección del MCP es:

https://mcp.meruma.app/mcp
  • Claude: en la web o en la app de escritorio, ve a Configuración › Conectores › «Agregar conector personalizado» y pega la dirección. Te pide entrar a meruma y elegir la organización.
  • ChatGPT: donde tu plan permita conectores personalizados, crea uno con esta dirección y autorízalo con tu cuenta de meruma.
  • Claude Code y otros clientes: sirve cualquier cliente MCP con OAuth. En Claude Code: claude mcp add --transport http meruma https://mcp.meruma.app/mcp.

Antes, un dueño o administrador tiene que permitir las IAs externas en Integraciones › Conecta tu IA: vienen apagadas. Además, cada persona necesita Integraciones en su rol.

Qué puede hacer y qué no

Puede:

  • Buscar y leer contactos, fichas, chats, la agenda y los reportes, y consultar el centro de ayuda.
  • Agregar notas y recordatorios, crear y mover fichas, y asignar contactos y fichas.
  • Todo lo que cambia queda en la actividad como hecho por ti, con el nombre de la IA, y los dueños y administradores lo ven en el registro.

No puede:

  • Mandar mensajes a clientes: eso queda en meruma, donde confirmas cada uno.
  • Hacer cambios masivos ni crear o borrar automatizaciones.
  • Ver los campos marcados como sensibles ni las credenciales de tus canales.

Tus permisos, siempre

  • Ve solo lo que ves tú: el mismo rol, la misma visibilidad y los mismos campos ocultos.
  • Cada conexión es tuya: nadie más la puede usar, y la desconectas desde Integraciones cuando quieras.
  • Los tokens duran una hora y se renuevan. Si tu rol pierde Integraciones o la organización apaga las IAs externas, dejan de servir en el momento.
  • meruma le indica a la IA que lo que escriben los clientes es información, nunca instrucciones.

Límites

  • 30 pedidos por minuto y 1.000 por día, por conexión.
  • Hasta 200 cambios por día por conexión; leer sigue funcionando.
  • Hasta 10 IAs conectadas por persona en cada organización.

Para quienes arman clientes MCP

MCP estándar sobre Streamable HTTP, con OAuth 2.1.

  • MCP 2026-07-28 (sin estado, con server/discover) y las versiones anteriores 2025-11-25, 2025-06-18 y 2025-03-26 con initialize, en el mismo endpoint, que responde en JSON.
  • Descubrimiento: https://mcp.meruma.app/.well-known/oauth-protected-resource/mcp (RFC 9728) apunta al servidor de autorización, https://api.meruma.app/.well-known/oauth-authorization-server (RFC 8414).
  • Los clientes se registran con un documento de metadatos (el client_id es su URL) o, si no, con el registro dinámico (RFC 7591). Son clientes públicos: PKCE con S256 es obligatorio.
  • Scopes mcp:read y mcp:write. Con resource (RFC 8707), el token sirve solo en el MCP.

Revisado el