Construa com Agentes de Codificação de IA

O Plugin Dodo Agent conecta dois servidores MCP e oito habilidades de integração ao seu agente de codificação de IA em uma única instalação. Funciona com Claude Code, Codex CLI, Cursor e OpenCode — e os servidores MCP e CLI de habilidades funcionam com qualquer cliente compatível com MCP.

Três primitivas, um plugin. O Plugin Agente agrupa tudo o que você precisa:

Servidor MCP API — acesso ao vivo a pagamentos, assinaturas, clientes, produtos, reembolsos, licenças e uso. Autentica via OAuth no navegador (sem necessidade de chaves locais).
Servidor MCP de conhecimento — busca semântica em toda a documentação do Dodo Payments. Não são necessárias credenciais.
Oito habilidades de agente — referências rápidas que seu agente carrega sob demanda para checkout, assinaturas, webhooks, faturamento baseado em uso, faturamento baseado em crédito, chaves de licença, BillingSDK e melhores práticas.

Instalar o plugin

Escolha seu agente de codificação abaixo. A instalação adiciona automaticamente ambos os servidores MCP e todas as oito habilidades.

Claude Code

Instalar do marketplace:

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

O servidor MCP API usa OAuth no navegador por padrão — não são necessárias chaves no momento da instalação. A primeira vez que seu agente chamar uma ferramenta do Dodo, você será solicitado a fazer login.

Dodo Agent Plugin on GitHub

Código-fonte, opções de configuração e instruções para desenvolvimento local

Codex CLI

Codex lê .claude-plugin/marketplace.json nativamente, então o mesmo repositório do plugin funciona:

codex plugin marketplace add dodopayments/dodo-agent-plugin
codex plugin install dodopayments@dodopayments

Ambos os servidores MCP e todas as oito habilidades são registrados automaticamente.

Cursor

Instalação manual — clone o repositório no diretório de plugins locais 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 habilidades de .claude/skills/ (via camada de compatibilidade Claude Code do Cursor) e os servidores MCP de .mcp.json.

Suporte ao marketplace do Cursor está a caminho. Por enquanto, use a instalação manual acima.

OpenCode

O OpenCode distribui via npm. Adicione o plugin ao seu opencode.json:

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

Reinicie o OpenCode. Ambos os servidores MCP (dodopayments-api, dodo-knowledge) são registrados automaticamente via o gancho de configuração do plugin, e as oito habilidades são descobertas automaticamente a partir do pacote instalado. Não é necessário bloco manual de mcp.

Usando um agente diferente? Os guias Servidor MCP e Habilidades do Agente cobrem Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed e qualquer cliente compatível com MCP.

O que você obtém

Uma vez que o plugin está instalado, seu agente tem acesso a dois servidores MCP e oito habilidades.

Servidores MCP

Servidor	Finalidade	Autenticação
`dodopayments-api`	Acesso ao vivo da API — pagamentos, assinaturas, clientes, produtos, reembolsos, licenças, uso	OAuth (navegador)
`dodo-knowledge`	Busca semântica em toda a documentação do Dodo Payments	Nenhuma

Ambos os servidores são conectados através de mcp-remote para que funcionem em qualquer cliente compatível com MCP.

Habilidades do agente

Habilidade	Descrição
`best-practices`	Guia abrangente para integrar Dodo Payments com as melhores práticas
`checkout-integration`	Criando sessões de checkout e fluxos de pagamento
`subscription-integration`	Implementando fluxos de faturamento por assinatura
`webhook-integration`	Configurando e manipulando webhooks para eventos de pagamento
`usage-based-billing`	Implementando faturamento medido com eventos e medidores
`credit-based-billing`	Direitos de crédito, saldos e dedução de crédito medida
`license-keys`	Gerenciando chaves de licença para produtos digitais
`billing-sdk`	Usando componentes React do BillingSDK

As habilidades carregam automaticamente — seu agente escolhe a certa quando detecta uma tarefa relevante. Veja a documentação de Habilidades do Agente para a lista completa e instalação individual.

Experimente este comando primeiro

Uma vez que o plugin está ativo, experimente:

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

Seu agente carregará a habilidade webhook-integration, usará o MCP dodo-knowledge para obter os formatos de carga mais recentes e escreverá um manipulador com verificação de assinatura seguindo o padrão dos Webhooks.

Outros agentes suportados

O Plugin Agente cobre Claude Code, Codex CLI, Cursor e OpenCode. Se você usar um agente diferente, conecte-se ao Dodo Payments através dos servidores MCP e CLI de habilidades:

Agente	Caminho mais rápido	Também suporta
Claude Code	Plugin Agente (um comando)	Servidor MCP, habilidades individuais
Codex CLI	Plugin Agente (um comando)	Servidor MCP
Cursor	Plugin Agente (git clone)	Configuração do servidor MCP, CLI de habilidades
OpenCode	Plugin Agente (npm)	Configuração do servidor MCP, CLI de habilidades
GitHub Copilot (VS Code)	Guia do Servidor MCP	Skills CLI
Claude Desktop	Guia do Servidor MCP	—
Windsurf	Guia do Servidor MCP	Skills CLI
Cline / Zed / outros	Guia do Servidor MCP	Skills CLI

Documentação construída para agentes

Toda página de documentação do Dodo Payments está disponível em um formato otimizado para consumo por IA:

Índice completo de documentos: docs.dodopayments.com/llms.txt — fornece o índice completo da documentação para ingestão de contexto.
Markdown puro: Anexe .md a qualquer URL de documentação para obter a versão bruta em markdown (ex., /api-reference/introduction.md).
Repositório de 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 codificação pode:

Criar sessões de checkout e links de pagamento — Pagamentos únicos e assinaturas
Configurar faturamento de assinatura e baseado em uso de ponta a ponta — Assinaturas, Faturamento baseado em uso, Faturamento baseado em crédito
Gerar manipuladores compatíveis com Standard Webhooks com verificação de assinatura — Webhooks
Conectar componentes React do BillingSDK para tabelas de preços e gerenciamento de assinaturas — BillingSDK
Desenvolver fluxos de chaves de licença para produtos digitais — Chaves de licença
Implementar faturamento baseado em créditos com direitos, saldos, acumulados e excesso — Créditos

Segurança e melhores práticas

Nunca comprometa chaves de API de produção. Use modo de teste durante o desenvolvimento. O Plugin Agente usa OAuth de navegador por padrão — só mude para chaves de API locais se seu fluxo de trabalho exigir.

Use o modo de teste primeiro. Teste sua integração com chaves dodo_test_... antes de ir para produção. Veja Modo de Teste vs Modo ao Vivo.
OAuth é o padrão. O Plugin Agente autentica via OAuth no navegador (sem segredos locais). Use o modo API-key apenas se necessário — veja a seção Configurar abaixo.
Revise o código gerado pelo agente. Sempre verifique se os manipuladores de webhooks incluem verificação de assinatura seguindo o padrão dos Webhooks.

Configurar com uma chave de API

Por padrão, o Plugin Agente usa o servidor MCP remoto com OAuth no navegador — nenhuma credencial local necessária. Se seu fluxo de trabalho exigir uma chave de API local (ex., ambientes de CI, servidores sem interface), você pode mudar para o modo stdio.

Local API key mode — Claude Code

Abra /plugins no Claude Code, selecione Dodo Payments e escolha Opções de Configuração. Preencha:

dodo_api_key — sua chave dodo_test_... ou dodo_live_...
dodo_webhook_key — seu segredo de assinatura de webhook
dodo_environment — test_mode ou live_mode

Então 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 à sua sessão atual.

Local API key mode — OpenCode

Declare dodopayments-api você mesmo em opencode.json — sua entrada prevalece sobre o servidor remoto 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": "dodo_test_...",
        "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 ambos os servidores MCP — todos os clientes suportados, configuração e ferramentas disponíveis

Agent Skills

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

Sentra IDE Assistant

Assistente de faturamento alimentado por IA para VS Code, Cursor e Windsurf — pergunte, construa e planeje no seu editor

API Reference

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Instalar o plugin

Dodo Agent Plugin on GitHub

O que você obtém

Servidores MCP

Habilidades do agente

Experimente este comando primeiro

Outros agentes suportados

Documentação construída para agentes

O que seu agente pode fazer

Segurança e melhores práticas

Configurar com uma chave de API

Próximos passos

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Documentation Index

​Instalar o plugin

Dodo Agent Plugin on GitHub

​O que você obtém

​Servidores MCP

​Habilidades do agente

​Experimente este comando primeiro

​Outros agentes suportados

​Documentação construída para agentes

​O que seu agente pode fazer

​Segurança e melhores práticas

​Configurar com uma chave de API

​Próximos passos

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

Instalar o plugin

O que você obtém

Servidores MCP

Habilidades do agente

Experimente este comando primeiro

Outros agentes suportados

Documentação construída para agentes

O que seu agente pode fazer

Segurança e melhores práticas

Configurar com uma chave de API

Próximos passos