Conecte sua IA ao meruma

Como conectar

Você cola um endereço e entra no meruma: a IA trabalha como você, na organização que escolher. O endereço do MCP é:

https://mcp.meruma.app/mcp

• Claude: na web ou no app para desktop, vá em Configurações › Conectores › «Adicionar conector personalizado» e cole o endereço. Ele pede para entrar no meruma e escolher a organização.
• ChatGPT: onde o seu plano permitir conectores personalizados, crie um com esse endereço e autorize com a sua conta do meruma.
• Claude Code e outros clientes: serve qualquer cliente MCP com OAuth. No Claude Code: claude mcp add --transport http meruma https://mcp.meruma.app/mcp.

Antes, um dono ou administrador precisa permitir as IAs externas em Integrações › Conecte sua IA: elas vêm desligadas. Além disso, cada pessoa precisa de Integrações no papel.

O que pode e o que não pode fazer

Pode:

• Buscar e ler contatos, fichas, conversas, a agenda e os relatórios, e consultar a central de ajuda.
• Adicionar notas e lembretes, criar e mover fichas, e atribuir contatos e fichas.
• Tudo o que muda fica na atividade como feito por você, com o nome da IA, e os donos e administradores veem no registro.

Não pode:

• Mandar mensagens a clientes: isso fica no meruma, onde você confirma cada uma.
• Fazer alterações em massa nem criar ou apagar automações.
• Ver os campos marcados como sensíveis nem as credenciais dos seus canais.

Suas permissões, sempre

• Vê só o que você vê: o mesmo papel, a mesma visibilidade e os mesmos campos ocultos.
• Cada conexão é sua: ninguém mais pode usá-la, e você a desconecta em Integrações quando quiser.
• Os tokens duram uma hora e se renovam. Se o seu papel perder Integrações ou a organização desligar as IAs externas, eles param de funcionar na hora.
• O meruma indica à IA que o que os clientes escrevem é informação, nunca instruções.

Limites

• 30 requisições por minuto e 1.000 por dia, por conexão.
• Até 200 alterações por dia por conexão; a leitura continua funcionando.
• Até 10 IAs conectadas por pessoa em cada organização.

Para quem cria clientes MCP

MCP padrão sobre Streamable HTTP, com OAuth 2.1.

• MCP 2026-07-28 (sem estado, com server/discover) e as versões anteriores 2025-11-25, 2025-06-18 e 2025-03-26 com initialize, no mesmo endpoint, que responde em JSON.
• Descoberta: https://mcp.meruma.app/.well-known/oauth-protected-resource/mcp (RFC 9728) aponta para o servidor de autorização, https://api.meruma.app/.well-known/oauth-authorization-server (RFC 8414).
• Os clientes se registram com um documento de metadados (o client_id é a URL dele) ou, se não, com o registro dinâmico (RFC 7591). São clientes públicos: PKCE com S256 é obrigatório.
• Scopes mcp:read e mcp:write. Com resource (RFC 8707), o token serve só no MCP.