Skip to main content
Instale o Dodo Agent Plugin para fornecer ao seu coding agent dois servidores MCP e dezessete skills para criar integrações com o Dodo Payments. Depois de instalá-lo, descreva o que deseja criar, e seu agente planejará e escreverá a integração. O plugin funciona com Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode. O Gemini CLI recebe apenas os dois servidores MCP. O plugin segue a especificação Agent Plugins 1.0.0. Clientes com suporte nativo carregam o plugin diretamente; os demais usam manifests de compatibilidade gerados. O que você recebe:
  • Servidor MCP da API do Dodo Payments — acesso em tempo real a pagamentos, assinaturas, clientes, produtos, reembolsos, licenças e uso. Autentica por OAuth no navegador (nenhuma chave local é necessária).
  • Servidor MCP de conhecimento do Dodo — pesquisa semântica em toda a documentação do Dodo Payments. Nenhuma credencial é necessária.
  • Dezessete skills de agente — guias rápidos que seu agente carrega sob demanda para checkout, assinaturas, webhooks, cobrança baseada em uso e em créditos, chaves de licença, catálogo de produtos, descontos, preços localizados, checkout mobile, reembolsos e disputas, gerenciamento de clientes, adaptadores de frameworks, BillingSDK, Better Auth, testes e entrada em produção, além de boas práticas.

Instalar o Plugin

Escolha seu coding agent abaixo. Toda instalação adiciona os dois servidores MCP. Todos os agentes, exceto o Gemini CLI, também adicionam as dezessete skills. O OpenCode precisa de uma configuração adicional para carregá-las, descrita na seção correspondente.

Claude Code

Instale pelo marketplace:
O servidor MCP da API usa OAuth no navegador por padrão — nenhuma chave é necessária no momento da instalação. Na primeira vez que seu agente chamar uma ferramenta do Dodo, será solicitado que você faça login.

Dodo Agent Plugin on GitHub

Código-fonte, opções de configuração e instruções para desenvolvimento local
Registre o marketplace e instale pelo Codex TUI.
1

Register the marketplace

2

Install from the Codex TUI

Abra o Codex e execute /plugins:
Digite /plugins, mude para o marketplace do Dodo Payments, selecione o plugin dodopayments e escolha Install plugin.
Os dois servidores MCP e todas as dezessete skills são registrados automaticamente.Se o plugin não aparecer em /plugins, atualize-o:
Para instalar pelo shell em vez do TUI, execute codex plugin add dodopayments@dodopayments depois de registrar o marketplace. O Codex CLI não possui o subcomando codex plugin install. Consulte a documentação oficial de plugins do Codex.
Clone o repositório no diretório de plugins local do Cursor:
Reinicie o Cursor. O plugin carrega as skills de skills/ e os servidores MCP de .mcp.json.Versões recentes do Cursor reconhecem o Agent Plugins 1.0.0 diretamente e aceitam .claude-plugin/marketplace.json como fonte de marketplace. O .cursor-plugin/plugin.json gerado é mantido para versões mais antigas.Se você instalou uma versão anterior à 0.5.0, exclua o diretório e faça o clone novamente — agora as skills são fornecidas como arquivos reais, não como symlinks.
Instale o pacote do plugin no seu projeto e adicione-o, junto com o caminho das skills, ao seu opencode.json:
Reinicie o OpenCode. Os dois servidores MCP são registrados automaticamente. As skills precisam da entrada adicional skills.paths porque o OpenCode não procura skills em pacotes instalados.Os caminhos relativos são resolvidos em relação ao diretório do projeto, portanto o pacote precisa existir no node_modules desse projeto. Um caminho absoluto também funciona e evita a exigência de instalação local.Verifique se as skills foram carregadas:
Você deve ver todas as dezessete. Um caminho de skills que não existe é ignorado silenciosamente, portanto verifique em vez de presumir.
Clone o repositório e registre-o:
Abra a visualização Chat, acesse Plugins e adicione a pasta clonada. Ou registre-a em settings.json:
A chave é um caminho, e o valor o habilita. Caminhos absolutos e ~/ também funcionam; caminhos relativos são resolvidos em relação a cada pasta do workspace. A configuração é lida dinamicamente, portanto uma janela em execução a detecta sem reinicialização.chat.pluginLocations é marcado como experimental e é uma configuração restrita, portanto o workspace precisa ser confiável. O suporte a agent-plugin é um recurso de prévia controlado por chat.plugins.enabled, que vem ativado por padrão.
O Kiro lê o manifest do Agent Plugins nativamente.
1

Clone the repository

2

Open the Powers panel

No Kiro, abra o painel Powers (o ícone do Ghosty com o raio).
3

Import the folder

