> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin do Claude Code

> Instale o plugin da Chargefy para o Claude Code e o Cowork: skills de integração, proteção de chave e o MCP configurado de uma vez.

O [MCP](/mcp/installation) dá ao assistente acesso aos seus dados. O **plugin**
dá o resto: instruções de integração que ele carrega sozinho quando o assunto
aparece, uma proteção contra chave secreta versionada e o próprio MCP já
configurado — sem `claude mcp add` manual.

```bash theme={"theme":"css-variables"}
claude plugin marketplace add chargefy-io/claude-plugin
```

```bash theme={"theme":"css-variables"}
claude plugin install chargefy@chargefy
```

<Info>
  O plugin funciona no **Claude Code** e no **Cowork**. Em outros clientes
  (Claude, ChatGPT, Codex), use o [MCP](/mcp/installation) diretamente — ele é o
  mesmo servidor.
</Info>

## O que vem dentro

| Skill               | Entra quando o assunto é                                                            |
| ------------------- | ----------------------------------------------------------------------------------- |
| `setup`             | Chave de teste, variáveis de ambiente e a primeira chamada com resposta `200`       |
| `escolher-checkout` | Decidir entre link de pagamento, checkout hospedado, white-label ou Payment Intents |
| `webhooks`          | Criar ou revisar um endpoint: assinatura, deduplicação, retentativas                |
| `convencoes-da-api` | Erros, retry, idempotência, paginação, valores em centavos e datas com fuso         |
| `testar-pagamentos` | Simular aprovação, recusa, captura pendente ou processamento no sandbox             |

As skills entram sozinhas quando a conversa pede — você não precisa chamá-las
pelo nome, embora `/chargefy:setup` e as demais funcionem como comando.

<Tip>
  A tabela de cartões de teste da skill `testar-pagamentos` é gerada do mesmo
  código que decide o desfecho no sandbox. Cartão novo aparece no plugin sem
  ninguém transcrever nada.
</Tip>

## Revisor de integração

O plugin traz um subagente, `integration-reviewer`, que revisa código de
integração procurando o que costuma passar na revisão humana e falhar em
produção:

* webhook processado sem verificar a assinatura, ou com o corpo já
  reserializado por um parser;
* cobrança criada sem `Idempotency-Key`, ou com chave nova a cada retry;
* chave secreta em código que chega ao navegador;
* retorno do comprador tratado como confirmação de pagamento;
* retry em `502 payment_result_unconfirmed`, que cobra duas vezes.

Peça "revise essa integração com a Chargefy" antes de subir, ou invoque direto
com `@chargefy:integration-reviewer`. Ele só lê e reporta — não escreve nem
edita arquivo.

## Proteção de chave

O plugin instala um aviso automático: quando uma chave secreta de produção
(`ch_live_...`) é escrita em um arquivo que o Git versiona, o assistente é
avisado na hora e corrige.

Arquivo ignorado pelo Git — o seu `.env` local — **não** dispara o aviso, porque
é exatamente onde a chave deve estar. A chave nunca é impressa por inteiro.

<Warning>
  Se uma chave secreta chegou a entrar em um commit, revogue-a em
  **Desenvolvedores → Chaves de API** antes de qualquer outra coisa. Reescrever
  histórico não desfaz a exposição.
</Warning>

## Conexão com o MCP

O plugin já traz `https://mcp.chargefy.io` configurado. Depois de instalar, abra
`/mcp`, selecione **chargefy** e escolha **Authenticate** para autorizar uma
organização e definir teste e/ou ao vivo.

Se você já tinha adicionado o servidor manualmente, o Claude Code reconhece que
é o mesmo endereço e não duplica as tools.

As skills funcionam sem autorizar o MCP; o que depende dela é consultar dados da
sua conta.

## Manter atualizado

<Steps>
  <Step title="Atualize o marketplace">
    `claude plugin marketplace update chargefy` busca a versão publicada mais
    recente.
  </Step>

  <Step title="Atualize o plugin">
    `claude plugin update chargefy` aplica a versão nova.
  </Step>

  <Step title="Remova quando quiser">
    `claude plugin uninstall chargefy` desinstala. O conector MCP autorizado
    continua válido até você revogá-lo em **Desenvolvedores → Conexões**.
  </Step>
</Steps>

## Código aberto

O plugin é MIT e vive em
[chargefy-io/claude-plugin](https://github.com/chargefy-io/claude-plugin). O
conteúdo é gerado a partir do código que roda em produção, então correção entra
pela origem: abra uma issue no repositório ou fale com o suporte.

## Continue

<CardGroup cols={2}>
  <Card title="MCP da Chargefy" icon="plug" href="/mcp/installation">
    Conecte outros assistentes ao mesmo servidor.
  </Card>

  <Card title="Acesso e permissões" icon="key" href="/mcp/authentication">
    Organização, ambientes, leitura, escrita e revogação.
  </Card>

  <Card title="Tools e operações" icon="screwdriver-wrench" href="/mcp/tools">
    O que o assistente consegue executar em cada conexão.
  </Card>

  <Card title="Sandbox" icon="flask" href="/api-reference/sandbox">
    Cartões e cenários determinísticos de teste.
  </Card>
</CardGroup>