> ## 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.

# Codar com agentes de IA

> Instale as skills da Chargefy no Claude Code, Codex ou Cursor e conecte o MCP para desenvolver com os dados da sua conta.

Ensine seu agente a integrar a Chargefy e, quando precisar, conecte-o à sua conta. Depois, peça algo como:

> Use a skill da Chargefy para implementar um checkout de R\$ 99,90 neste projeto, em teste, com confirmação por webhook.

| Recurso                   | Para que serve                                                                     | Exemplo                                                |
| ------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------ |
| **Skills**                | Orientam o agente sobre a API, os fluxos de pagamento e os cuidados da integração. | Escrever um checkout com os campos e eventos corretos. |
| **MCP**                   | Conecta o agente aos dados da organização, com as permissões que você autorizar.   | Consultar clientes e conferir uma fatura de teste.     |
| **Plugin do Claude Code** | Reúne as mesmas quatro skills, um revisor de integração e a configuração do MCP.   | Revisar a integração antes de colocar em produção.     |

As skills podem ser usadas sem conectar uma conta. Para consultar ou criar recursos da sua organização, configure também o MCP.

## 1. Instale as skills

Com [Node.js](https://nodejs.org/) instalado, abra o terminal na pasta do seu projeto e execute:

```bash theme={"theme":"css-variables"}
npx skills add https://docs.chargefy.io --skill chargefy
```

O comando acima instala a skill de configuração, conceitos e boas práticas. Instale as demais conforme o assunto do seu projeto, usando os comandos da tabela abaixo.

Selecione o agente que você usa no instalador. Se preferir escolher diretamente, use o comando da sua ferramenta:

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={"theme":"css-variables"}
    npx skills add https://docs.chargefy.io --skill chargefy --agent claude-code
    ```
  </Tab>

  <Tab title="Codex">
    ```bash theme={"theme":"css-variables"}
    npx skills add https://docs.chargefy.io --skill chargefy --agent codex
    ```

    As skills ficam disponíveis para o Codex ao trabalhar neste projeto, pelo
    aplicativo, terminal ou extensão do editor.
  </Tab>

  <Tab title="Cursor">
    ```bash theme={"theme":"css-variables"}
    npx skills add https://docs.chargefy.io --skill chargefy --agent cursor
    ```
  </Tab>
</Tabs>

A instalação padrão vale para este projeto. Para instalar para o seu usuário em todos os projetos, acrescente `--global`. Abra uma conversa no projeto depois de instalar; se a skill não aparecer, reinicie o agente.

**Usa outra IDE ou agente?** As skills usam o padrão aberto Agent Skills. Rode o mesmo comando e selecione sua ferramenta entre as opções do instalador. A compatibilidade depende do agente da IDE oferecer suporte a skills; instalar a skill não adiciona esse suporte a um editor que não o tenha. Consulte os [agentes atendidos pelo instalador](https://skills.sh/docs/cli).

Peça para conferir:

> Leia a skill chargefy e explique qual fluxo usar para vender um curso por link de pagamento.

Cada comando instala a skill indicada. O agente usa as instruções pertinentes a cada tarefa; o MCP é opcional.

## Skills incluídas

| Skill                | O que cobre                                         | Comando de instalação                                                |
| -------------------- | --------------------------------------------------- | -------------------------------------------------------------------- |
| `chargefy`           | Configuração, conceitos, modelagem e boas práticas. | `npx skills add https://docs.chargefy.io --skill chargefy`           |
| `chargefy-payments`  | Checkout, webhooks e testes no sandbox.             | `npx skills add https://docs.chargefy.io --skill chargefy-payments`  |
| `chargefy-billing`   | Faturas, trial, pró-rata, uso e recuperação.        | `npx skills add https://docs.chargefy.io --skill chargefy-billing`   |
| `chargefy-platforms` | Organizações conectadas, ativação e marca.          | `npx skills add https://docs.chargefy.io --skill chargefy-platforms` |

Os comandos acima permitem escolher o agente no instalador. Acrescente `--agent claude-code`, `--agent codex` ou `--agent cursor` para direcionar a instalação à sua ferramenta.

Por exemplo: “Use chargefy para modelar um plano Pro de R\$ 99/mês e chargefy-billing para implementar um trial de 14 dias.” Para revisar código existente: “Use chargefy para conferir se esta integração pode cobrar em duplicidade.”

<Tip>
  **Usa Claude Code?** O [plugin da Chargefy](/mcp/plugin) é uma alternativa
  com as mesmas quatro skills, revisor de integração e MCP configurado.
  Se escolher o plugin, siga o guia dele: não precisa instalar as skills separadamente
  nem adicionar o mesmo servidor MCP novamente. A autorização da conta
  continua sendo necessária.
</Tip>

## 2. Conecte o MCP

No dashboard, abra **Desenvolvedores → MCP e Skills** e confira se o acesso ao ambiente de teste está habilitado. Em seguida, configure seu agente:

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={"theme":"css-variables"}
    claude mcp add --transport http chargefy https://mcp.chargefy.io
    ```

    No Claude Code, digite `/mcp`, selecione **chargefy** e escolha
    **Authenticate** para entrar com sua conta Chargefy.
  </Tab>

  <Tab title="Codex">
    Com a linha de comando do Codex instalada, execute:

    ```bash theme={"theme":"css-variables"}
    codex mcp add chargefy --url https://mcp.chargefy.io
    codex mcp login chargefy
    ```

    Conclua o login no navegador. Para conferir a configuração, execute
    `codex mcp list`. O aplicativo e a extensão também usam essa configuração
    no mesmo computador.
  </Tab>

  <Tab title="Cursor">
    Adicione o servidor em `.cursor/mcp.json`, na pasta do projeto. Se o arquivo
    já existir, acrescente `chargefy` dentro de `mcpServers`, preservando os
    outros servidores:

    ```json theme={"theme":"css-variables"}
    {
      "mcpServers": {
        "chargefy": {
          "url": "https://mcp.chargefy.io"
        }
      }
    }
    ```

    Abra as configurações de MCP do Cursor, localize **chargefy** e conclua
    a autenticação no navegador quando solicitada.
  </Tab>
</Tabs>

Na tela da Chargefy, escolha a organização e autorize **teste** com **somente leitura** para começar. Para pedir criação de clientes, produtos ou links de teste, escolha **leitura e escrita** nesse ambiente. Você pode revogar o acesso no painel a qualquer momento.

Não precisa copiar uma chave secreta para o agente: a conexão acima usa o login da sua conta. Para outros clientes e automações com API key, veja o [guia completo do MCP](/mcp/installation).

## 3. Confira a conexão

Peça:

> 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 em teste. Não altere nada.

O agente deve informar a organização autorizada e os clientes de teste; uma lista vazia também confirma a consulta quando não há clientes cadastrados.

Com escrita autorizada em teste, você pode pedir:

> Crie um link de pagamento de R\$ 99,90 para o curso Introdução à Fotografia, no ambiente de teste.

O MCP permite consultas e criação ou edição de clientes, catálogo, descontos e links. Captura, reembolso e cancelamento de assinaturas ficam fora dele. A skill pode orientar o código dessas integrações pela API; consulte as [ferramentas disponíveis](/mcp/tools).

## Manter as skills atualizadas

Execute novamente o comando de instalação para obter o conteúdo atual. Se usou `--global`, mantenha essa opção. Para o plugin do Claude Code, siga as [instruções de atualização do plugin](/mcp/plugin).

Se a skill não for encontrada, confirme que o agente abriu a pasta onde você instalou. Se o MCP conectar mas negar uma consulta, confira organização, ambiente e permissões em [Acesso e permissões](/mcp/authentication).