Escolha Add Custom Power → Import power from a folder, selecione o diretório clonado (aquele que contém plugin.json) e clique em Install.
As skills são carregadas de skills/, e os servidores MCP, de mcp.json. O Kiro gerencia os servidores MCP internamente — eles não são gravados em ~/.kiro/settings/mcp.json. O Kiro também pode instalar um Power diretamente de uma URL do GitHub; consulte a documentação de instalação do Kiro.
O Gemini CLI não possui uma primitiva de agent-skill, portanto apenas os dois servidores MCP estão disponíveis. dodo-knowledge cobre boa parte do que as skills oferecem e permanece atualizado automaticamente.
Reinicie o Gemini CLI. gemini-extension.json na raiz do repositório é o manifest.
Usando outro agente? Os guias MCP Server e Agent Skills abrangem Claude Desktop, Windsurf, Cline, Zed e qualquer cliente compatível com MCP.

O que você recebe

Depois de instalado, seu agente terá acesso a dois servidores MCP e dezessete skills.

Servidores MCP

Ambos os servidores usam Streamable HTTP. O mcp.json canônico os declara nativamente, e clientes nativos da especificação, como Codex CLI e Kiro, o utilizam. O manifest de compatibilidade gerado .mcp.json os conecta por meio de mcp-remote para clientes que não conseguem estabelecer conexão direta com Streamable HTTP.

Skills de agente

As skills são carregadas automaticamente — seu agente escolhe a correta ao detectar uma tarefa relevante. Consulte Agent Skills para ver a lista completa e a instalação individual.

Experimente este prompt primeiro

Depois que o plugin estiver ativo, experimente:
Seu agente carregará a skill webhook-integration, usará o MCP dodo-knowledge para obter os formatos de payload mais recentes e escreverá um handler com verificação de assinatura seguindo a especificação Standard Webhooks.

Suporte a clientes

Agentes com instalação de plugin

Uma instalação conecta os dois servidores MCP, além das skills em todos os clientes que possuem uma primitiva de skills. O OpenCode precisa de uma entrada adicional skills.paths antes que suas dezessete skills sejam carregadas. O Gemini CLI não possui uma primitiva de agent-skill, portanto as skills não estão disponíveis por definição.

Outros clientes compatíveis com MCP

Eles não têm instalação de Agent Plugin. Configure os dois servidores MCP manualmente e adicione as skills pelo Skills CLI quando houver suporte.

Documentação criada para agentes

Todas as páginas da documentação do Dodo Payments estão disponíveis em um formato otimizado para consumo por IA:
  • Índice completo da documentação: docs.dodopayments.com/llms.txt — índice completo da documentação para ingestão de contexto
  • Markdown simples: adicione .md a qualquer URL da documentação para obter a versão em Markdown bruto (por exemplo, /api-reference/introduction.md)
  • Repositório-fonte: github.com/dodopayments/dodo-docs — clone para indexação offline

O que seu agente pode fazer

Com o plugin instalado, seu coding agent pode:

Segurança e boas práticas

Nunca faça commit de API keys de produção. Use o modo de teste durante o desenvolvimento.
  • Use primeiro o modo de teste. Crie e teste sua integração com uma API key do modo de teste antes de entrar em produção. Consulte Modo de teste vs. modo live.
  • OAuth é o padrão. O Agent Plugin autentica por OAuth no navegador (sem secrets locais). Use o modo com API key somente se necessário.
  • Revise o código gerado pelo agente. Sempre verifique se os handlers de webhook incluem verificação de assinatura seguindo a especificação Standard Webhooks.

Configurar com uma API Key

Por padrão, o Agent Plugin usa o servidor MCP remoto com OAuth no navegador. Para usar uma API key local, por exemplo em CI ou em um servidor headless, mude para o modo stdio.
Abra /plugins no Claude Code, selecione Dodo Payments e escolha Configure options. Preencha:
  • dodo_api_key — sua API key do modo de teste ou do modo live
  • dodo_webhook_key — seu webhook signing secret
  • dodo_environment — test_mode ou live_mode
Depois, edite .mcp.json para apontar dodopayments-api para o servidor stdio local:
Execute /reload-plugins para aplicar as alterações.
Declare dodopayments-api você mesmo em opencode.json — sua entrada substitui o servidor remoto padrão do plugin:
Reinicie o OpenCode para aplicar.

Próximas etapas

MCP Server

Referência completa para os dois servidores MCP — todos os clientes compatíveis, configurações e ferramentas disponíveis

Agent Skills

Instalação individual de skills, referência de skills e instruções de configuração por agente

API Reference

Referência completa da OpenAPI para todos os endpoints do Dodo Payments
Última modificação em 26 de setembro de 2026