Costruisci con agenti di codifica AI

Installa il Dodo Agent Plugin per fornire al tuo coding agent due server MCP e diciassette skill per creare integrazioni con Dodo Payments. Dopo averlo installato, descrivi ciò che vuoi creare e il tuo agent pianificherà e scriverà l’integrazione. Il plugin funziona con Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode. Gemini CLI riceve solo i due server MCP.

Installa il plugin

Scegli qui sotto il tuo agente di coding. Ogni installazione aggiunge entrambi i server MCP. Tutti gli agenti tranne Gemini CLI aggiungono anche le diciassette skill. OpenCode richiede un’impostazione aggiuntiva per caricarle, descritta nella relativa sezione.

Claude Code

Installa dal marketplace:

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

Il server API MCP utilizza OAuth tramite browser per impostazione predefinita: non sono necessarie chiavi al momento dell’installazione. La prima volta che il tuo agente chiama uno strumento Dodo, ti verrà chiesto di accedere.

Dodo Agent Plugin on GitHub

Codice sorgente, opzioni di configurazione e istruzioni per lo sviluppo locale

Codex CLI

Registra il marketplace, quindi installa dal TUI di Codex.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Apri Codex ed esegui /plugins:

codex

Digita /plugins, passa al marketplace Dodo Payments, seleziona il plugin dodopayments e scegli Install plugin.

Entrambi i server MCP e tutte le diciassette skill vengono registrati automaticamente.Se il plugin non compare in /plugins, aggiornalo:

codex plugin marketplace upgrade dodopayments

Per installare dalla shell anziché dal TUI, esegui codex plugin add dodopayments@dodopayments dopo aver registrato il marketplace. Codex CLI non dispone del sottocomando codex plugin install. Consulta la documentazione ufficiale dei plugin Codex.

Cursor

Clona il repository nella directory locale dei plugin di Cursor:

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

Riavvia Cursor. Il plugin carica le skill da skills/ e i server MCP da .mcp.json.Le build recenti di Cursor riconoscono direttamente Agent Plugins 1.0.0 e accettano .claude-plugin/marketplace.json come origine del marketplace. Il file .cursor-plugin/plugin.json generato viene mantenuto per le build precedenti.Se hai installato una versione precedente alla 0.5.0, elimina la directory e clona nuovamente il repository: ora le skill vengono distribuite come file reali, non come symlink.

OpenCode

Installa il pacchetto del plugin nel progetto, quindi aggiungilo insieme al percorso delle skill al tuo 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"]
  }
}

Riavvia OpenCode. Entrambi i server MCP vengono registrati automaticamente. Le skill richiedono la voce aggiuntiva skills.paths perché OpenCode non esegue la scansione dei pacchetti installati alla ricerca delle skill.I percorsi relativi vengono risolti rispetto alla directory del progetto, quindi il pacchetto deve esistere nel relativo node_modules. Funziona anche un percorso assoluto, evitando il requisito dell’installazione locale.Verifica che le skill siano state caricate:

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

Dovresti visualizzarle tutte e diciassette. Un percorso delle skill inesistente viene ignorato senza messaggi, quindi verifica invece di dare per scontato che sia stato caricato.

VS Code / GitHub Copilot

Clona il repository e registralo:

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

Apri la vista Chat, vai su Plugins e aggiungi la cartella clonata. In alternativa, registrala in settings.json:

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

La chiave è un percorso e il valore lo abilita. Funzionano sia i percorsi assoluti sia ~/; i percorsi relativi vengono risolti rispetto a ogni cartella dell’area di lavoro. L’impostazione viene letta in tempo reale, quindi una finestra già aperta la rileva senza riavvio.chat.pluginLocations è contrassegnato come sperimentale ed è un’impostazione limitata, quindi l’area di lavoro deve essere considerata attendibile. Il supporto per i plugin degli agenti è una funzionalità in anteprima regolata da chat.plugins.enabled, attivo per impostazione predefinita.

Kiro

Kiro legge nativamente il manifest di Agent Plugins.

Clone the repository

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

Open the Powers panel

In Kiro, apri il pannello Powers (l’icona di Ghosty con il fulmine).

Import the folder

Scegli Add Custom Power → Import power from a folder, seleziona la directory clonata (quella che contiene plugin.json) e fai clic su Install.

Le skill vengono caricate da skills/, mentre i server MCP vengono caricati da mcp.json. Kiro gestisce internamente i server MCP: non vengono scritti in ~/.kiro/settings/mcp.json. Kiro può anche installare direttamente una Power da un URL GitHub; consulta la documentazione di installazione di Kiro.

Gemini CLI (MCP only)

Gemini CLI non dispone di una primitiva agent-skill, quindi sono disponibili solo i due server MCP. dodo-knowledge copre buona parte delle funzionalità offerte dalle skill e rimane aggiornato automaticamente.

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

Riavvia Gemini CLI. gemini-extension.json nella radice del repository è il manifest.

