Vá para a seção

Integração Capsule MCP

Aproveite ainda mais seus dados com a integração MCP do Capsule.

exemplo de consulta MCP via Claude

O que é MCP?

MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA como o Claude leiam e atualizem dados nas ferramentas que você já usa. O Capsule executa seu próprio servidor MCP, que atua como uma ponte entre o Claude e a sua conta Capsule. Depois de conectado, você pode pedir ao Claude para consultar Contatos, Oportunidades, Projetos e muito mais, diretamente em uma conversa, em vez de fazer login e procurar as informações você mesmo.

Aqui estão alguns exemplos do que você pode pedir ao Claude depois que ele estiver conectado:

  • "Quantas oportunidades foram vencidas neste trimestre e qual foi o valor total delas?"
  • "Quais usuários criaram mais oportunidades nos últimos 30 dias?"
  • "Quantos novos contatos foram adicionados neste mês e de onde eles vieram?"
  • "Quais organizações não tiveram nenhuma atividade registrada nos últimos 90 dias?"

Como conectar o Claude ao Capsule

O Capsule é publicado como um conector oficial no diretório de conectores do Claude. Para configurar o conector:

  1. No Claude, abra o diretório de conectores indo em Personalizar > Conectores
  2. Procurar cápsula
  3. Clique em Conectar e faça login com suas credenciais habituais do Capsule

O conector agora está configurado e pronto para uso. Inicie um novo chat e comece a aprender mais sobre seus dados imediatamente.

O que o Claude pode fazer com o Capsule?

O Claude se conecta ao Capsule usando um conjunto fixo de ferramentas, cada uma cobrindo uma área específica da sua conta.

Contatos, Oportunidades e Projetos

O Claude pode procurar Contatos, Oportunidades e Projetos individuais ou pesquisar em todos eles da mesma forma que você faria dentro do Capsule. Esses também são os únicos registros que o Claude pode atualizar – em todos os outros lugares, o Claude é somente leitura. Você pode manter simples e perguntar:"Qual é a data de fechamento prevista para a oportunidade da Acme Corp?" ou elaborar com algo como:"Liste todas as Oportunidades no Funil de Vendas com valor acima de US$ 10.000 que têm fechamento previsto para este mês, ordenadas pela data de fechamento prevista."

Funis de Vendas, Marcos e Motivos de Perda

O Claude pode consultar como o seu funil de vendas está estruturado, incluindo seus marcos (Milestones) e motivos de perda (Lost Reasons), para conseguir traduzir a fase de uma oportunidade ou o motivo de perda em algo significativo, em vez de apenas um ID. Por exemplo, você poderia perguntar:"Quais marcos (Milestones) existem no nosso funil de vendas e qual é a probabilidade de ganho em cada etapa?", ou ir além perguntando:"Liste todos os marcos (Milestones) de todos os nossos funis de vendas, junto com sua probabilidade de ganho, ordenados da maior para a menor."

Quadros e Etapas de Projeto

A mesma ideia, mas para Projetos – o Claude pode consultar seus Quadros e Etapas para entender em que ponto do fluxo de trabalho um Projeto está. Peça algo tão simples quanto "Em que Etapa está atualmente o nosso projeto de redesign do site?", ou algo mais amplo, como "Liste todos os Projetos no nosso Quadro de Marketing, agrupados por Etapa, para que eu possa ver onde as coisas estão travando."

Tags e Campos Personalizados

Claude pode verificar como as Tags e DataTags da sua conta estão definidas para Contatos, Oportunidades e Projetos. Por exemplo, você pode perguntar: "Quais Tags usamos para categorizar nossas Oportunidades?" E não precisa parar por aí – você também pode perguntar: "Liste todas as Tags que configuramos para Contatos e me diga quais delas são DataTags."

Claude também pode verificar como seus Campos Personalizados estão definidos e atualizar seus valores diretamente em um registro. Por exemplo, você poderia pedir:"Atualize o campo personalizado Revisado de Jennifer Kim para Sim".

exemplo de chat do Claude atualizando o valor de um campo personalizado de um contato via MCP
registro de contato do Capsule mostrando o campo personalizado atualizado pelo Claude

Atividades, Registros e Tarefas

