Skip to main content
O MCP é um padrão aberto que permite a um assistente de IA usar ferramentas de outros sistemas. Com o MCP da Chargefy, você conecta o assistente que já usa (Claude, ChatGPT, Cursor, Codex e outros) à sua conta e conversa com ele como conversaria com alguém da equipe:
Quantos clientes novos entraram este mês no ambiente de teste?
Encontre a fatura número 1042 e me diga por que ela ainda está em aberto.
Crie um link de pagamento de R$ 99,90 para o plano Essencial, em teste.
O assistente transforma cada pedido em chamadas à Chargefy, com as mesmas regras e os mesmos dados da API pública. O endereço do servidor é um só:
O assistente nunca ganha mais acesso do que a pessoa que o conectou. Ele fica limitado a uma organização, aos ambientes que você autorizar (teste ou produção) e ao nível escolhido (só leitura ou leitura e escrita). Essa autorização é conferida de novo a cada pedido.

​
O que o assistente consegue fazer

Com acesso de leitura, ele pode:
  • listar e consultar clientes, produtos, preços, faturas, cobranças, assinaturas, transações, reembolsos, disputas, eventos e outros recursos, 16 tipos no total;
  • procurar por texto: “o cliente da Maria”, “o produto Essencial”, “a fatura 1042”;
  • carregar vários objetos de uma vez pelos IDs, por exemplo para montar a linha do tempo de um pagamento;
  • pesquisar esta documentação;
  • montar um plano de integração passo a passo, sem executar nada.
Com acesso de escrita, ele também cria e edita clientes, produtos, preços, descontos, códigos de desconto e links de pagamento.
Nada que mexa com dinheiro passa pelo MCP: capturar ou cancelar um pagamento, reembolsar, cancelar uma assinatura, resolver uma disputa, gerenciar chaves, webhooks ou membros da equipe. Para isso, continue usando a API pública no seu backend, com os controles que você definir.

​
Antes de conectar

Você precisa de:
  • uma conta Chargefy com acesso à organização que vai conectar;
  • um assistente com suporte a servidores MCP remotos. Claude, ChatGPT, Cursor e Codex suportam;
  • o MCP habilitado no ambiente desejado, em Developers → Agentes. O ambiente de teste já vem habilitado; o de produção fica desligado até um administrador liberar.
Para desenvolver com Claude Code, Codex ou Cursor, comece pelo guia Codar com agentes de IA: ele reúne a instalação das skills e a conexão do MCP. Se você já instalou o plugin do Claude Code, o servidor vem configurado; basta autorizar a conta.

​
Conectar com a sua conta

Este é o caminho normal para quem vai conversar com o assistente. Você adiciona o servidor, o navegador abre a tela de login da Chargefy e você escolhe o que o assistente pode acessar. Tecnicamente, é um login OAuth.
Adicione o servidor remoto:
Digite /mcp, selecione chargefy e escolha Authenticate. Depois do login, selecione uma organização e defina o acesso de cada ambiente.

​
A tela de autorização

1

Escolha uma organização

Cada conexão vale para uma organização só. Se você participa de várias, escolha uma. Para usar outra depois, revogue e conecte de novo.
2

Defina o acesso por ambiente

Teste e produção aparecem separados. Os ambientes habilitados já vêm marcados como somente leitura.
3

Libere escrita só se precisar

Marcar “leitura e escrita” é uma escolha sua. Mesmo com escrita, o assistente só altera o que o seu usuário pode alterar no painel.
4

Autorize

Pronto. O assistente passa a ver só as ferramentas permitidas para essa conexão.

​
Conectar com uma chave de API

Use uma chave de API quando quem se conecta não é uma pessoa, e sim um script, um robô de CI ou uma automação. A chave já fixa a organização e o ambiente: ch_test_ é teste, ch_live_ é produção.
Chaves de plataforma (escopo platform_admin) não funcionam no MCP. Use uma chave de organização com escopo read, write ou admin.

​
Codex

Guarde a chave em uma variável de ambiente e informe só o nome da variável:

​
Claude Code com .mcp.json

Crie um arquivo .mcp.json na raiz do projeto. A chave real não entra no arquivo, só o nome da variável:
Cada pessoa da equipe define CHARGEFY_MCP_TOKEN no próprio computador. Se o arquivo for compartilhado no repositório, o Claude Code pede aprovação antes de usar o servidor.
Para assistentes usados por pessoas, prefira o login com a conta. Deixe a chave de API para automações ou para clientes que não oferecem login.

​
Teste a conexão

Peça ao assistente:
Use a conexão Chargefy só para leitura. Mostre a organização, os ambientes e o nível de acesso. Depois, liste até 5 clientes no ambiente de teste. Não altere nada.
Por trás, ele faz três chamadas:
1

Lê o contexto

get_chargefy_account_info diz qual organização, quais ambientes e qual nível de acesso a conexão tem.
2

Descobre a operação

chargefy_api_search encontra customers.list.
3

Executa a leitura

chargefy_api_read lista os clientes de teste.
Se a resposta vier com os clientes, está tudo certo. Uma conexão só de leitura mostra nove ferramentas ao assistente. Quando algum ambiente tem escrita, aparecem mais duas: chargefy_api_create e chargefy_api_update.

​
Se algo não funcionar

Use exatamente https://mcp.chargefy.io, sem nada depois da barra, e confirme que o assistente suporta Streamable HTTP. Configurações do tipo stdio ou SSE não se conectam a esse endereço.
Abra o gerenciamento de MCP do assistente e procure Authenticate ou Login. No Codex, rode codex mcp login chargefy; no Claude Code, digite /mcp.
Confira se a chave é de uma organização (não de plataforma), se começa com ch_test_ ou ch_live_ e se não expirou nem foi revogada.
A instalação está certa; o problema é de permissão. Verifique se o ambiente está habilitado, se a conexão tem leitura ou escrita, se o seu usuário tem a capacidade necessária e se a operação foi concedida. Veja Acesso e permissões.
Se você autorizou teste e produção, peça para ele chamar get_chargefy_account_info e informar livemode: false (teste) ou livemode: true (produção) nas chamadas que acessam dados.

​
Continue

Acesso e permissões

Entenda organização, ambientes, leitura, escrita e revogação.

Tools e operações

Consulte as 11 tools e as 63 operações disponíveis.

Exemplos de uso

Siga fluxos práticos de descoberta, consulta e escrita segura.

Limites e segurança

Veja rate limits, auditoria e ações fora do MCP.