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ço https://mcp.pearfy.com.br

Endereç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.

Não confunda com 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

  1. 1
    Adicione o endereço na sua IA
    Cada IA tem o seu menu para isso. O caminho de cada uma está logo abaixo, em Passo a passo por IA.
  2. 2
    Entre com a sua conta Pearfy
    A 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.
  3. 3
    Pergunte
    “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

  1. Abra Plugins no ChatGPT web e clique em + › Add custom MCP server.
  2. Use o nome Pearfy e cole o endereço da Pearfy em Server URL.
  3. Escolha OAuth, confirme o aviso e clique em Create as a plugin.
  4. Instale o plugin, entre com sua conta Pearfy e escolha o que a IA pode ver.
  5. 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

  1. Rode o comando abaixo no terminal.
  2. Abra o Claude Code, digite /mcp e escolha Pearfy (ou rode claude mcp login pearfy).
  3. Entre com sua conta Pearfy no navegador que abrir.
No terminal
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

  1. Clique no + da entrada Tool do nó AI Agent e adicione MCP Client Tool.
  2. Cole o endereço da Pearfy em Endpoint e mantenha Server Transport em HTTP Streamable.
  3. Escolha Bearer Auth em Authentication e crie a credencial Pearfy.
  4. Cole a chave de IA em Bearer Token.
Valores para colar
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.

  1. 1
    Entre na Pearfy
    Com o seu e-mail e senha. Num aparelho novo, a Pearfy confirma pelo seu e-mail.
  2. 2
    Escolha a conta e o acesso
    A 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.
  3. 3
    Permita o acesso
    Clique 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.
QuandoO que a tela pede a mais
App verificado, só consultarNada: é um clique.
Consultar e alterarUm código de 6 dígitos enviado ao seu e-mail e login feito há menos de 15 minutos.
App não verificadoCó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.
O login conecta uma conta Pearfy que já existe. Ainda não tem conta? Crie em app.pearfy.com.br antes de conectar.

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.

JeitoComo funcionaQuando usar
Login da PearfyA 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 IAVocê 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 Code
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

RegraDetalhe
Onde criarIntegrações › Pearfy MCP › Chaves de IA. Quem cria precisa da permissão Apps na Equipe.
PermissõesVocê escolhe uma a uma, só entre as que a sua permissão na Equipe libera.
Validade30, 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 posseCriar pede um código no seu e-mail (ou a senha, se a chave for só de consulta).
IPs permitidosOpcional: até 20 endereços ou faixas (CIDR). Chamada de outro IP é recusada.
ColaboradoresChave com alteração criada por colaborador só vale depois que o dono aprova.
ExibiçãoA chave aparece uma única vez, na criação. Depois, só a máscara pfy_mcp_XXXX…wxyz.
Dinheiro e cuponsReembolso, cancelamento e criação de cupom vindos de chave vão sempre para aprovação no painel.
QuantidadeAté 10 chaves ativas por pessoa e 50 por conta.
Trate a chave de IA como senha: não compartilhe nem coloque em repositório. E não use a chave da API REST (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.

EscopoO que liberaTipo
vendas:lerConsultar vendasConsulta
financeiro:lerConsultar saldo e saquesConsulta
assinaturas:lerConsultar assinaturasConsulta
produtos:lerConsultar produtos, ofertas e cuponsConsulta
webhooks:lerConsultar webhooksConsulta
alunos:lerConsultar alunosConsulta
produtos:escreverCriar e editar produtos e ofertasAlteração
cupons:escreverCriar e editar cuponsAlteração
reembolsosReembolsar vendasAlteração, dinheiro
assinaturas:cancelarCancelar assinaturasAlteração, dinheiro
alunos:escreverReenviar acesso de alunosAlteração
webhooks:escreverCriar e remover webhooksAlteraçã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.