O Claude pode exibir o histórico registrado em um registro – notas, e‑mails e Tarefas concluídas – assim como quaisquer Tarefas em aberto que ainda não aconteceram. Isso é útil para se atualizar rapidamente sobre um Contato ou Oportunidade antes de uma ligação, seja porque você só quer "Qual foi a atividade mais recente registrada no contato da Acme Corp?" ou algo mais completo, como "Resuma todos os e‑mails e notas registrados no contato da Acme Corp nos últimos 90 dias e destaque qualquer coisa que pareça precisar de acompanhamento."

Faixas

Claude pode ver quais Tracks (sequências automatizadas de Tarefas) estão em execução em um registro e quais Tarefas elas já criaram até agora. Por exemplo, você poderia perguntar: "Há alguma Track em execução nesta oportunidade e quais Tarefas ainda faltam?" Ou vá além – tente perguntar: "Liste todas as Tarefas em aberto em todas as Tracks em execução nas minhas Oportunidades desta semana, agrupadas por data de vencimento."

Usuários e equipes

O Claude pode consultar os Usuários e as Equipes na sua conta, incluindo com qual Usuário ele está autenticado no momento – útil para perguntas sobre quem é dono do quê ou como sua conta está estruturada, desde algo rápido como "De qual Equipe a Jane faz parte?" até algo mais amplo, como "Liste todas as Equipes da nossa conta, junto com quem é membro de cada uma."

Filtrar e pesquisar seus registros

Você pode pedir ao Claude para pesquisar ou filtrar seus Contatos, Oportunidades, Projetos, Atividades e Tarefas sem precisar conhecer os nomes dos campos subjacentes – basta descrever o que você está procurando, incluindo quaisquer detalhes específicos da Tarefa, como status ou data de vencimento, e o Claude cuidará do resto. Por exemplo, você pode perguntar:"Quais Tarefas em aberto estão atrasadas e atribuídas à Jane?"

Como o Claude se conecta e o que ele pode ver

O servidor MCP do Capsule exige que todas as solicitações incluam um token de autorização válido – não há como se conectar sem um. Se uma solicitação chegar sem esse token, o Capsule a rejeita e orienta o cliente de volta para os detalhes de conexão de que ele precisa para se autenticar. Na prática, isso significa:

  • O Claude autentica usando o seu próprio login do Capsule, não uma conta de serviço compartilhada.
  • Tudo o que o seu login pode acessar no Capsule – incluindo quaisquer Controles de Acesso que o restrinjam a determinadas equipes ou registros – é exatamente o que o Claude pode acessar. Nada além disso.
  • O acesso de permite que o seu cliente MCP visualize dados no seu CRM, enquanto o acesso de atualização está atualmente limitado à modificação de Campos Personalizados.

Como os meus dados do Capsule são usados com o Claude?

Para responder às suas perguntas, a Capsule compartilhará com segurança os dados de registro que você solicitar com a Anthropic, nosso suboperador de confiança.

Resolução de problemas da integração MCP

Alguns problemas comuns que você pode encontrar ao usar o Claude com o Capsule e o que fazer em cada caso.

Claude diz que não está autorizado / não consegue se conectar

Seu cliente MCP precisa concluir a etapa de autorização antes que qualquer solicitação seja bem-sucedida — uma autorização incompleta ou expirada será rejeitada. Reconecte-se por meio do seu cliente MCP e conclua o processo de login novamente.

O Claude não consegue ver um registro que eu esperava que ele visse

Claude só pode ver os registros aos quais o seu próprio login do Capsule tem acesso. Se um registro pertencer a uma Equipe da qual você não faz parte, peça a um Administrador para atualizar seus Controles de Acesso.

Claude atualizou o valor errado de um Campo Personalizado ou quero desfazer uma atualização

As ferramentas de atualização substituem diretamente os valores dos Campos Personalizados e não mantêm um histórico próprio de alterações. Verifique o Campo Personalizado no registro no Capsule e corrija o valor manualmente, ou peça ao Claude para restaurá‑lo.

Quero impedir que o Claude acesse o Capsule

Revogue a conexão do seu cliente MCP ou peça ao Administrador do seu Capsule para fazê-lo. Isso invalida imediatamente o token que o Claude estava usando – nenhuma outra solicitação será bem-sucedida.