Skip to main content
Se você usa o Claude Code ou o Cowork, o plugin da Chargefy é o jeito mais rápido de começar. Com dois comandos, o assistente passa a saber como a Chargefy funciona, ganha um revisor que pega os erros mais comuns de integração e já fica conectado ao MCP, que é a ponte para os dados da sua conta.
Depois de instalar, é só pedir:
Configure a chave de teste da Chargefy neste projeto e faça uma chamada de exemplo.
Crie um endpoint de webhook para confirmar pagamentos.
Revise minha integração com a Chargefy antes de eu subir para produção.
No Codex e no Cursor, instale as skills da Chargefy e conecte o MCP diretamente. O plugin com revisor é específico do Claude Code e do Cowork. No Claude para desktop e no ChatGPT, siga o guia do MCP.

​
O que o plugin faz

Três coisas:
  1. Ensina o assistente a integrar a Chargefy. Ele carrega instruções prontas, chamadas skills, sobre pagamentos, billing e plataformas, além das trilhas de chaves, checkout, webhooks, convenções da API e testes no sandbox. Elas entram sozinhas quando o assunto aparece na conversa.
  2. Revisa o código antes de subir. Um revisor procura os erros que passam despercebidos na revisão humana e só aparecem em produção, como um webhook que não verifica a assinatura.
  3. Protege a sua chave secreta. Se uma chave de produção for parar em um arquivo que vai para o Git, o assistente avisa na hora.
E o MCP já vem configurado: você não precisa adicionar o servidor à mão.

​
As skills

O plugin inclui as mesmas quatro skills distribuídas para Codex, Cursor e outros agentes. Revisor, proteção de credenciais e configuração do MCP são extras do plugin. Veja as quatro skills e exemplos de uso. Você não precisa chamar uma skill pelo nome: basta descrever o que quer. Se preferir, elas também funcionam como comando, por exemplo /chargefy:chargefy-payments.
A tabela de cartões de teste da skill chargefy-payments é gerada a partir do mesmo código que decide o resultado de cada cartão no sandbox. Quando a Chargefy adiciona um cartão novo, ele aparece no plugin sem ninguém precisar atualizar a documentação à mão.

​
Revisor de integração

Peça “revise essa integração com a Chargefy” e o revisor lê o código procurando os cinco erros que mais causam problema em produção:
  • Webhook sem verificar a assinatura, ou verificando um corpo que já passou por um parser e foi reserializado. Nos dois casos, qualquer pessoa consegue mandar um evento falso para o seu sistema.
  • Cobrança sem Idempotency-Key, ou com uma chave nova a cada tentativa. Um retry pode cobrar o cliente duas vezes.
  • Chave secreta em código que chega ao navegador. A chave vaza para quem abrir o código-fonte da página.
  • Redirecionamento tratado como pagamento confirmado. O comprador voltar para a página de sucesso não prova que pagou. Só o webhook prova.
  • Retry no erro 502 payment_result_unconfirmed. Esse erro significa “não sei se cobrou”. Repetir a chamada pode cobrar de novo.
O revisor só lê e reporta; ele não altera nenhum arquivo. Também dá para chamá-lo direto com @chargefy:integration-reviewer.

​
Proteção da chave secreta

Quando uma chave de produção (ch_live_...) é escrita em um arquivo que o Git versiona, o assistente recebe um aviso e corrige antes de seguir. O seu .env local, que o Git ignora, não gera aviso, porque é exatamente onde a chave deve ficar. A chave nunca é mostrada por inteiro.
Se uma chave secreta chegou a entrar em um commit, revogue-a em Developers → Chaves de API antes de qualquer outra coisa. Apagar o commit ou reescrever o histórico não desfaz a exposição.

​
Conexão com o MCP

O plugin já traz o servidor https://mcp.chargefy.io configurado. Para o assistente enxergar os dados da sua conta, falta só autorizar:
1

Abra o menu de MCP

No Claude Code, digite /mcp e selecione chargefy.
2

Autentique

Escolha Authenticate. O navegador abre a tela de login da Chargefy.
3

Escolha organização e ambiente

Selecione a organização e defina o acesso de teste e de produção. Comece por teste e somente leitura.
Se você já tinha adicionado o servidor manualmente, o Claude Code reconhece que é o mesmo endereço e não duplica nada. As skills e o revisor funcionam mesmo sem autorizar o MCP. A autorização só é necessária para consultar ou criar dados na sua conta.

​
Manter atualizado

1

Atualize o marketplace

claude plugin marketplace update chargefy busca a versão mais recente publicada.
2

Atualize o plugin

claude plugin update chargefy aplica a versão nova.
3

Remova quando quiser

claude plugin uninstall chargefy desinstala o plugin. A autorização do MCP continua válida até você revogá-la em Developers → Agentes.

​
Código aberto

O plugin tem licença MIT e vive em chargefy-io/claude-plugin. O conteúdo é gerado a partir do código que roda em produção. Encontrou um erro? Abra uma issue no repositório ou fale com o suporte.

​
Continue

MCP da Chargefy

Conecte outros assistentes ao mesmo servidor.

Acesso e permissões

Organização, ambientes, leitura, escrita e revogação.

Tools e operações

O que o assistente consegue executar em cada conexão.

Sandbox

Cartões e cenários determinísticos de teste.