PipeRun CRM / Integrações do sistema

Como conectar o MCP do PipeRun ao Claude, ChatGPT e Gemini

Atualizado em 23 de set. de 2026 · 40 visualizacoes

O MCP (Model Context Protocol) é um padrão que permite que assistentes de inteligência artificial acessem sistemas externos de forma segura e controlada. Com o servidor MCP oficial do CRM de Vendas PipeRun conectado, você consegue consultar, criar, atualizar e remover registros diretamente no seu CRM apenas conversando com a IA em linguagem natural, sem precisar navegar por menus ou abrir relatórios manualmente.

Neste artigo, você aprenderá como conectar o CRM de Vendas PipeRun ao Claude (versão web e desktop), ao Claude Code (terminal), ao ChatGPT e ao Gemini CLI, utilizando o servidor MCP oficial. Cada plataforma tem seu próprio fluxo de configuração, e todos os passos estão detalhados nas seções abaixo.

Aviso: A conexão respeita as permissões do seu usuário no CRM de Vendas PipeRun, portanto, o que você não enxerga no sistema, a IA também não enxerga.

Atenção: Em contas Claude Team e Enterprise, e em contas ChatGPT Business e Enterprise, a liberação do conector depende do administrador da organização. Verifique com o responsável técnico da sua conta antes de iniciar a configuração.

TÓPICOS DO ARTIGO

  1. Requisitos

  2. Conectar no Claude (web e desktop)

  3. Conectar no Claude Code (terminal)

  4. Conectar no ChatGPT

  5. Conectar no Gemini CLI

  6. O que você pode pedir à IA

  7. Segurança e limitações

  8. Perguntas Frequentes

REQUISITOS

  • Conta ativa no CRM de Vendas PipeRun;

  • Usuário ativo no CRM de Vendas PipeRun para realizar a autorização OAuth;

  • Para o Claude (web e desktop): conta no Claude nos planos Free, Pro ou Max. Em contas Team e Enterprise, o proprietário da organização adiciona o conector e cada pessoa faz a própria autorização;

  • Para o Claude Code (terminal): Claude Code instalado e autenticado na sua máquina;

  • Para o ChatGPT: conta nos planos Plus, Pro, Business, Enterprise ou Edu, acessada pelo navegador (chatgpt.com). Em contas Business e Enterprise, o administrador precisa liberar o modo desenvolvedor antes;

  • Para o Gemini CLI (terminal): Gemini CLI instalado e autenticado na sua máquina.

CONECTAR NO CLAUDE (WEB E DESKTOP)

O conector fica vinculado à sua conta Claude e é configurado uma única vez pelo navegador. Após a configuração, ele passa a funcionar também no aplicativo para desktop e no celular, sem nenhuma etapa adicional.

PASSO 1 - ADICIONAR O CONECTOR PERSONALIZADO

  1. Acesse claude.ai e abra "Configurações". Navegue até Personalizar → Conectores. Se preferir, acesse diretamente pelo endereço claude.ai/settings/connectors.

    Tela Personalizar > Conectores do Claude mostrando 'Claude for legal' com ícones de integrações e lista de conectores mais usados como Google Drive, Gmail e Notion

  2. Clique em "Adicionar" e escolha "Adicionar conector personalizado". Se o Claude solicitar o tipo de conector, selecione "Web".

    Tela Personalizar com abas Habilidades, Conectores e Plugins, botão Adicionar destacado e tooltip mostrando opção Adicionar conector personalizado

  3. Preencha os dois campos exibidos na tela:

  4. Clique em "Continuar".

    Diálogo para adicionar conector personalizado Piperun MCP com campo de URL e botões Cancelar e Continuar

  5. O Claude verifica o endereço e preenche automaticamente as configurações de autenticação. Os itens marcados como "Detectado" estão corretos e não precisam ser alterados. Clique em "Adicionar".

    Diálogo de configuração do conector Piperun MCP com opções de autenticação OAuth detectadas e botão Adicionar

Dica: Se a sua tela exibir nome, URL e configurações avançadas em uma única etapa, a sua conta ainda apresenta a versão anterior do fluxo. O procedimento é o mesmo: preencha o nome e a URL e clique em "Adicionar".

PASSO 2 - AUTORIZAR O ACESSO E VINCULAR

  1. Após adicionar o conector, você será redirecionado para uma nova tela. Clique em "Vincular" para iniciar a autorização.

    Tela de autorização Piperun MCP com mensagem de conexão iniciada e botão Vincular para completar o fluxo

  2. Você será redirecionado para a tela de login do CRM de Vendas PipeRun. Na tela "Autorizar acesso", confira se o usuário exibido é o correto e clique em "Autorizar".

    Tela de autorização de acesso do PipeRun solicitando permissão para conectar aplicativo à conta do CRM

