> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.cooby.co/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Conectar assistentes de IA à Cooby # 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)](https://modelcontextprotocol.io) 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](#funcoes-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"). ![](https://storage.crisp.chat/users/helpdesk/website/-/a/7/7/6/a776868fb0318800/screenshot-2026-07-03-at-11531_p7lnki.png =720xauto) ## 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: ```json { "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 | Você pergunta | O que acontece | | ---- | ---- | | "Com quem devo fazer follow-up hoje?" | Lista suas conversas em que a **última mensagem é do cliente** (aguardando sua resposta), das mais recentes para as mais antigas. | | "Resuma minha conversa com a Acme da semana passada." | Encontra o contato, busca as mensagens recentes e faz um resumo. | | "O que a Carla disse sobre preços?" | Lê a conversa com a Carla e responde com base nas mensagens reais. | | "Quais das minhas conversas ficaram paradas nos últimos 3 dias?" | Combina os horários de atividade das conversas com o indicador de sem resposta. | ### Para gerentes de vendas (somente administradores) | Você pergunta | O que acontece | | ---- | ---- | | "Liste os membros da minha equipe." | Retorna todos os membros do Workspace com o ID de usuário e a função de cada um. | | "Mostre as conversas sem resposta de toda a equipe nas últimas 48 horas." | Consulta as conversas de cada membro no período; cada resultado mostra **de quem** é a conversa. | | "Traga as conversas desta semana da Maria e do Ken e sinalize os negócios em risco." | Consulta só esses dois vendedores e analisa os resultados. | | "Mostre a conversa da Maria com a Acme." | Lê uma conversa específica de um vendedor (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.) ![](https://storage.crisp.chat/users/helpdesk/website/-/a/7/7/6/a776868fb0318800/screenshot-2026-07-04-at-11433_1dnp6a8.png) ### 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. ![](https://storage.crisp.chat/users/helpdesk/website/-/a/7/7/6/a776868fb0318800/screenshot-2026-07-04-at-11434_1erhtrh.png =577xauto) --- ## Gerenciar agentes conectados Acesse **Cooby workspace → Settings → Connected AI agents** (`app.cooby.co/settings/connected-agents`). ![Connected AI Agents settings in the Cooby workspace](https://storage.crisp.chat/users/helpdesk/website/-/a/7/7/6/a776868fb0318800/connected-ai-agents_1cpjm4i.png) * **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. ![](https://storage.crisp.chat/users/helpdesk/website/-/a/7/7/6/a776868fb0318800/screenshot-2026-07-03-at-12531_1nm4wld.png =1113xauto) --- ## Funções e acesso aos dados | Permissão | Membro | Administrador | | ---- | ---- | ---- | | Ler as próprias conversas, mensagens e contatos | ✅ | ✅ | | Listar os membros do Workspace | ❌ | ✅ | | Ler as conversas ou mensagens de um colega específico | ❌ | ✅ | | Ler as conversas de vários membros ou de toda a equipe, com intervalos de tempo | ❌ | ✅ | | Revogar os próprios agentes conectados | ✅ | ✅ | | Revogar os agentes conectados de qualquer membro | ❌ | ✅ | 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 | Sintoma | Causa provável / solução | | ---- | ---- | | "Couldn't connect" / "couldn't register" | Confira se a URL é exatamente `https://mcp.cooby.co/mcp` (com o caminho `/mcp`). Depois tente de novo; problemas temporários de rede também aparecem assim. | | A página de consentimento diz que a solicitação expirou | O login levou mais de 10 minutos. Volte ao seu cliente de IA e conecte de novo. | | O agente responde que não tem acesso aos dados de um colega | Você é Membro; os dados de colegas exigem a função de Administrador. Peça ao administrador do seu Workspace. | | "Com quem devo fazer follow-up?" retorna um erro sobre o seu telefone | Sua conta da Cooby ainda não tem um número de WhatsApp conectado, então não dá para calcular quais conversas têm resposta. Conecte o seu WhatsApp primeiro. | | O agente de repente recebe erros de permissão no meio da conversa | O acesso foi revogado (por você ou por um administrador) em Settings → Connected AI agents. Reconecte, se for o caso. | | Erros de limite de uso | O agente está fazendo chamadas muito rápido; ele pode tentar de novo depois de um minuto. Limite: 60 por minuto por agente. | **Dúvidas?** Fale com .