š¤ Ā Para quem pode criar automaƧƵes no pipe
š Ā Planos pagos, e depende de liberaĆ§Ć£o por organizaĆ§Ć£o; veja a primeira seĆ§Ć£o
šÆ Ā Para quem quer que os AI Agents do Pipefy alcancem ferramentas externas durante a execuĆ§Ć£o do processo
Ā
Ā
Quando um AI Agent no Pipefy precisa buscar dados em uma planilha, consultar um registro no CRM ou avisar alguĆ©m em uma ferramenta de mensageria durante a execuĆ§Ć£o do processo, ele usa o MCP Client. Ć a ponte entre o agente e as ferramentas externas que jĆ” fazem parte da sua operaĆ§Ć£o.
Ao terminar este artigo, vocĆŖ vai saber configurar essa conexĆ£o no seu pipe, usĆ”-la em um behavior e acompanhar o que acontece em cada execuĆ§Ć£o.
Ā
š Ā O que vocĆŖ vai encontrar aqui:
Ā
Primeiro: confirme que a sua organizaĆ§Ć£o tem acesso
A camada de automaƧƵes avanƧadas que sustenta o MCP Client Ć© liberada por organizaĆ§Ć£o, nunca por pipe. Isso significa que a seĆ§Ć£o de configuraĆ§Ć£o aparece na interface somente se a organizaĆ§Ć£o tiver a funcionalidade habilitada.
Ā
Se vocĆŖ seguir os passos deste artigo e simplesmente nĆ£o encontrar a aba descrita, o motivo mais provĆ”vel nĆ£o Ć© erro seu: Ć© a organizaĆ§Ć£o nĆ£o ter a liberaĆ§Ć£o. Nesse caso, o caminho Ć© falar com quem administra a organizaĆ§Ć£o no Pipefy.
Ā
Onde procurar: a configuraĆ§Ć£o fica em uma aba chamada MCP, ao lado de Agentes de IA, Logs e Templates. No lanƧamento ela aparece com o selo Novo.
Ā
MCP Client e MCP Server: reforƧo rƔpido
Se vocĆŖ veio do primeiro artigo da sĆ©rie, jĆ” conhece essa distinĆ§Ć£o. Vale ter aqui como referĆŖncia antes de entrar na configuraĆ§Ć£o:
Ā
| Ā | MCP Server | MCP Client |
|---|---|---|
| DireĆ§Ć£o do fluxo | IA externa para Pipefy | Pipefy para ferramenta externa |
| O que faz | ExpƵe os processos do Pipefy para que um assistente de IA externo (Claude Code, Claude Desktop, Cursor, Codex) possa executƔ-los em linguagem natural | Permite que um AI Agent dentro do Pipefy acesse ferramentas externas (planilhas, CRM, mensageria) como parte de um behavior |
| Quem configura | O prĆ³prio usuĆ”rio conecta o assistente com a sua conta Pipefy, via OAuth. Para uso desassistido (scripts, CI/CD), um Super Admin provisiona uma Service Account em Admin > Service Accounts | Quem pode criar automaƧƵes no pipe autentica os apps e seleciona quais ferramentas o agente pode usar |
| Disponibilidade | Depende apenas da conta autenticada e da sua membership nos pipes | Liberada por organizaĆ§Ć£o |
Ā
Este artigo cobre o MCP Client. Para conectar um assistente de IA externo ao Pipefy, veja "Como configurar o Pipefy AI Toolkit no seu assistente de IA".
Ā
O que o MCP Client torna possĆvel
O MCP Client dĆ” ao AI Agent acesso a tools externas dentro do prĆ³prio behavior. O mecanismo Ć© direto: vocĆŖ conecta o pipe a um servidor MCP externo, informando a URL dele e uma credencial. As tools que aquele servidor expƵe passam a estar disponĆveis para os agentes daquele pipe, e o resultado de cada chamada fica registrado nos logs de execuĆ§Ć£o.
Ā
A interface usa a palavra tools, nĆ£o ferramentas. Este artigo acompanha o vocabulĆ”rio da tela quando se refere a elementos que o leitor vai ver.
Ā
Exemplos do que um AI Agent consegue fazer com o MCP Client configurado:
- Ler o histĆ³rico de um registro no CRM antes de tomar uma decisĆ£o no processo
- Atualizar uma planilha com dados gerados durante a execuĆ§Ć£o do card
- Enviar uma notificaĆ§Ć£o em uma ferramenta de mensageria quando um card chega em determinada fase
- Criar um registro em um sistema externo como parte de um fluxo de aprovaĆ§Ć£o
Ā
Existem dois caminhos para dar tools a um agente. O primeiro Ć© o catĆ”logo de apps jĆ” integrados ao Pipefy, que cobre ferramentas de produtividade, CRM e mensageria. O segundo Ć© conectar um servidor MCP externo pela URL, que Ć© o caminho para qualquer serviƧo que publique o prĆ³prio servidor MCP e nĆ£o esteja no catĆ”logo.
Ā
Este artigo detalha o segundo caminho, a conexĆ£o por URL, porque Ć© o que o MCP Client acrescenta. Se o serviƧo que vocĆŖ quer alcanƧar jĆ” estĆ” no catĆ”logo, o caminho Ć© mais curto e nĆ£o exige a URL de um servidor.
Ā
Por que a conexĆ£o Ć© configurada pipe por pipe
Cada pipe tem o seu prĆ³prio espaƧo de automaƧƵes avanƧadas. Os fluxos, as conexƵes e a disponibilidade de ferramentas sĆ£o escopados a esse espaƧo, portanto ao pipe.
Vale saber de onde essas conexƵes vĆŖm: elas nĆ£o sĆ£o um repositĆ³rio novo. SĆ£o as mesmas conexƵes que as automaƧƵes avanƧadas daquele pipe jĆ” usam. Se o seu pipe jĆ” tem uma conexĆ£o autenticada para uma planilha ou para o CRM, o agente alcanƧa aquela mesma conexĆ£o, sem autenticar de novo.
Existe uma nuance que explica o desenho: um fluxo pode orquestrar trabalho que atravessa vĆ”rios pipes, mas ele mora em, e Ć© visĆvel apenas a partir de, exatamente um pipe. Ć por isso que a configuraĆ§Ć£o acontece no pipe e nĆ£o na organizaĆ§Ć£o.
Ā
ConsequĆŖncia prĆ”tica: se o mesmo app precisa ser alcanƧado por agentes de trĆŖs pipes diferentes, a autenticaĆ§Ć£o Ć© feita nos trĆŖs. NĆ£o existe conexĆ£o compartilhada entre pipes.
Ā
Quem configura o quĆŖ
A configuraĆ§Ć£o tem dois nĆveis com responsabilidades distintas:
Ā
| Quem | O que configura | Onde |
|---|---|---|
| Quem administra a organizaĆ§Ć£o | Habilita a funcionalidade para a organizaĆ§Ć£o | ConfiguraƧƵes da organizaĆ§Ć£o |
| Quem pode criar automaƧƵes no pipe | Registra o servidor MCP externo, dĆ” um nome Ć conexĆ£o e define o mĆ©todo de autenticaĆ§Ć£o | Aba MCP, ao lado de Agentes de IA, Logs e Templates |
| Quem pode criar automaƧƵes no pipe | Adiciona a aĆ§Ć£o de ferramenta MCP nos behaviors dos AI Agents e mapeia entradas e saĆdas | Tela do AI Agent, na aba de behaviors |
Ā
O critĆ©rio aqui Ć© "poder criar automaƧƵes no pipe", e nĆ£o um cargo. Isso Ć© verificĆ”vel: se vocĆŖ consegue criar uma automaĆ§Ć£o nesse pipe, vocĆŖ consegue configurar a conexĆ£o MCP dele. Se nĆ£o consegue, Ć© essa a permissĆ£o que falta.
Ā
Passo 1: configurar a conexĆ£o no pipe
A conexĆ£o Ć© configurada no nĆvel do pipe, antes de qualquer agente. Ć aqui que os servidores MCP externos sĆ£o registrados e autenticados, tornando as tools deles disponĆveis para os agentes daquele pipe.
- Abra o pipe, vƔ atƩ a Ɣrea de Agentes de IA e clique na aba MCP.
- Clique em Adicionar conexƵes. Abre a janela Conectar ao servidor MCP.
- Em URL do servidor, informe o endereƧo do servidor MCP que vocĆŖ quer alcanƧar.
- Em Nome, dĆŖ um nome que identifique a conexĆ£o para quem for usĆ”-la depois.
- Em AutenticaĆ§Ć£o, escolha o mĆ©todo. SĆ£o trĆŖs: Sem autenticaĆ§Ć£o, Token de acesso / Chave da API, e CabeƧalhos personalizados. Se escolher token ou chave, cole a credencial no campo que aparece.
- Clique em Conectar.
Ā
Como escolher o mĆ©todo de autenticaĆ§Ć£o: Token de acesso / Chave da API atende a maioria dos casos, porque Ć© o que os servidores MCP normalmente pedem. CabeƧalhos personalizados serve para servidores que exigem cabeƧalhos prĆ³prios alĆ©m de um token. Sem autenticaĆ§Ć£o existe porque alguns servidores MCP sĆ£o pĆŗblicos e nĆ£o pedem credencial.
Ā
A opĆ§Ć£o Sem autenticaĆ§Ć£o Ć© justamente onde o aviso da tela pesa mais. Sem credencial, nĆ£o hĆ” nada limitando o alcance daquele servidor alĆ©m da confianƧa que vocĆŖ deposita nele. Vale reservĆ”-la para servidores pĆŗblicos de serviƧos que a sua empresa jĆ” reconhece.
Ā
A prĆ³pria tela avisa para conectar apenas a servidores MCP confiĆ”veis, e o alerta merece atenĆ§Ć£o. Um servidor MCP externo passa a expor tools que os seus agentes vĆ£o executar dentro do processo. Conecte sĆ³ serviƧos que a sua empresa jĆ” usa e reconhece.
Ā
Depois da autenticaĆ§Ć£o, as credenciais ficam mascaradas na interface. AlterĆ”-las exige habilidade de admin no pipe, entĆ£o quem apenas usa as ferramentas em um behavior nĆ£o consegue trocar a credencial por baixo.
Ā
A conexĆ£o Ć© escopada ao pipe: a janela diz que ela serve para que os agentes neste pipe possam usar as tools daquele servidor. Se o mesmo servidor precisa ser alcanƧado por agentes de trĆŖs pipes, a conexĆ£o Ć© criada nos trĆŖs.
Ā
Uma nuance de governanƧa que vale entender: o que o agente alcanƧa por aqui nĆ£o excede o que uma pessoa com permissĆ£o de automaĆ§Ć£o naquele pipe jĆ” consegue fazer manualmente na interface. SĆ£o superfĆcies diferentes sobre a mesma permissĆ£o, e o controle sobre o agente nĆ£o Ć© o controle sobre o administrador.
Ā
Passo 2: usar a ferramenta em um behavior
Com a conexĆ£o configurada no pipe, vocĆŖ pode usar essas ferramentas em qualquer behavior dos AI Agents daquele pipe.
- Abra o AI Agent do pipe e acesse a aba de behaviors.
- Selecione o behavior onde a ferramenta vai ser usada, ou crie um novo.
- Adicione a aĆ§Ć£o de ferramenta MCP dentro do behavior.
- Escolha o servidor MCP configurado no pipe e a ferramenta especĆfica.
- Mapeie as entradas, ou seja, quais campos do card alimentam a chamada, e as saĆdas, ou seja, onde o resultado Ć© armazenado.
- Salve e teste a execuĆ§Ć£o.
Ā
VocĆŖ pode testar a ferramenta na prĆ³pria tela de configuraĆ§Ć£o do behavior, antes de ativar o agente. Isso permite verificar o mapeamento de entradas e saĆdas sem precisar criar um card de teste.
Ā
Sobre consumo: cada chamada a uma ferramenta MCP conta como uma aĆ§Ć£o de agente, a mesma unidade que as outras aƧƵes do agente jĆ” usam. Vale considerar isso ao desenhar um behavior que chama vĆ”rias ferramentas em sequĆŖncia.
Ā
Como acompanhar as execuƧƵes
Cada execuĆ§Ć£o de uma aĆ§Ć£o MCP fica registrada nos logs do AI Agent. VocĆŖ vĆŖ qual ferramenta foi chamada, com quais entradas, o que ela retornou e quanto tempo levou.
Para acessar: abra o AI Agent, vĆ” atĆ© a seĆ§Ć£o de logs e selecione a execuĆ§Ć£o que quer inspecionar. Cada passo do behavior aparece detalhado, incluindo as chamadas Ć s ferramentas externas.
Ā
Quando a chamada falha
Mapear entradas e saĆdas de uma ferramenta externa Ć© exatamente onde as coisas quebram, e vale saber onde procurar. Um detalhe importante: as mensagens de erro de validaĆ§Ć£o vĆŖm literalmente do app externo, nĆ£o do Pipefy. Isso muda onde vocĆŖ vai buscar a soluĆ§Ć£o, porque a mensagem usa o vocabulĆ”rio daquele app.
Ā
| Sintoma | Onde olhar e o que costuma ser |
|---|---|
| A ferramenta recusa a chamada com mensagem sobre tipo de dado | Nos logs de execuĆ§Ć£o, na entrada mapeada. O app externo valida os argumentos contra o prĆ³prio esquema, entĆ£o um campo de texto do card enviado para um parĆ¢metro numĆ©rico Ć© recusado por ele, com o texto dele. |
| A chamada falha por autenticaĆ§Ć£o | Na conexĆ£o configurada no pipe. Credencial expirada ou revogada no app externo. Reautentique a conexĆ£o; o agente nĆ£o faz isso sozinho. |
| A ferramenta que funcionava nĆ£o aparece mais | Na conexĆ£o. O servidor MCP externo pode ter deixado de expor aquela tool, ou ela mudou de nome. Confira na documentaĆ§Ć£o do serviƧo e, se necessĆ”rio, ajuste a aĆ§Ć£o no behavior. |
| O behavior executa mas a saĆda nĆ£o chega ao card | No mapeamento de saĆda. A chamada pode ter funcionado e o resultado nĆ£o ter destino configurado no card. |
Ā
Antes de avanƧar, confirme que vocĆŖ:
āĀ Confirmou que a organizaĆ§Ć£o tem a funcionalidade liberada
āĀ Entende a diferenƧa entre MCP Server e MCP Client, e qual dos dois resolve o seu caso
āĀ Registrou o servidor MCP externo com URL, nome e mĆ©todo de autenticaĆ§Ć£o
āĀ Testou a chamada na tela do behavior antes de ativar o agente
āĀ Conferiu nos logs que a execuĆ§Ć£o ocorreu como esperado
Ā
PrĆ³ximo passo na sĆ©rie
Para comeƧar a operar o Pipefy pelo assistente, veja "Seus primeiros comandos: operando o Pipefy em linguagem natural".
