Skip to main content
O Dodo Agent Plugin conecta dois servidores MCP e dezessete skills de integração ao seu agente de programação com IA em uma única instalação. Ele funciona com Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode. O Gemini CLI recebe apenas os dois servidores MCP. Os servidores MCP e o CLI de skills funcionam com qualquer cliente compatível com MCP. O plugin segue a especificação Agent Plugins 1.0.0, portanto clientes com suporte nativo o carregam diretamente da raiz 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

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
O Codex instala plugins em duas etapas: registre o marketplace pelo shell e, em seguida, instale o plugin dentro da TUI do Codex.
1

Register the marketplace

2

Install from the Codex TUI

Abra o Codex e execute o comando de barra /plugins:
Depois, digite /plugins, alterne para o marketplace Dodo Payments, selecione o plugin dodopayments e escolha Install plugin.
Os dois servidores MCP e todas as dezessete skills são registrados automaticamente assim que o plugin é instalado.
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.
Se você já adicionou o marketplace e o plugin não aparecer em /plugins, atualize-o:
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.
Versões anteriores à 0.5.0 incluíam skills/ como links simbólicos para um submódulo git, portanto esse clone produzia um plugin com skills sem funcionamento. As skills agora são distribuídas como arquivos reais. Se você instalou uma versão anterior, exclua o diretório e faça o clone novamente.
O OpenCode é distribuído via npm. Adicione o plugin ao seu opencode.json:
Reinicie o OpenCode. Os dois servidores MCP (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:
As entradas 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.
Um caminho de skills inexistente é ignorado silenciosamente. Verifique em vez de presumir:
Você deverá ver todas as dezessete. Versões anteriores à 0.5.0 documentavam essas skills como descobertas automaticamente — isso não acontecia, então usuários do OpenCode tinham servidores MCP, mas nenhuma skill.
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 settings.json:
A chave é um caminho; o valor o habilita. Caminhos absolutos e ~/ 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.
O Kiro lê o manifesto do Agent Plugins nativamente e o carrega como um Power.
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/, 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.
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. dodo-knowledge ainda 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 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:
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

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.paths adicional 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 .md a 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:

Segurança e práticas recomendadas

Nunca confirme chaves de API de produção no repositório. Use o modo de teste durante o desenvolvimento. O Agent Plugin usa OAuth no navegador por padrão — alterne para chaves de API locais somente se o seu fluxo exigir isso.
  • 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.
Abra /plugins no Claude Code, selecione Dodo Payments e escolha Configure options. Preencha:
  • dodo_api_key — sua chave dodo_test_... ou dodo_live_...
  • dodo_webhook_key — seu segredo de assinatura de webhook
  • dodo_environmenttest_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 à sua sessão atual.
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 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
Última modificação em 17 de agosto de 2026