Aviso: Se você não concluir o vínculo logo após adicionar o MCP, retorne em Configurações → Personalizar → Conectores, localize o PipeRun MCP e clique em "Vincular" para finalizar o processo.

PASSO 3 - USAR NAS CONVERSAS

  1. Dentro de qualquer conversa no Claude, clique no botão "+" e abra "Conectores".

    Menu de conectores do Claude com opções para adicionar conector, gerenciar conectores e acessar ferramentas

  2. Ative o PipeRun MCP para ligar o conector naquele chat. Com ele ativo, escreva o que você precisa em linguagem natural e a IA consultará os dados do seu CRM de Vendas PipeRun.

    Menu de conectores do Claude em Cowork mostrando Piperun MCP ativado com toggle azul

O conector aparece como conectado na tela de configurações assim que o vínculo é concluído com sucesso. Confirme o status antes de iniciar as conversas.

CONECTAR NO CLAUDE CODE (TERMINAL)

Se você utiliza o Claude Code no terminal, a conexão com o CRM de Vendas PipeRun é feita por linha de comando. O fluxo é dividido em três etapas: registro do servidor, autenticação e verificação da conexão.

PASSO 1 - REGISTRAR O SERVIDOR

  1. No terminal (fora de uma sessão do Claude Code), execute o seguinte comando:

    claude mcp add --scope user --transport http PipeRun-MCP https://api.pipe.run/v1/mcp

    Veja o que cada parte do comando faz:

    • --scope user: registra o servidor para todos os seus projetos. Sem esse parâmetro, o MCP fica disponível somente na pasta onde o comando foi executado;

    • --transport http: indica que o servidor é acessado por uma URL, e não por um programa local;

    • PipeRun-MCP: nome que aparece na lista de servidores. Você pode escolher outro nome, se preferir.

Terminal mostrando configuração do servidor MCP PipeRun adicionado ao escopo user com autenticação OAuth pendente

PASSO 2 - AUTENTICAR

  1. Abra o Claude Code com o comando claude.

  2. Dentro da sessão, digite /mcp.

  3. Selecione o PipeRun-MCP na lista e pressione Enter.

Painel Gerenciar Servidores MCP com 33 servidores listados, mostrando PipeRun-MCP com status de falha no arquivo claude.json

  1. Escolha a opção "Authenticate". O navegador abrirá na tela de autorização do CRM de Vendas PipeRun.

    Tela PipeRun-MCP MCP Server com status de falha e autenticação não realizada, exibindo opções para Autenticar, Reconectar ou Desabilitar

  2. Clique em "Autorizar". Ao ver a mensagem "Authentication successful", feche a aba e volte ao terminal.

    Tela de autorização de acesso do PipeRun solicitando permissão para conectar aplicativo à conta

PASSO 3 - CONFERIR A CONEXÃO

  1. Dentro da sessão do Claude Code, digite /mcp novamente. O status do PipeRun-MCP deve aparecer como conectado.

  2. Alternativamente, execute claude mcp list no terminal para visualizar o status de todos os servidores registrados.

    Terminal PipeRun-MCP mostrando autenticação bem-sucedida e modo automático ativo com instrução de ciclo por shift+tab

CONECTAR NO CHATGPT

No ChatGPT, servidores MCP personalizados são adicionados pelo modo desenvolvedor, disponível somente na versão web pelo endereço chatgpt.com. Antes de criar o conector, é necessário ativar esse modo nas configurações da sua conta. O recurso não está disponível nos aplicativos para celular.

PASSO 1 - ATIVAR O MODO DESENVOLVEDOR

  1. Acesse chatgpt.com e abra "Configurações".

  2. Navegue até Segurança e login (Security and login).

  3. Ative a opção "Modo desenvolvedor" (Developer mode).

    Painel Segurança e login do Chrome mostrando Modo desenvolvedor ativado com aviso de risco elevado

Aviso: O ChatGPT classifica o modo desenvolvedor como de risco elevado, pois ele permite adicionar conectores não verificados pela OpenAI. Conecte apenas servidores de fornecedores em quem você confia. O MCP do CRM de Vendas PipeRun é oficial e mantido pela PipeRun.

PASSO 2 - CRIAR O CONECTOR

  1. No menu lateral, abra "Plugins".

  2. Clique no botão "+", no canto superior direito, e clique em "Create app" para criar um novo plugin.

    Tela de Plugins do ChatGPT com botão Create app destacado no canto superior direito para criar novo plugin

  3. Na caixa que abrirá, clique no botão "Criar aplicativo MCP".

