Conectar assistentes de IA à Cooby (MCP)

Conecte assistentes de IA como Claude ou ChatGPT ao seu Workspace da Cooby e receba respostas direto das suas conversas de WhatsApp. Pergunte quem está esperando resposta, peça um resumo de um negócio antes de uma ligação ou, se você é gerente de vendas, revise os follow-ups da sua equipe.

A Cooby oferece um servidor somente leitura MCP (Model Context Protocol) em https://mcp.cooby.co/mcp. Qualquer cliente de IA compatível com MCP pode se conectar: Claude (Desktop e claude.ai), ChatGPT, Cursor e outros.

O que os agentes de IA podem fazer: ler suas conversas e mensagens de WhatsApp, seus contatos e os vínculos deles com o CRM.
O que eles nunca podem fazer: enviar mensagens, registrar atividades no CRM, nem alterar ou excluir nada.

Requisitos

• Uma conta em um Workspace da Cooby (qualquer função, veja Funções e acesso aos dados).
• Um cliente de IA compatível com MCP. Este guia cobre Claude Desktop, claude.ai, ChatGPT e Cursor, além de instruções gerais para qualquer outro cliente MCP.
• Sem chaves de API e sem configuração pelo seu administrador. Você mesmo autoriza a conexão com o seu login da Cooby.

Conectar o Claude Desktop

1. Abra Claude Desktop → Settings → Connectors → Add custom connector.
2. Digite a URL do servidor:

   https://mcp.cooby.co/mcp

3. Clique em Add e depois em Connect. O navegador abre a página de login da Cooby. Faça login com a sua conta da Cooby, se ainda não estiver conectado.
4. Revise a tela de consentimento. Ela mostra qual aplicativo está pedindo acesso (por exemplo, "Claude") e exatamente o que ele pode e não pode fazer:

• ✅ Pode ler suas conversas e mensagens de WhatsApp
• ✅ Pode ler seus contatos e vínculos com o CRM
• ❌ Não pode enviar mensagens
• ❌ Não pode alterar nem excluir nada

5. Clique em Approve. Você volta para o aplicativo e o conector aparece como conectado.
6. Experimente: "Com quem devo fazer follow-up hoje?"

Conectar o claude.ai (web)

1. Acesse claude.ai → Settings → Connectors → Add custom connector.
2. Digite https://mcp.cooby.co/mcp e clique em Add.
3. Conclua o mesmo fluxo de login e consentimento descrito acima.

Conectar o ChatGPT ou o Codex

Conectores personalizados no ChatGPT exigem um plano com suporte a conectores (por exemplo, Plus, Pro ou Business) e podem precisar do Developer mode ativado (Settings → Apps & Connectors → Advanced).

1. Abra ChatGPT → Settings → Apps & Connectors → Create (ou Add custom connector).
2. Dê o nome "Cooby" e digite a URL do servidor MCP:

   https://mcp.cooby.co/mcp

3. Escolha a autenticação OAuth (o ChatGPT encontra o serviço de login da Cooby automaticamente) e salve.
4. Conclua o mesmo fluxo de login e consentimento da Cooby descrito acima e depois ative o conector em uma conversa (em alguns planos, pelo menu de ferramentas ou "Use connectors").

Conectar o Cursor

1. Cursor → Settings → MCP → Add new MCP server, transporte HTTP (streamable).
2. URL: https://mcp.cooby.co/mcp. O Cursor abre o mesmo fluxo de login e consentimento no navegador.

Conectar qualquer outro cliente MCP

A Cooby funciona com qualquer cliente compatível com MCP via Streamable HTTP com OAuth:

• URL do servidor: https://mcp.cooby.co/mcp
• Autenticação: OAuth 2.1 com descoberta automática, sem chave de API e sem ID de cliente para colar. O cliente se registra sozinho e abre uma janela do navegador para o login e o consentimento da Cooby.
• Para clientes configurados por JSON (por exemplo, algumas ferramentas de desktop), uma entrada típica fica assim:

{
    "mcpServers": {
      "cooby": { "type": "http", "url": "https://mcp.cooby.co/mcp" }
    }
  }

• Se o seu cliente pedir os dados de OAuth manualmente, os endpoints de autorização e de token estão publicados em https://mcp.cooby.co/.well-known/oauth-authorization-server; o scope é mcp:read; PKCE (S256) é obrigatório.

