Build with AI Coding Agents

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.

Instalar o Plugin

Escolha abaixo seu coding agent. Cada instalação adiciona os dois MCP servers. Todos os agents, exceto Gemini CLI, também adicionam as dezessete skills. O OpenCode precisa de uma configuração extra para carregá-las, descrita em sua seção.

Claude Code

Instale pelo marketplace:

claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments

O API MCP server usa browser OAuth por padrão — nenhuma chave é necessária no momento da instalação. Na primeira vez que seu agent chamar uma ferramenta da 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

Registre o marketplace e instale pelo Codex TUI.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Abra o Codex e execute /plugins:

codex

Digite /plugins, alterne para o marketplace Dodo Payments, selecione o plugin dodopayments e escolha Install plugin.

Os dois MCP servers e todas as dezessete skills são registrados automaticamente.Se o plugin não aparecer em /plugins, atualize-o:

codex plugin marketplace upgrade dodopayments

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

Clone o repositório no diretório local de plugins do Cursor:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin

Reinicie o Cursor. O plugin carrega as skills de skills/ e os MCP servers de .mcp.json.As 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 distribuídas como arquivos reais, não como symlinks.

OpenCode

Instale o pacote do plugin no projeto e adicione-o, junto com o caminho das skills, ao seu opencode.json:

npm install --save-dev @dodopayments/opencode-plugin

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "skills": {
    "paths": ["node_modules/@dodopayments/opencode-plugin/skills"]
  }
}

Reinicie o OpenCode. Os dois MCP servers são registrados automaticamente. As skills precisam da entrada extra skills.paths porque o OpenCode não procura skills nos 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 o requisito de instalação local.Verifique se as skills foram carregadas:

opencode run "List every skill available to you by name."

Você deve ver todas as dezessete. Um caminho de skills que não existe é ignorado silenciosamente; portanto, verifique em vez de presumir.

VS Code / GitHub Copilot

Clone o repositório e registre-o:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/dodo-agent-plugin

Abra a visualização Chat, acesse Plugins e adicione a pasta clonada. Ou registre-a em settings.json:

{
  "chat.pluginLocations": { "~/dodo-agent-plugin": true }
}

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 de workspace. A configuração é lida em tempo real, 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 preview controlado por chat.plugins.enabled, que vem ativado por padrão.

Kiro

O Kiro lê o manifesto do Agent Plugins nativamente.

Clone the repository

git clone https://github.com/dodopayments/dodo-agent-plugin.git

Open the Powers panel

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

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 MCP servers de mcp.json. O Kiro gerencia os MCP servers 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)

O Gemini CLI não possui uma primitiva de agent-skill, portanto apenas os dois MCP servers estão disponíveis. dodo-knowledge cobre boa parte do que as skills oferecem e permanece atualizado automaticamente.

git clone https://github.com/dodopayments/dodo-agent-plugin.git \
  ~/.gemini/extensions/dodopayments

Reinicie o Gemini CLI. gemini-extension.json na raiz do repositório é o manifesto.

Usando outro agent? Os guias MCP Server e Agent Skills abrangem Claude Desktop, Windsurf, Cline, Zed e qualquer client compatível com MCP.

O que você obtém

Depois de instalado, seu agent terá acesso a dois MCP servers e dezessete skills.

MCP Servers

Server	Finalidade	Auth
`dodopayments-api`	Acesso à API em tempo real — pagamentos, assinaturas, clientes, produtos, reembolsos, licenças e uso	OAuth (navegador)
`dodo-knowledge`	Busca semântica em toda a documentação da Dodo Payments	Nenhuma

Os dois servers usam Streamable HTTP. O mcp.json canônico os declara nativamente, que é o formato usado por clients nativos da especificação, como Codex CLI e Kiro. O manifesto de compatibilidade gerado, .mcp.json, os conecta por meio de mcp-remote para clients que não conseguem usar Streamable HTTP diretamente.

Agent Skills

Skill	Descrição
`dodo-best-practices`	Configuração do SDK, ambientes, API keys e a arquitetura canônica de checkout a webhook
`framework-adapters`	Route handlers oficiais `@dodopayments/*` para Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun e Convex
`testing-and-go-live`	Modo de teste, métodos de pagamento de teste, testes de webhook e checklist de lançamento em produção
`checkout-integration`	Checkout Sessions, links de pagamento e checkout overlay ou inline
`subscription-integration`	Ciclo de vida de assinaturas, trials, alterações de planos, proration e cobranças sob demanda
`mobile-checkout`	Checkout no app para React Native, Flutter, iOS e Android
`webhook-integration`	Recebimento e verificação de webhooks usando a especificação Standard Webhooks
`credit-based-billing`	Entitlements de créditos, saldos, ledger, rollover, overage e dedução baseada em medidores
`usage-based-billing`	Medidores, ingestão de eventos, agregação e preços por unidade
`license-keys`	Ativação e validação de license keys e gerenciamento de instâncias
`product-catalog-management`	Produtos, preços, add-ons, collections, imagens e entrega de produtos digitais
`discounts-and-promotions`	Discount codes, regras de elegibilidade, combinação e limites por ciclo de assinatura
`localized-pricing`	Preços localizados, Adaptive Currency e paridade do poder de compra
`customer-management`	Clientes, portal de autoatendimento, métodos de pagamento salvos e wallets
`refunds-and-disputes`	Emissão de reembolsos, tratamento de disputes e chargebacks e reconciliação de acesso
`billing-sdk`	Componentes React do BillingSDK para tabelas de preços e UI de billing
`better-auth-integration`	O plugin `@dodopayments/better-auth` para sincronização de clientes, checkout e acesso ao portal

