- 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
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
Codex CLI
Codex CLI
Registre o marketplace e instale pelo Codex TUI.Os dois servidores MCP e todas as dezessete skills são registrados automaticamente.Se o plugin não aparecer em
1
Register the marketplace
2
Install from the Codex TUI
Abra o Codex e execute Digite
/plugins:/plugins, mude para o marketplace do Dodo Payments, selecione o plugin dodopayments e escolha Install plugin./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.Cursor
Cursor
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.OpenCode
OpenCode
Instale o pacote do plugin no seu projeto e adicione-o, junto com o caminho das skills, ao seu Reinicie o OpenCode. Os dois servidores MCP são registrados automaticamente. As skills precisam da entrada adicional Você deve ver todas as dezessete. Um caminho de skills que não existe é ignorado silenciosamente, portanto verifique em vez de presumir.
opencode.json: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:VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clone o repositório e registre-o:Abra a visualização Chat, acesse Plugins e adicione a pasta clonada. Ou registre-a em A chave é um caminho, e o valor o habilita. Caminhos absolutos e
settings.json:~/ 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.Kiro
Kiro
O Kiro lê o manifest do Agent Plugins nativamente.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/, 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.Gemini CLI (MCP only)
Gemini CLI (MCP only)
O Gemini CLI não possui uma primitiva de agent-skill, portanto apenas os dois servidores MCP estão disponíveis. Reinicie o Gemini CLI.
dodo-knowledge cobre boa parte do que as skills oferecem e permanece atualizado automaticamente.gemini-extension.json na raiz do repositório é o manifest.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: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
.mda 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:- Criar sessões de checkout e links de pagamento — Pagamentos únicos e assinaturas
- Configurar cobrança baseada em assinaturas e 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
- Montar route handlers no seu framework usando os adaptadores oficiais — Adaptadores de framework
- Conectar 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 entitlements, saldos, rollover e overage — Créditos
- Criar e gerenciar seu catálogo de produtos com add-ons e coleções — Produtos, Add-ons, Coleções de produtos
- Adicionar descontos e preços localizados — Códigos de desconto, Preços localizados, Adaptive Currency
- Disponibilizar checkout mobile no aplicativo para React Native, Flutter, iOS e Android — Integração mobile
- Gerenciar reembolsos, disputas e autoatendimento de clientes — Reembolsos, Disputas, Portal do cliente
- Testar a integração e entrar em produção com segurança — Modo de teste vs. modo live
Segurança e boas práticas
- 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.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 API key do modo de teste ou do modo livedodo_webhook_key— seu webhook signing secretdodo_environment—test_modeoulive_mode
.mcp.json para apontar dodopayments-api para o servidor stdio local:/reload-plugins para aplicar as alterações.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 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