Diálogo de novo plugin MCP com opções para criar aplicativo, cancelar ou adicionar plugin ao sistema

  1. Preencha os campos exibidos na tela:

  • Nome (Name): Piperun MCP;

  • Descrição (Description): CRM de Vendas PipeRun -- oportunidades, pessoas, empresas e atividades (opcional);

  • Conexão (Connection): mantenha a opção URL do servidor (Server URL) selecionada;

  • URL do servidor (Server URL): https://api.pipe.run/v1/mcp;

  • Autenticação (Authentication): OAuth.

  • Marque a caixa "Entendi e quero continuar" (I understand and want to continue).

  1. Clique em "Criar" (Create).

    Formulário de novo plugin com campos para nome (Piperun MCP), descrição, URL do servidor e autenticação OAuth

PASSO 3 - AUTORIZAR E USAR

  1. O ChatGPT fará a leitura das ferramentas do servidor e abrirá a tela de autorização do CRM de Vendas PipeRun. Faça login, se necessário, e clique em "Autorizar".

    Tela de autorização de acesso do PipeRun mostrando permissões de consulta e operação de dados do CRM, com botões Cancelar e Autorizar

  2. Nas conversas, o PipeRun MCP aparecerá entre as ferramentas disponíveis no campo de mensagem. Para ligar ou desligar ferramentas específicas, acesse Configurações → Plugins.

CONECTAR NO GEMINI CLI

No Gemini, a conexão com o CRM de Vendas PipeRun é feita exclusivamente pelo Gemini CLI, a ferramenta de linha de comando do Google. O app web do Gemini (gemini.google.com) ainda não disponibiliza o recurso de aplicativos personalizados fora dos Estados Unidos, portanto, o Gemini CLI é o único caminho disponível para usuários no Brasil no momento.

Aviso: O app web do Gemini permite adicionar servidores MCP em Configurações → Aplicativos conectados → Aplicativos personalizados → Adicionar aplicativo personalizado, mas o recurso ainda tem restrições que impedem o uso no Brasil: está disponível somente para usuários nos Estados Unidos, maiores de 18 anos, em contas pessoais do Google (contas Workspace não funcionam) e somente em inglês. Assim que o Google liberar o recurso para o Brasil, este artigo será atualizado.

PASSO 1 - REGISTRAR O SERVIDOR

  1. No terminal, execute o seguinte comando:

    gemini mcp add --transport http --scope user PipeRun-MCP https://api.pipe.run/v1/mcp

    O parâmetro --scope user grava a configuração em ~/.gemini/settings.json e deixa o MCP disponível em todos os seus projetos. Se preferir limitar a um projeto específico, substitua por --scope project.

PASSO 2 - AUTENTICAR

  1. Abra o Gemini CLI com o comando gemini.

  2. Digite /mcp auth PipeRun-MCP.

  3. O navegador abrirá na tela de autorização do CRM de Vendas PipeRun. Faça login, se necessário, e clique em "Autorizar". O token fica salvo na sua máquina e é renovado automaticamente.

PASSO 3 - CONFERIR A CONEXÃO

  1. Digite /mcp list para ver o status do servidor e as ferramentas disponíveis.

Aviso: A autorização exige um navegador na mesma máquina onde o Gemini CLI está sendo executado. Em servidores sem interface gráfica (acesso por SSH, por exemplo), o fluxo de login não é concluído.

O QUE VOCÊ PODE PEDIR À IA

Com o MCP conectado, a IA acessa as principais entidades do CRM de Vendas PipeRun e pode realizar operações completas de leitura e escrita. Isso significa que você pode tanto consultar dados existentes quanto criar novos registros, atualizar informações e remover itens, tudo em linguagem natural, sem navegar pelo sistema.

As entidades disponíveis para interação são:

  • Oportunidades: listar, criar, atualizar e excluir;

  • Pessoas: listar, criar, atualizar e excluir;

  • Empresas: listar, criar, atualizar e excluir;

  • Atividades: listar, criar, atualizar e excluir;

  • Dados de apoio: funis e etapas, usuários, tags, origens, segmentos, motivos de perda, tipos de atividade, atendimentos, ações automáticas, cidades e CNAEs.

Dica: Para obter respostas mais precisas, cite os nomes de funil, etapa e usuário responsável exatamente como estão cadastrados no CRM de Vendas PipeRun. Ao agendar atividades, informe o horário e, se necessário, o fuso horário. Você também pode especificar o formato de saída desejado, como "monte uma tabela", "resuma em três linhas" ou "gere um texto para enviar ao cliente".

