Ferramentas do MCP do Pipedrive
YS
Última atualização: 16 de julho 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 é conectado ao Pipedrive por meio do MCP, ele pode usar essas ferramentas para acessar informações e executar ações em nome do usuário, respeitando as permissões fornecidas.
Os nomes das ferramentas seguem um padrão consistente:
getX | 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 |
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 |
Funil
Ferramenta | Ação |
getStages | Buscar todas as etapas de um funil |
getStage | Buscar detalhes de uma etapa específica |
Notas
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 |
Este artigo foi útil?
Sim
Não