Integração · CRM e vendas
Conecte Claude e ChatGPT ao CiviCRM
Peça à sua IA para encontrar um contato, extrair contribuições de um doador ou verificar quem está registrado em um evento no CiviCRM. Funciona através da APIv4 do CiviCRM, permitindo ler e alterar os mesmos registros que você: contatos, atividades, contribuições, eventos, participantes, membrosidades e outras entidades do seu site.
Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.
Experimente pedir
“Encontre o registro de contato para [email protected].”
A IA executa um get de Contato com filtro por email e exibe o contato correspondente com nome e ID.
“Liste as contribuições do contato 2381 deste ano.”
Ela consulta Contribuição para esse contato e intervalo de datas, listando valor, data e status.
“Quem está registrado no nosso evento de arrecadação de outono?”
Ela encontra o evento e lista os registros de Participante com contato e status.
O que a sua IA pode fazer
Qualquer entidade APIv4
Liste as entidades expostas pelo seu site, como Contato, Contribuição, Evento ou Membrosidade, e veja seus campos com getFields.
Pesquisa com filtros
Use get com select, where e limit para encontrar exatamente os registros que você precisa, sem escrever consultas manualmente.
Criar, atualizar e excluir
Adicione ou altere registros com create, update e save. Excluir é permanente, então pode mantê-lo atrás de aprovação.
“Quais membrosidades expiram no próximo mês?”
Ela obtém registros de Membrosidade com data de término nesse intervalo, incluindo contato e tipo de membrosidade.
“Registre uma chamada telefônica com o contato 2381 sobre sua promessa.”
Ela cria uma Atividade do tipo chamada nesse contato com um assunto que você fornece.
“Quais campos posso usar no Contato?”
Ela executa getFields em Contato e lista os campos disponíveis, incluindo campos personalizados.
2 ferramentas para CiviCRM
Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.
call_apiAltera dadosExecute uma ação APIv4 do CiviCRM em uma entidade: `entity` (por exemplo, Contato, Atividade, Contribuição, Evento, Participante, Membro), `action` (obter, obterCampos, criar, atualizar, salvar, excluir) e `params` como uma string JSON com select, where, values e limit. Use get para pesquisar e getFields para ver os campos disponíveis; criar, atualizar e excluir alteram dados do CRM ao vivo e a exclusão não pode ser desfeita.list_entitiesAltera dadosListe os tipos de registros (entidades APIv4) disponíveis neste site do CiviCRM, como Contato, Contribuição, Evento ou Membro. Use-o para encontrar o nome da entidade correta antes de chamar call_api.
Configure em três passos
- 1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha CiviCRM na lista de aplicações.
- 2
Cole a sua chave
Cole o endereço do seu site CiviCRM (a parte antes de /civicrm/...) e uma chave da API. Seu administrador do CiviCRM atribui a chave ao seu registro de contato e concede à sua função a permissão 'autenticar com chave da API'. A extensão AuthX (CiviCRM 5.36+, ativada por padrão em sites mais recentes) deve aceitar chaves da API via cabeçalho X-Civi-Auth.
- 3
Adicione a ligação à sua IA
Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:
- Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
- Cole a sua ligação no campo URL do servidor MCP remoto.
- Ative-o no menu + de uma conversa.
Perguntas
O que a IA pode fazer no CiviCRM?
Ela pode listar as entidades APIv4 do seu site e executar ações APIv4 nelas: get e getFields para pesquisar e ler, e create, update, save e delete para alterar dados. Isso cobre registros como contatos, atividades, contribuições, eventos, participantes e membrosidades.
A IA vê minhas credenciais do CiviCRM?
Não. Sua chave da API do CiviCRM é criptografada em repouso e nunca é mostrada à IA. Após você salvá-la, ela não é mostrada novamente, nem mesmo para você. A IA só vê os resultados das ferramentas que chama.
Posso controlar o que a IA é autorizada a fazer?
Sim. Você escolhe quais ferramentas estão ativadas e ações de risco podem exigir sua aprovação antes de executar. Criar, atualizar e excluir alteram dados do CRM ao vivo, e uma exclusão não pode ser desfeita. A chave da API também possui apenas as permissões do contato a que pertence. Cada chamada de ferramenta é registrada.
Funciona com o ChatGPT?
Sim. No ChatGPT, vá em Configurações › Aplicações & Conectores › Avançado e ative o Modo Desenvolvedor, depois adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona também no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.
Qual é o custo?
O PipMCP tem um plano gratuito sem necessidade de cartão de crédito. Os planos pagos cobram por tarefa concluída. Você também precisa de seu próprio site CiviCRM.
Por que meu administrador do CiviCRM precisa configurar a chave?
As chaves da API do CiviCRM estão vinculadas a um registro de contato e geralmente são atribuídas por um administrador, por exemplo, com a extensão Chave da API ou o Explorador APIv4. Seu papel também precisa ter a permissão 'autenticar com chave da api' e o AuthX deve aceitar chaves no cabeçalho X-Civi-Auth.
Integrações relacionadas
Deixe a sua IA trabalhar em CiviCRM ainda hoje.
Comece gratuitamente. A sua chave permanece encriptada e é você quem decide o que a IA pode fazer.
Ligar CiviCRM gratuitamenteO PipMCP não tem qualquer afiliação com CiviCRM. Os nomes dos produtos são marcas comerciais dos respetivos titulares.