plugin.json e mcp.json. Clientes anteriores à especificação carregam o mesmo conteúdo por meio de manifestos de compatibilidade gerados.
Três componentes básicos, um plugin. O Agent Plugin reúne tudo de que você precisa:
- Servidor MCP de API — acesso em tempo real a pagamentos, assinaturas, clientes, produtos, reembolsos, licenças e uso. Autentica por OAuth no navegador (não são necessárias chaves locais).
- Servidor MCP de conhecimento — pesquisa semântica em toda a documentação do Dodo Payments. Não são necessárias credenciais.
- Dezessete skills de agente — guias rápidos que o 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 práticas recomendadas.
Instale o plugin
Escolha seu agente de programação abaixo. Cada instalação adiciona os dois servidores MCP; todos, exceto o Gemini CLI, também adicionam as dezessete skills.Claude Code
Claude Code
Instale pelo marketplace:O servidor MCP de 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
Codex CLI
Codex CLI
O Codex instala plugins em duas etapas: registre o marketplace pelo shell e, em seguida, instale o plugin dentro da TUI do Codex.Os dois servidores MCP e todas as dezessete skills são registrados automaticamente assim que o plugin é instalado.Se você já adicionou o marketplace e o plugin não aparecer em
1
Register the marketplace
2
Install from the Codex TUI
Abra o Codex e execute o comando de barra Depois, digite
/plugins:/plugins, alterne para o marketplace Dodo Payments, selecione o plugin dodopayments e escolha Install plugin.O Codex CLI não tem um subcomando
codex plugin install — a instalação do plugin sempre ocorre pelo fluxo /plugins dentro da TUI. Consulte a documentação oficial de plugins do Codex./plugins, atualize-o:Cursor
Cursor
Instalação manual — 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, conforme declarado em .cursor-plugin/plugin.json.Versões recentes do Cursor também reconhecem diretamente o Agent Plugins 1.0.0 e aceitam
.cursor-plugin/marketplace.json ou .claude-plugin/marketplace.json como fonte de marketplace. Este plugin inclui .claude-plugin/marketplace.json — use esse caminho. O .cursor-plugin/plugin.json gerado é mantido para versões mais antigas.OpenCode
OpenCode
O OpenCode é distribuído via npm. Adicione o plugin ao seu Reinicie o OpenCode. Os dois servidores MCP (As entradas
opencode.json:dodopayments-api, dodo-knowledge) são registrados automaticamente pelo hook de configuração do plugin. Nenhum bloco mcp manual é necessário.As skills precisam de uma linha adicional. O OpenCode não pesquisa skills nos pacotes instalados, portanto aponte manualmente para o diretório skills/ do pacote:skills.paths relativas são resolvidas em relação ao diretório do projeto, portanto o pacote precisa existir no node_modules desse projeto — o cache de plugins do próprio OpenCode fica em outro local. Um caminho absoluto também funciona e evita a exigência de instalação local.VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clone o repositório em qualquer local e registre-o:Abra a visualização Chat, acesse Plugins e adicione a pasta clonada. Você também pode registrá-la diretamente em A chave é um caminho; o valor o habilita. Caminhos absolutos e
settings.json:~/ também funcionam; um caminho relativo é resolvido em relação a cada pasta do workspace. A configuração é lida em tempo real, portanto uma janela em execução a aplica sem reinicialização. As skills são carregadas de skills/, e os dois servidores MCP são carregados de .mcp.json.chat.pluginLocations é marcado como experimental e é uma configuração restrita, portanto o workspace precisa ser confiável para que ela seja aplicada. O suporte a agent-plugin em geral é um recurso de pré-visualização governado por chat.plugins.enabled, que fica ativado por padrão — você só precisa defini-lo se sua organização o desabilitar por política.O VS Code não usa o Agent Plugins
$schema como chave. Seu carregador verifica .plugin/plugin.json, depois .claude-plugin/plugin.json e, em seguida, uma raiz plugin.json; por padrão, usa .mcp.json para MCP em vez de mcp.json. Como este repositório inclui um .claude-plugin/plugin.json gerado, o VS Code o carrega por esse caminho de compatibilidade e obtém a ponte mcp-remote em vez dos transportes nativos em mcp.json. Tudo funciona — o caminho é diferente.Kiro
Kiro
O Kiro lê o manifesto do Agent Plugins nativamente e o carrega como um Power.As skills são carregadas de
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.skills/, os servidores MCP de mcp.json, e a apresentação específica do Kiro vem do namespace de extensão dev.kiro em plugin.json.Para plugins no formato Agent Plugins, o Kiro gerencia os servidores MCP internamente — eles não são gravados no
~/.kiro/settings/mcp.json no nível do usuário, portanto não espere encontrá-los lá. O Kiro também pode instalar um Power diretamente de uma URL do GitHub; consulte a documentação de instalação do Kiro.Gemini CLI (MCP only)
Gemini CLI (MCP only)
O Gemini CLI não tem uma primitiva de agent-skill, portanto apenas os dois servidores MCP estão disponíveis — as dezessete skills não estão. Reinicie o Gemini CLI.
dodo-knowledge ainda cobre boa parte do que as skills oferecem e permanece atualizado automaticamente.gemini-extension.json na raiz do repositório é o manifesto.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 que o plugin é instalado, seu agente tem acesso a dois servidores MCP e dezessete skills.Servidores MCP
Ambos os servidores usam Streamable HTTP. O
mcp.json canônico os declara nativamente (type: "streamable-http"), que é o formato usado por clientes nativos da especificação, como Codex CLI e Kiro. O manifesto de compatibilidade gerado .mcp.json conecta os mesmos dois endpoints por meio de mcp-remote, permitindo que também sejam executados em clientes que não conseguem acessar o Streamable HTTP diretamente — Claude Code, VS Code e Cursor pelo clone do git documentado acima, cujo .cursor-plugin/plugin.json aponta para .mcp.json.
Skills de agente
As skills são carregadas automaticamente — seu agente escolhe a correta ao detectar uma tarefa relevante. Consulte a documentação de Agent Skills para ver a lista completa e a instalação individual.
Experimente este prompt primeiro
Depois que o plugin estiver ativo, experimente: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
Clientes com instalação do Agent Plugin
Uma instalação conecta os dois servidores MCP, além das skills em cada cliente que tem uma primitiva de skills.- O OpenCode precisa de uma entrada
skills.pathsadicional antes que suas dezessete skills sejam carregadas — consulte a seção de instalação acima. - O Gemini CLI não tem uma primitiva de agent-skill, portanto as skills não estão disponíveis por definição.
Outros clientes compatíveis com MCP
Estes não têm instalação do Agent Plugin. Configure manualmente os dois servidores MCP e adicione 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— fornece o índice completo da documentação para ingestão de contexto. - Markdown simples: acrescente
.mda qualquer URL da documentação para obter a versão em markdown bruto (por exemplo,/api-reference/introduction.md). - Repositório do código-fonte:
github.com/dodopayments/dodo-docs— clone para indexação offline.
O que seu agente pode fazer
Com o plugin instalado, seu agente de programação pode:- Criar sessões de checkout e links de pagamento — Pagamentos únicos e assinaturas
- Configurar a cobrança de assinaturas e baseada em uso de ponta a ponta — Assinaturas, Cobrança baseada em uso, Cobrança baseada em créditos
- Gerar handlers compatíveis com Standard Webhooks com verificação de assinatura — Webhooks
- Adicionar handlers de rota ao seu framework usando os adaptadores oficiais — Adaptadores de frameworks
- Integrar componentes React do BillingSDK para tabelas de preços e gerenciamento de assinaturas — BillingSDK
- Criar fluxos de chaves de licença para produtos digitais — Chaves de licença
- Implementar cobrança baseada em créditos com direitos, saldos, rollover e excedentes — Créditos
- Criar e gerenciar seu catálogo de produtos com complementos e coleções — Produtos, Complementos, Coleções de produtos
- Adicionar descontos e preços localizados — Códigos de desconto, Preços localizados, Adaptive Currency
- Oferecer checkout mobile no aplicativo para React Native, Flutter, iOS e Android — Integração mobile
- Tratar reembolsos, disputas e autoatendimento de clientes — Reembolsos, Disputas, Customer Portal
- Testar a integração e entrar em produção com segurança — Modo de teste versus modo live
Segurança e práticas recomendadas
- Use primeiro o modo de teste. Coloque sua integração em sandbox com chaves
dodo_test_...antes de entrar em produção. Consulte Modo de teste versus modo live. - OAuth é o padrão. O Agent Plugin autentica por OAuth no navegador (sem segredos locais). Use o modo com chave de API somente se necessário — consulte a seção Configurar abaixo.
- 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.
Configure com uma chave de API
Por padrão, o Agent Plugin usa o servidor MCP remoto com OAuth no navegador — não são necessárias credenciais locais. Se o seu fluxo exigir uma chave de API local (por exemplo, ambientes de CI ou servidores sem interface), você pode alternar para o modo stdio.Local API key mode — Claude Code
Local API key mode — Claude Code
Abra Execute
/plugins no Claude Code, selecione Dodo Payments e escolha Configure options. Preencha:dodo_api_key— sua chavedodo_test_...oudodo_live_...dodo_webhook_key— seu segredo de assinatura de webhookdodo_environment—test_modeoulive_mode
.mcp.json para apontar dodopayments-api para o servidor stdio local:/reload-plugins para aplicar as alterações à sua sessão atual.Local API key mode — OpenCode
Local API key mode — OpenCode
Declare Reinicie o OpenCode para aplicar.
dodopayments-api você mesmo em opencode.json — sua entrada substitui o servidor remoto padrão do plugin:Próximas etapas
MCP Server
Referência completa dos 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 para cada agente
Sentra IDE Assistant
Assistente de cobrança com IA para VS Code, Cursor e Windsurf — pergunte, crie e planeje no seu editor
API Reference
Referência completa da OpenAPI para todos os endpoints do Dodo Payments