Ferramentas do MCP do Pipedrive
YS
Última atualização: 4 de novembro de 2026
No MCP, ferramentas são as ações que os assistentes de IA podem executar no Pipedrive. Cada ferramenta tem uma finalidade específica, como criar um negócio, consultar os detalhes de um contato ou atualizar uma atividade.
Quando um assistente de IA se conecta ao Pipedrive por meio do MCP, ele pode usar essas ferramentas para acessar informações e executar ações em seu nome, de acordo com as permissões que você conceder.
Os nomes das ferramentas seguem um padrão consistente:
getX (plural) | Obter uma lista |
getX (singular) | Obter um registro específico |
addX | Criar um novo registro |
updateX | Editar um registro existente |
searchX | Encontrar registros por palavra-chave ou critérios |
Ferramentas específicas do MCP do Pipedrive
Atividades
Ferramenta | Ação | Caso de uso |
getActivities | Buscar uma lista de atividades | “Mostre todas as chamadas agendadas para esta semana” |
getActivity | Buscar uma atividade específica | “Mostre os detalhes desta reunião específica” |
addActivity | Criar atividades | “Agende uma chamada de follow-up com este contato” |
updateActivity | Editar atividades registradas | “Marque esta ligação como concluída” ou “Reagende-a” |
Negócios
Ferramenta | Ação | Caso de uso |
getDeals | Buscar uma lista de negócios | “Mostre todos os negócios abertos no meu funil” |
getDeal | Buscar um negócio específico | “Mostre os detalhes do negócio da Sapatos e CIA” |
addDeal | Criar negócios | “Crie um negócio para este novo lead” |
updateDeal | Editar negócios | “Mova este negócio para a próxima etapa” ou “Atualize o valor” |
searchDeals | Pesquisar negócios por palavra-chave | “Encontre todos os negócios que mencionam empresa X” |
Pessoas
Ferramenta | Ação |
getPersons | Buscar uma lista de contatos |
getPerson | Buscar um contato específico |
addPerson | Criar contatos |
updatePerson | Editar contatos existentes |
searchPersons | Encontrar contatos por nome, e-mail ou outros critérios |
Organizações
Ferramenta | Ação |
getOrganizations | Buscar uma lista de organizações |
getOrganization | Buscar uma organização específica |
addOrganization | Criar organizações |
updateOrganization | Editar organizações |
searchOrganization | Pesquisar organizações por nome ou palavra-chave |
Leads
Ferramenta | Ação |
getLeads | Buscar uma lista de leads |
getLead | Buscar um lead específico |
addLead | Criar um novo lead |
updateLead | Editar um lead existente |
searchLeads | Encontrar leads por palavra-chave ou critérios |
convertLeadToDeal | Converter um lead em negócio |
getLeadConversionStatus | Verificar se um lead foi convertido e em qual negócio |
Produtos
Ferramenta | Ação |
getProducts | Buscar uma lista de produtos |
getProduct | Buscar um produto específico |
addProduct | Criar um novo produto |
updateProduct | Editar um produto existente |
searchProduct | Pesquisar produtos por nome ou palavra-chave |
Funil
Ferramenta | Ação |
getStages | Buscar todas as etapas de um funil |
getStage | Buscar detalhes de uma etapa específica |
Anotações
Ferramenta | Ação |
getNotes | Buscar lista de anotações |
getNote | Busca detalhes de uma anotação específica |
addNote | Adicionar uma anotação vinculada a um negócio, lead, contato ou organização |
updateNote | Atualizar uma anotação específica pelo ID |
Contexto
Se suas permissões não abrangerem parte dessas informações, a ferramenta ignorará essa parte e retornará o restante.
Ferramenta | Ação |
getAccountContext | Buscar os detalhes da conta: seu usuário, os funis e suas etapas, os campos personalizados de negócios, pessoas, organizações, produtos e atividades, além dos outros usuários da sua empresa |
E-mails
Observação: estas ferramentas exigem que a sincronização de e-mails esteja conectada.
| Ferramenta | Ação |
| getMailThreads | Buscar uma lista de conversas por e-mail |
| getMailThread | Buscar uma conversa por e-mail específica |
| getMailThreadMessages | Buscar todas as mensagens de uma conversa por e-mail |
| getMailMessage | Buscar uma mensagem de e-mail específica |
| updateMailThreadDetails | Editar os detalhes de uma conversa por e-mail existente |
| getDealMailMessages | Buscar as mensagens de e-mail vinculadas a um negócio |
| getPersonMailMessages | Buscar as mensagens de e-mail vinculadas a um contato |
| getOrganizationMailMessages | Buscar as mensagens de e-mail vinculadas a uma organização |
Casos de uso:
- Veja todo o histórico de e-mails de um negócio, uma pessoa ou uma organização antes de uma ligação para saber o que foi dito por último
- Encontre uma conversa por e-mail, leia todas as mensagens e faça um resumo do que está pendente ou de quem ainda precisa responder
- Atualize os detalhes de uma conversa por e-mail, como a vinculação a um negócio ou a uma pessoa, sem abrir a aba E-mail
Projects
Observação: o recurso Projects faz parte da extensão Projects.
| Ferramenta | Ação |
| getProjects | Buscar uma lista de projetos |
| getProject | Buscar um projeto específico |
| addProject | Criar um novo projeto |
| updateProject | Editar um projeto existente |
| searchProjects | Encontrar projetos por palavra-chave ou critérios |
Casos de uso:
- Pesquise, visualize, crie e atualize projetos em linguagem natural. Por exemplo, “Mostre todos os projetos atrasados” ou “Inicie um projeto para o negócio Acme”.
- Transforme um negócio ganho em um projeto com uma única solicitação
Não vejo todas as ferramentas do MCP do Pipedrive no meu assistente de IA
À medida que novas ferramentas forem adicionadas ao MCP do Pipedrive, talvez seja necessário atualizar a lista para acessar as ferramentas mais recentes disponíveis.
Para atualizar a lista de ferramentas:
- Acesse Conectores ou Plugins (dependendo do seu assistente de IA) > MCP do Pipedrive
- Abra o menu suspenso “Mais”
- Clique em “Atualizar lista de ferramentas”
Após a atualização, as ferramentas mais recentes do MCP do Pipedrive estarão disponíveis no seu conector.
Este artigo foi útil?
Sim
Não