Veja alguns exemplos de pedidos que você pode fazer:

CONSULTAS E ANÁLISES

  • "Liste as oportunidades em aberto do funil Comercial com valor acima de R$ 10.000."

  • "Quais oportunidades estão paradas na etapa de Proposta há mais de 15 dias?"

  • "Resuma as oportunidades perdidas nos últimos 30 dias agrupadas por motivo de perda."

  • "Quais atividades tenho agendadas para amanhã?"

CADASTROS E ATUALIZAÇÕES

  • "Cadastre a pessoa João Silva, e-mail [email protected], telefone (11) 90000-0000."

  • "Crie uma oportunidade de R$ 8.000 para a Acme no funil Comercial, etapa Qualificação."

  • "Agende uma ligação de follow-up com a Maria para sexta-feira às 15h."

  • "Atualize o valor da oportunidade da Acme para R$ 12.000."

SEGURANÇA E LIMITAÇÕES

A conexão entre os assistentes de IA e o CRM de Vendas PipeRun é realizada por OAuth: você autoriza o acesso com o seu login do PipeRun, sem informar senha ou token ao assistente. A IA opera sempre em seu nome, dentro das permissões do seu usuário no CRM. Registros que você não tem acesso no sistema também não estarão visíveis para a IA.

Como o MCP pode criar, alterar e remover registros, leia com atenção a confirmação antes de aprovar qualquer ação que modifique dados. Revise o resultado no CRM de Vendas PipeRun após cada operação de escrita. Evite marcar opções do tipo "permitir sempre" para ferramentas de exclusão, pois ações irreversíveis realizadas pela IA seguem as mesmas regras que ações feitas manualmente no sistema.

Para revogar o acesso em qualquer plataforma, siga os passos abaixo:

  • Claude (web e desktop): acesse Configurações → Personalizar → Conectores, abra o PipeRun MCP e clique em "Desvincular" ou remova o conector;

  • Claude Code: execute claude mcp remove PipeRun-MCP no terminal;

  • ChatGPT: remova o plugin em Configurações → Plugins;

  • Gemini CLI: execute gemini mcp remove PipeRun-MCP no terminal.

As limitações atuais da integração são as seguintes: no ChatGPT, o modo desenvolvedor funciona apenas no navegador, não estando disponível nos aplicativos para celular; no Gemini, a conexão só é possível pelo Gemini CLI, pois o app web ainda não libera aplicativos personalizados fora dos Estados Unidos; em contas Claude Team e Enterprise, e em contas ChatGPT Business e Enterprise, a liberação depende do administrador da organização; cada usuário realiza a própria autorização, e conectar o MCP não amplia o acesso aos dados de colegas além do que as suas permissões já permitem.

PERGUNTAS FREQUENTES

1. "O MCP do PipeRun funciona em qualquer plano do Claude?"

R: Funciona nos planos Free, Pro e Max. Em contas Team e Enterprise, o proprietário da organização precisa adicionar o conector primeiro; depois, cada membro faz a própria autorização de acesso.

2. "Posso usar o MCP do PipeRun pelo aplicativo do ChatGPT no celular?"

R: Não. O modo desenvolvedor do ChatGPT, necessário para adicionar servidores MCP personalizados, está disponível somente na versão web pelo navegador (chatgpt.com). Os aplicativos para celular não oferecem esse recurso no momento.

3. "A IA tem acesso a todos os dados da minha conta PipeRun?"

R: Não. O MCP respeita integralmente as permissões do seu usuário no CRM de Vendas PipeRun. Registros que você não enxerga no sistema também não ficam visíveis para a IA. Conectar o MCP não amplia o seu nível de acesso.

4. "O conector não autenticou e as ferramentas do PipeRun não aparecem nas conversas. O que faço?"

R: Confira se a URL do servidor está exatamente como https://api.pipe.run/v1/mcp e refaça a autorização seguindo os passos da seção correspondente ao seu assistente. Se o problema persistir, entre em contato com a equipe de suporte do PipeRun.

5. "Posso usar o app web do Gemini para conectar o MCP do PipeRun?"

R: Ainda não. O app web do Gemini (gemini.google.com) permite adicionar aplicativos personalizados, mas o recurso está disponível somente para usuários nos Estados Unidos, em contas pessoais do Google e somente em inglês. Por enquanto, utilize o Gemini CLI para realizar a conexão.

Pronto! Agora você sabe como conectar o CRM de Vendas PipeRun ao Claude, ao ChatGPT e ao Gemini usando o servidor MCP oficial, e pode interagir com os seus dados em linguagem natural diretamente nos assistentes de IA.

Em caso de dúvidas, chame nossa equipe no chat. 😉