Usi un agente diverso? Le guide MCP Server e Agent Skills illustrano Claude Desktop, Windsurf, Cline, Zed e qualsiasi client compatibile con MCP.

Cosa ottieni

Dopo l’installazione, il tuo agente ha accesso a due server MCP e diciassette skill.

Server MCP

Server	Scopo	Autenticazione
`dodopayments-api`	Accesso API in tempo reale — pagamenti, abbonamenti, clienti, prodotti, rimborsi, licenze, utilizzo	OAuth (browser)
`dodo-knowledge`	Ricerca semantica nella documentazione completa di Dodo Payments	Nessuna

Entrambi i server utilizzano Streamable HTTP. Il manifest canonico mcp.json li dichiara nativamente, come utilizzato dai client nativi della specifica quali Codex CLI e Kiro. Il manifest di compatibilità generato .mcp.json li collega tramite mcp-remote per i client che non possono connettersi direttamente a Streamable HTTP.

Skill degli agenti

Skill	Descrizione
`dodo-best-practices`	Configurazione degli SDK, ambienti, chiavi API e architettura canonica da checkout a webhook
`framework-adapters`	Handler di route ufficiali `@dodopayments/*` per Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun e Convex
`testing-and-go-live`	Modalità test, metodi di pagamento di test, test dei webhook e checklist per il lancio in produzione
`checkout-integration`	Checkout Sessions, link di pagamento e checkout overlay o inline
`subscription-integration`	Ciclo di vita degli abbonamenti, periodi di prova, modifiche ai piani, prorata e addebiti on-demand
`mobile-checkout`	Checkout in-app per React Native, Flutter, iOS e Android
`webhook-integration`	Ricezione e verifica dei webhook mediante la specifica Standard Webhooks
`credit-based-billing`	Entitlement dei crediti, saldi, ledger, rollover, overage e detrazione basata sui meter
`usage-based-billing`	Meter, acquisizione degli eventi, aggregazione e prezzi per unità
`license-keys`	Attivazione e convalida delle chiavi di licenza e gestione delle istanze
`product-catalog-management`	Prodotti, prezzi, componenti aggiuntivi, raccolte, immagini e distribuzione di prodotti digitali
`discounts-and-promotions`	Codici sconto, regole di idoneità, combinazione e limiti per ciclo di abbonamento
`localized-pricing`	Prezzi localizzati, Adaptive Currency e parità del potere d’acquisto
`customer-management`	Clienti, portale self-service, metodi di pagamento salvati e wallet
`refunds-and-disputes`	Emissione di rimborsi, gestione di controversie e chargeback e riconciliazione degli accessi
`billing-sdk`	Componenti React di BillingSDK per tabelle dei prezzi e interfaccia di fatturazione
`better-auth-integration`	Il plugin `@dodopayments/better-auth` per la sincronizzazione dei clienti, il checkout e l’accesso al portale

Le skill vengono caricate automaticamente: il tuo agente sceglie quella corretta quando rileva un’attività pertinente. Consulta Agent Skills per l’elenco completo e l’installazione individuale.

Prova prima questo prompt

Dopo aver attivato il plugin, prova:

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

Il tuo agente caricherà la skill webhook-integration, utilizzerà MCP dodo-knowledge per recuperare le forme del payload più recenti e scriverà un handler con verifica della firma seguendo la specifica Standard Webhooks.

Supporto dei client

Il plugin segue la specifica Agent Plugins 1.0.0. I client con supporto nativo lo caricano direttamente; gli altri utilizzano manifest di compatibilità generati.

Agenti con installazione del plugin

Una sola installazione collega entrambi i server MCP, oltre alle skill su ogni client che dispone di una primitiva per le skill.

Agente	Installazione	Skill	Server MCP
Claude Code	comando del marketplace	17	2
Codex CLI	comando del marketplace	17	2
Cursor	clone git	17	2
VS Code / GitHub Copilot	clone git	17	2
Kiro	clone git	17	2
OpenCode	npm	17	2
Gemini CLI	clone git	0	2

OpenCode richiede una voce aggiuntiva skills.paths prima di caricare le sue diciassette skill. Gemini CLI non dispone di una primitiva agent-skill, quindi le skill non sono disponibili per progettazione.

Altri client compatibili con MCP

Questi client non dispongono dell’installazione tramite Agent Plugin. Configura manualmente i due server MCP e aggiungi le skill tramite Skills CLI, dove supportato.

Agente	Server MCP	Skill
Claude Desktop	Guida MCP Server	non supportate
Windsurf	Guida MCP Server	Skills CLI
Cline / Zed / altri	Guida MCP Server	Skills CLI

Documentazione pensata per gli agenti

Ogni pagina della documentazione di Dodo Payments è disponibile in un formato ottimizzato per l’utilizzo da parte dell’AI:

Indice completo della documentazione: docs.dodopayments.com/llms.txt — indice completo della documentazione per l’acquisizione del contesto
Markdown semplice: aggiungi .md a qualsiasi URL della documentazione per ottenere la versione Markdown grezza (ad esempio, /api-reference/introduction.md)
Repository sorgente: github.com/dodopayments/dodo-docs — clonalo per l’indicizzazione offline

Cosa può fare il tuo agente

Con il plugin installato, il tuo agente di coding può:

Creare checkout session e link di pagamento — Pagamenti una tantum e abbonamenti
Configurare la fatturazione basata su abbonamenti e utilizzo end-to-end — Abbonamenti, Fatturazione basata sull’utilizzo, Fatturazione basata sui crediti
Generare handler conformi a Standard Webhooks con verifica della firma — Webhooks
Montare handler di route nel tuo framework utilizzando gli adapter ufficiali — Adapter per framework
Collegare i componenti React di BillingSDK per le tabelle dei prezzi e la gestione degli abbonamenti — BillingSDK
Creare flussi con chiavi di licenza per i prodotti digitali — Chiavi di licenza
Implementare la fatturazione basata sui crediti con entitlement, saldi, rollover e overage — Crediti
Creare e gestire il catalogo dei prodotti con componenti aggiuntivi e raccolte — Prodotti, Componenti aggiuntivi, Raccolte di prodotti
Aggiungere sconti e prezzi localizzati — Codici sconto, Prezzi localizzati, Adaptive Currency
Distribuire il checkout in-app mobile per React Native, Flutter, iOS e Android — Integrazione mobile
Gestire rimborsi, controversie e self-service dei clienti — Rimborsi, Controversie, Customer Portal
Testare l’integrazione e passare alla produzione in sicurezza — Modalità test e modalità live

Sicurezza e best practice

Non eseguire mai il commit delle chiavi API live. Usa la modalità test durante lo sviluppo.

Usa prima la modalità test. Crea e testa la tua integrazione con una chiave API della modalità test prima di passare alla produzione. Consulta Modalità test e modalità live.
OAuth è l’impostazione predefinita. Agent Plugin esegue l’autenticazione tramite OAuth nel browser (senza segreti locali). Usa la modalità con chiave API solo se necessario.
Controlla il codice generato dall’agente. Verifica sempre che gli handler dei webhook includano la verifica della firma seguendo la specifica Standard Webhooks.

Configura con una chiave API

Per impostazione predefinita, Agent Plugin utilizza il server MCP remoto con OAuth tramite browser. Per usare invece una chiave API locale, ad esempio in CI o su un server headless, passa alla modalità stdio.

Local API key mode — Claude Code

Apri /plugins in Claude Code, seleziona Dodo Payments e scegli Configure options. Compila:

dodo_api_key — la tua chiave API della modalità test o live
dodo_webhook_key — il tuo secret per la firma dei webhook
dodo_environment — test_mode o live_mode

Quindi modifica .mcp.json per indirizzare dodopayments-api al server stdio locale:

{
  "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}"
      }
    }
  }
}

Esegui /reload-plugins per applicare le modifiche.

Local API key mode — OpenCode

Dichiara personalmente dodopayments-api in opencode.json: la tua voce ha la precedenza sul server remoto predefinito del 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
    }
  }
}

Riavvia OpenCode per applicare le modifiche.

Passaggi successivi

MCP Server

Riferimento completo per entrambi i server MCP — tutti i client supportati, la configurazione e gli strumenti disponibili

Agent Skills

Installazione individuale delle skill, riferimento delle skill e istruzioni di configurazione per ogni agente

API Reference

Riferimento OpenAPI completo per tutti gli endpoint di Dodo Payments

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Installa il plugin

Dodo Agent Plugin on GitHub

Cosa ottieni

Server MCP

Skill degli agenti

Prova prima questo prompt

Supporto dei client

Agenti con installazione del plugin

Altri client compatibili con MCP

Documentazione pensata per gli agenti

Cosa può fare il tuo agente

Sicurezza e best practice

Configura con una chiave API

Passaggi successivi

MCP Server

Agent Skills

API Reference

​Installa il plugin

Dodo Agent Plugin on GitHub

​Cosa ottieni

​Server MCP

​Skill degli agenti

​Prova prima questo prompt

​Supporto dei client

​Agenti con installazione del plugin

​Altri client compatibili con MCP

​Documentazione pensata per gli agenti

​Cosa può fare il tuo agente

​Sicurezza e best practice

​Configura con una chiave API

​Passaggi successivi

MCP Server

Agent Skills

API Reference

Installa il plugin

Cosa ottieni

Server MCP

Skill degli agenti

Prova prima questo prompt

Supporto dei client

Agenti con installazione del plugin

Altri client compatibili con MCP

Documentazione pensata per gli agenti

Cosa può fare il tuo agente

Sicurezza e best practice

Configura con una chiave API

Passaggi successivi