Conectar apps de IA (MCP)

O MonoChat MCP Server permite que um app de IA compatível com o Model Context Protocol (MCP), como o Claude Code ou o Cursor, trabalhe com a sua conta MonoChat. O app de IA pede dados ao MonoChat por meio de um conjunto fixo de ferramentas e só consegue ver o que você vê.

O MonoChat MCP Server está disponível em todos os planos, sem limites por plano.

Uma conexão age como você

Um app de IA conectado com a sua chave de acesso age como o seu usuário. Ele alcança os tenants que você pode acessar e nada além disso. Revogue as conexões que você não usa mais.

O que o app de IA pode fazer

Estas ferramentas estão disponíveis em todas as conexões:

Ferramenta	O que faz
list_tenants	Lista os tenants que a conexão pode acessar.
list_sessions	Lista as sessões de conversa de um tenant, da mais recente para a mais antiga, opcionalmente apenas as opened, assigned ou closed.
get_session	Retorna uma sessão de conversa.
list_messages	Lista as mensagens de uma sessão, da mais recente para a mais antiga.
search_customers	Pesquisa os clientes de um tenant por palavra-chave.
list_message_templates	Lista os modelos de mensagem de um canal de um tenant.

O texto das mensagens vem de clientes e atendentes. São dados para o app de IA ler, não instruções.

Uma conexão tem um escopo: Somente leitura ou Leitura e escrita. Uma conexão somente leitura nunca vê ferramentas que alteram dados. Todas as ferramentas listadas acima apenas leem.

Criar uma conexão

Uma conexão pertence à sua conta, não a um tenant. Você precisa ter configurado antes a verificação em duas etapas (por e-mail ou por app autenticador).

1. Abra as configurações do perfil, selecione a aba Conexões MCP e clique em Criar.
2. Informe um nome, escolha o escopo (Somente leitura por padrão) e a validade em dias (90 por padrão, no máximo 365).
3. Digite o código de confirmação de 6 dígitos do seu método de verificação em duas etapas. Se você usa a verificação por e-mail, clique primeiro em Enviar código de confirmação.
4. Copie a chave de acesso. Ela é exibida apenas uma vez e começa com mcp_sk_.

Você pode ter até 10 conexões ativas.

Conectar um app de IA

O servidor fica em https://app.monochat.ai/api/mcp-server (use o seu próprio endereço do MonoChat se você executa o MonoChat em servidores próprios) e espera a chave de acesso como token bearer no cabeçalho Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Adicione o servidor a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Qualquer outro cliente MCP que ofereça suporte ao transporte streamable HTTP e a cabeçalhos personalizados se conecta da mesma forma.

Limites

As chamadas são contadas por minuto: 60 por conexão, 300 por conta e 600 por tenant, e no máximo 4 chamadas ao mesmo tempo por conexão. Algumas ferramentas contam como mais de uma chamada. Quando um limite é atingido, o servidor responde com o status 429 e um cabeçalho Retry-After; o app de IA deve esperar essa quantidade de segundos.

Revogar uma conexão

Cada conexão na aba Conexões MCP mostra o status, o escopo, a validade e o último uso. Clique em Revogar para cortar o app de IA imediatamente. Uma conexão revogada ou expirada não pode ser usada novamente; crie uma nova.

Gerenciar o acesso MCP de uma organização

Usuários que podem alterar as configurações de uma organização gerenciam o acesso MCP dela em Configurações › Organização › Servidor MCP.

• Desativar o acesso MCP para esta organização: ative e clique em Salvar para recusar toda chamada MCP para esta organização, de qualquer conexão de qualquer usuário. A organização deixa de aparecer em list_tenants. Desative e salve para permitir o acesso MCP novamente.
• Chamadas MCP: toda chamada a uma ferramenta que indica esta organização, da mais recente para a mais antiga, incluindo as recusadas. Cada linha mostra o usuário, a conexão, a ferramenta, o status (Sucesso ou Falhou), o endereço IP e o horário. Chamadas de usuários que não são membros desta organização não são exibidas.