As skills são carregadas automaticamente — seu agent 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:

Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.

Seu agent carregará a skill webhook-integration, usará o MCP dodo-knowledge para obter as estruturas de payload mais recentes e escreverá um handler com verificação de assinatura seguindo a especificação Standard Webhooks.

Suporte dos Clients

O plugin segue a especificação Agent Plugins 1.0.0. Clients com suporte nativo o carregam diretamente; os demais usam manifestos de compatibilidade gerados.

Agents com instalação de Plugin

Uma instalação conecta os dois MCP servers, além das skills em cada client que possui uma primitiva de skills.

Agent	Instalação	Skills	MCP Servers
Claude Code	comando do marketplace	17	2
Codex CLI	comando do marketplace	17	2
Cursor	git clone	17	2
VS Code / GitHub Copilot	git clone	17	2
Kiro	git clone	17	2
OpenCode	npm	17	2
Gemini CLI	git clone	0	2

O OpenCode precisa de uma entrada extra 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 design.

Outros Clients compatíveis com MCP

Estes não possuem instalação de Agent Plugin. Configure os dois MCP servers manualmente e adicione as skills pelo Skills CLI quando houver suporte.

Agent	MCP Servers	Skills
Claude Desktop	Guia do MCP Server	sem suporte
Windsurf	Guia do MCP Server	Skills CLI
Cline / Zed / outros	Guia do MCP Server	Skills CLI

Documentação criada para Agents

Todas as páginas da documentação da 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 Markdown bruta (por exemplo, /api-reference/introduction.md)
Repositório-fonte: github.com/dodopayments/dodo-docs — clone para indexação offline

O que seu Agent pode fazer

Com o plugin instalado, seu coding agent pode:

Criar checkout sessions e links de pagamento — Pagamentos únicos e assinaturas
Configurar billing baseado em assinatura e uso de ponta a ponta — Assinaturas, Billing baseado em uso, Billing baseado em créditos
Gerar handlers compatíveis com Standard Webhooks com verificação de assinatura — Webhooks
Adicionar route handlers ao 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 license keys para produtos digitais — License keys
Implementar billing baseado em créditos com entitlements, saldos, rollover e overage — Créditos
Criar e gerenciar seu catálogo de produtos com add-ons e collections — Produtos, Add-ons, Collections de produtos
Adicionar descontos e preços localizados — Discount codes, Preços localizados, Adaptive Currency
Disponibilizar checkout mobile no app para React Native, Flutter, iOS e Android — Integração mobile
Lidar com reembolsos, disputes e autoatendimento de clientes — Reembolsos, Disputes, Customer portal
Testar a integração e entrar em produção com segurança — Modo de teste vs. modo live

Segurança e boas práticas

Nunca faça commit de API keys live. 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 browser OAuth (sem secrets locais). Use o modo com API key somente se necessário.
Revise o código gerado pelo agent. 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 MCP server remoto com browser OAuth. Para usar uma API key local, por exemplo em CI ou em um servidor headless, alterne para o modo stdio.

Local API key mode — Claude Code

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

Em seguida, edite .mcp.json para apontar dodopayments-api para o servidor stdio local:

{
  "mcpServers": {
    "dodopayments-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "${user_config.dodo_api_key}",
        "DODO_PAYMENTS_WEBHOOK_KEY": "${user_config.dodo_webhook_key}",
        "DODO_PAYMENTS_ENVIRONMENT": "${user_config.dodo_environment}"
      }
    }
  }
}

Execute /reload-plugins para aplicar as alterações.

Local API key mode — OpenCode

Declare dodopayments-api você mesmo em opencode.json — sua entrada tem prioridade sobre o remote server padrão do plugin:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "mcp": {
    "dodopayments-api": {
      "type": "local",
      "command": ["npx", "-y", "dodopayments-mcp@latest"],
      "environment": {
        "DODO_PAYMENTS_API_KEY": "YOUR_TEST_MODE_API_KEY",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

Reinicie o OpenCode para aplicar.

Próximos passos

MCP Server

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

Agent Skills

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

API Reference

Referência completa da OpenAPI para todos os endpoints da Dodo Payments

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Instalar o Plugin

Dodo Agent Plugin on GitHub

O que você obtém

MCP Servers

Agent Skills

Experimente este prompt primeiro

Suporte dos Clients

Agents com instalação de Plugin

Outros Clients compatíveis com MCP

Documentação criada para Agents

O que seu Agent pode fazer

Segurança e boas práticas

Configurar com uma API Key

Próximos passos

MCP Server

Agent Skills

API Reference

​Instalar o Plugin

Dodo Agent Plugin on GitHub

​O que você obtém

​MCP Servers

​Agent Skills

​Experimente este prompt primeiro

​Suporte dos Clients

​Agents com instalação de Plugin

​Outros Clients compatíveis com MCP

​Documentação criada para Agents

​O que seu Agent pode fazer

​Segurança e boas práticas

​Configurar com uma API Key

​Próximos passos

MCP Server

Agent Skills

API Reference

Instalar o Plugin

O que você obtém

MCP Servers

Agent Skills

Experimente este prompt primeiro

Suporte dos Clients

Agents com instalação de Plugin

Outros Clients compatíveis com MCP

Documentação criada para Agents

O que seu Agent pode fazer

Segurança e boas práticas

Configurar com uma API Key

Próximos passos