Observação: por segurança, a Cooby só aceita URLs de redirecionamento OAuth de aplicativos de IA conhecidos (Claude, ChatGPT, Cursor) e de aplicativos de desktop locais (localhost). Se o seu cliente MCP não for aceito, fale com o suporte e vamos avaliar a inclusão dele.

O que perguntar

Para vendedores

Para gerentes de vendas (somente administradores)

Visualizações interativas

Quando o seu cliente de IA é compatível com MCP Apps (Claude e ChatGPT são), algumas respostas chegam como um card interativo dentro da conversa, e não só como texto. Hoje existem duas visualizações:

Painel de atividade da equipe (administradores)

Pergunte "Mostre o painel da equipe" (ou "Como está minha equipe esta semana?"). Em vez de um monte de números, você recebe um card visual com uma linha por vendedor:

• total de conversas e quantas estão aguardando resposta (gráfico de barras)
• quantas conversas estiveram ativas nos últimos 7 dias
• um indicador de última atividade para que os vendedores menos ativos se destaquem na hora

Use na segunda-feira de manhã para ver rapidamente onde os follow-ups estão se acumulando e quem precisa de um empurrãozinho. (Somente administradores, assim como os dados da equipe por trás dele.)

Visualização da conversa

Pergunte "Mostre minha conversa com a Acme" (vendedores) ou "Mostre a conversa da Maria com a Acme" (administradores) e as mensagens aparecem como uma conversa no estilo do WhatsApp, com as suas mensagens à direita, as do cliente à esquerda, separadores por dia e um selo de "sem resposta" quando a última mensagem foi do cliente. É mais fácil de ler do que uma transcrição simples antes de abrir a conversa de verdade.
Se o seu cliente não for compatível com MCP Apps, nada quebra. Você recebe a mesma informação como texto simples em vez de um card. Não é preciso ativar nada; a visualização aparece automaticamente quando o cliente consegue exibi-la.

Gerenciar agentes conectados

Acesse Cooby workspace → Settings → Connected AI agents (app.cooby.co/settings/connected-agents).

• Membros veem os agentes conectados à própria conta.
• Administradores veem todos os agentes conectados no Workspace, com o dono indicado em cada linha.
• Cada linha mostra o nome do agente, quando ele foi conectado e quando foi usado pela última vez.
• Revoke desconecta esse agente na hora. O token de sessão atual para de funcionar na próxima solicitação, e não só na próxima renovação. Membros podem revogar os próprios agentes; administradores podem revogar os de qualquer pessoa.

Reconectar depois de revogar segue o mesmo fluxo da primeira conexão.

Funções e acesso aos dados

Cada solicitação fica restrita a um único Workspace, aquele que você autorizou no consentimento. Um agente não consegue acessar os dados de outro Workspace, e um membro que pede dados de outra pessoa recebe um erro de permissão, não importa como a pergunta é feita.

Detalhes técnicos

Protocolo e endpoint

• MCP via Streamable HTTP em https://mcp.cooby.co/mcp (sem estado; sem afinidade de sessão no servidor).
• Ferramentas disponíveis (todas somente leitura, com anotações readOnlyHint e esquemas de saída tipados): get_workspace_snapshot, search_contacts, get_contact, list_chats, get_chat, list_members (administradores).

Autorização e isolamento de dados

• Cada token fica vinculado a um usuário e a um Workspace, definidos no consentimento. Toda consulta ao banco de dados filtra por esse Workspace; nenhum parâmetro de ferramenta consegue ampliar isso.
• As permissões de membro e de administrador são aplicadas no servidor a cada solicitação (veja a tabela acima).
• Revogar um acesso invalida na hora os tokens de acesso e de renovação.

Limites de uso, auditoria e privacidade

• Limites de uso: 60 solicitações por minuto por agente conectado, 600 por minuto por Workspace. Se eles forem ultrapassados, o agente recebe um erro de limite de uso e pode tentar de novo depois de uma pausa.
• Toda chamada de ferramenta é registrada na auditoria: quem, qual agente, qual ferramenta, status e latência. Os argumentos das ferramentas são guardados apenas como hash, então o conteúdo das mensagens e os nomes dos contatos nunca aparecem nos registros.
• O conteúdo das mensagens é criptografado em repouso e só é descriptografado dentro da solicitação que o devolve ao seu agente autorizado.

Solução de problemas

Dúvidas? Fale com support@cooby.co.

Actualizado em: 15/10/2026