Pearfy MCP
Como conectar
Você não instala nada nem cola senha na IA. Adiciona o endereço do Pearfy MCP e entra com a sua conta Pearfy. Para automações e programas, use uma chave de IA.
Endereçohttps://mcp.pearfy.com.brEndereço
O servidor responde em https://mcp.pearfy.com.br e também em https://mcp.pearfy.com.br/mcp, para clientes que exigem um caminho. O transporte é Streamable HTTP, sem sessão: não há processo local nem pacote para instalar.
app.pearfy.com.br/apps/ia, a página do painel que explica o Pearfy MCP. O endereço acima é o do servidor, o que vai na sua IA.Em três passos
- 1Adicione o endereço na sua IACada IA tem o seu menu para isso. O caminho de cada uma está logo abaixo, em Passo a passo por IA.
- 2Entre com a sua conta PearfyA própria IA abre a tela da Pearfy. Você entra como sempre, escolhe a conta e o que a IA pode ver, e clica em Permitir acesso. Detalhes em O login da Pearfy.
- 3Pergunte“Quanto vendi hoje?”, “Quais assinaturas estão atrasadas?”, “Gere o link de checkout do Curso Pro”.
No painel, o mesmo passo a passo fica em Integrações › Pearfy MCP › Conectar.
Passo a passo por IA
Chat
- Abra Plugins no ChatGPT web e clique em + › Add custom MCP server.
- Use o nome Pearfy e cole o endereço da Pearfy em Server URL.
- Escolha OAuth, confirme o aviso e clique em Create as a plugin.
- Instale o plugin, entre com sua conta Pearfy e escolha o que a IA pode ver.
- Numa conversa nova, digite @ e escolha Pearfy.
Forma de conectar: login Pearfy
Disponível conforme o plano do ChatGPT.
Em Business, Enterprise e Edu, o administrador pode precisar liberar.
Código
- Rode o comando abaixo no terminal.
- Abra o Claude Code, digite /mcp e escolha Pearfy (ou rode claude mcp login pearfy).
- Entre com sua conta Pearfy no navegador que abrir.
claude mcp add --transport http pearfy https://mcp.pearfy.com.br
Forma de conectar: login Pearfy ou chave de IA
Use --scope user para ter a Pearfy em todos os projetos; o padrão é só o projeto atual.
Com chave, não use --scope project: ela iria para o .mcp.json do repositório.
Automações e APIs
- Clique no + da entrada Tool do nó AI Agent e adicione MCP Client Tool.
- Cole o endereço da Pearfy em Endpoint e mantenha Server Transport em HTTP Streamable.
- Escolha Bearer Auth em Authentication e crie a credencial Pearfy.
- Cole a chave de IA em Bearer Token.
Endereço: https://mcp.pearfy.com.br Autenticação: Bearer Chave: crie uma chave de IA em Pearfy MCP › Chaves de IA
Forma de conectar: chave de IA
Use uma versão recente do n8n: as antigas mostram só SSE Endpoint.
O MCP Client Tool só funciona ligado a um nó AI Agent.
Os nomes de menu são os de cada IA e podem mudar com o tempo. O que não muda: o endereço https://mcp.pearfy.com.br e a autenticação pelo login da Pearfy (OAuth) ou por chave de IA.
O login da Pearfy
Ao conectar, a IA abre a tela da Pearfy em app.pearfy.com.br. É o mesmo login do painel, com a mesma verificação. Algumas IAs abrem a tela na hora; outras, na primeira pergunta que precisa da sua conta.
- 1Entre na PearfyCom o seu e-mail e senha. Num aparelho novo, a Pearfy confirma pelo seu e-mail.
- 2Escolha a conta e o acessoA tela mostra qual IA está pedindo acesso, com o selo Verificado quando a Pearfy reconhece o app. Você escolhe a conta (a sua ou uma que opera pela Equipe) e o nível: Só consultar, que vem marcado, ou Consultar e alterar. As permissões de dinheiro (reembolsar e cancelar) nunca vêm marcadas.
- 3Permita o acessoClique em Permitir acesso e você volta para a IA. Você recebe um e-mail avisando que uma IA foi conectada, e o dono da conta também recebe um aviso no celular.
| Quando | O que a tela pede a mais |
|---|---|
| App verificado, só consultar | Nada: é um clique. |
| Consultar e alterar | Um código de 6 dígitos enviado ao seu e-mail e login feito há menos de 15 minutos. |
| App não verificado | Código por e-mail e login recente. Ele só pode consultar, nunca alterar. |
| App no seu computador (sem identidade) | Login recente, sempre. A tela avisa: continue só se você acabou de abri-lo. |
Depois de conectar
- A IA guarda o acesso e o renova sozinha. Cada acesso vale 60 minutos e é renovado em segundo plano; a conexão cai depois de 30 dias sem uso e dura no máximo 90 dias. Depois disso, você entra de novo.
- Se você escolheu Só consultar e pede uma alteração, a Pearfy avisa a IA que falta permissão, e as IAs que suportam isso reabrem a tela. Se a sua não reabrir, desconecte e conecte de novo escolhendo Consultar e alterar.
- Trocar a senha da Pearfy desconecta todos os logins de IA do usuário e revoga as chaves dele com permissão de alteração e as criadas nos últimos 7 dias.
Chave de IA
O login é o caminho de quem conversa com a IA. A chave de IA serve para automações (n8n, Make, Zapier), para as APIs da OpenAI, Anthropic e xAI, e para clientes que não abrem tela de login.
| Jeito | Como funciona | Quando usar |
|---|---|---|
| Login da Pearfy | A IA abre a tela da Pearfy (OAuth 2.1 com PKCE) e guarda o acesso. | ChatGPT, Claude, Grok, Claude Code, Codex, Cursor, VS Code e outras IAs com login. |
| Chave de IA | Você cria a chave no painel e coloca na configuração do cliente. | Automações, APIs de IA e clientes sem login. |
A chave vai no cabeçalho de autorização de toda chamada:
Authorization: Bearer pfy_mcp_…
claude mcp add --transport http pearfy https://mcp.pearfy.com.br \ --header "Authorization: Bearer $PEARFY_MCP_KEY"
Os exemplos usam a variável PEARFY_MCP_KEY: a chave fica fora do arquivo de configuração, para não ir parar num repositório ou num print. Cliente que só aceita usuário e senha: use Authorization: Basic com a chave como senha.
Regras da chave
| Regra | Detalhe |
|---|---|
| Onde criar | Integrações › Pearfy MCP › Chaves de IA. Quem cria precisa da permissão Apps na Equipe. |
| Permissões | Você escolhe uma a uma, só entre as que a sua permissão na Equipe libera. |
| Validade | 30, 90, 180 ou 365 dias. Com permissão de alteração, no máximo 90. Você recebe um e-mail 7 dias antes de vencer. |
| Prova de posse | Criar pede um código no seu e-mail (ou a senha, se a chave for só de consulta). |
| IPs permitidos | Opcional: até 20 endereços ou faixas (CIDR). Chamada de outro IP é recusada. |
| Colaboradores | Chave com alteração criada por colaborador só vale depois que o dono aprova. |
| Exibição | A chave aparece uma única vez, na criação. Depois, só a máscara pfy_mcp_XXXX…wxyz. |
| Dinheiro e cupons | Reembolso, cancelamento e criação de cupom vindos de chave vão sempre para aprovação no painel. |
| Quantidade | Até 10 chaves ativas por pessoa e 50 por conta. |
pk_live_…) no MCP: o servidor recusa, porque ela dá acesso total à integração, sem as travas que a chave de IA tem.Permissões (escopos)
Cada conexão e cada chave tem uma lista de permissões. A IA só usa uma ferramenta se tiver a permissão dela e se a sua permissão na Equipe também liberar aquela área.
| Escopo | O que libera | Tipo |
|---|---|---|
| vendas:ler | Consultar vendas | Consulta |
| financeiro:ler | Consultar saldo e saques | Consulta |
| assinaturas:ler | Consultar assinaturas | Consulta |
| produtos:ler | Consultar produtos, ofertas e cupons | Consulta |
| webhooks:ler | Consultar webhooks | Consulta |
| alunos:ler | Consultar alunos | Consulta |
| produtos:escrever | Criar e editar produtos e ofertas | Alteração |
| cupons:escrever | Criar e editar cupons | Alteração |
| reembolsos | Reembolsar vendas | Alteração, dinheiro |
| assinaturas:cancelar | Cancelar assinaturas | Alteração, dinheiro |
| alunos:escrever | Reenviar acesso de alunos | Alteração |
| webhooks:escrever | Criar e remover webhooks | Alteração |
Desconectar
Em Integrações › Pearfy MCP › Conexões você vê cada IA e cada chave, com o último uso e a validade, e desconecta ou revoga com um clique. Vale na chamada seguinte da IA. O dono da conta e quem tem a permissão Apps podem desconectar as conexões de toda a Equipe.