- Dodo Payments API MCP server — accesso live a pagamenti, subscription, clienti, prodotti, rimborsi, licenze e utilizzo. Esegue l’autenticazione tramite browser OAuth (non sono necessarie chiavi locali).
- Dodo Knowledge MCP server — ricerca semantica nell’intera documentazione di Dodo Payments. Non sono necessarie credenziali.
- Diciassette agent skill — schede di riferimento che il tuo agent carica quando necessario per checkout, subscription, webhook, billing basato sull’utilizzo e sui crediti, chiavi di licenza, catalogo prodotti, sconti, prezzi localizzati, checkout mobile, rimborsi e contestazioni, gestione dei clienti, adapter per framework, BillingSDK, Better Auth, testing e go-live, oltre alle best practice.
Installa il Plugin
Scegli il tuo coding agent qui sotto. Ogni installazione aggiunge entrambi i server MCP. Tutti gli agent, ad eccezione di Gemini CLI, aggiungono anche le diciassette skill. OpenCode richiede un’impostazione aggiuntiva per caricarle, descritta nella relativa sezione.Claude Code
Claude Code
Installa dal marketplace: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 agent 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
Codex CLI
Registra il marketplace, quindi installa dal Codex TUI.Entrambi i server MCP e tutte le diciassette skill vengono registrati automaticamente.Se il plugin non compare in
1
Register the marketplace
2
Install from the Codex TUI
Apri Codex ed esegui Digita
/plugins:/plugins, passa al marketplace Dodo Payments, seleziona il plugin dodopayments e scegli Install plugin./plugins, aggiornalo:Per installare dalla shell invece che dal TUI, esegui
codex plugin add dodopayments@dodopayments dopo aver registrato il marketplace. Codex CLI non dispone del sottom comando codex plugin install. Consulta la documentazione ufficiale dei plugin Codex.Cursor
Cursor
Clona il repository nella directory dei plugin locali di Cursor:Riavvia Cursor. Il plugin carica le skill da
skills/ e i server MCP da .mcp.json.Le versioni recenti di Cursor riconoscono direttamente Agent Plugins 1.0.0 e accettano .claude-plugin/marketplace.json come origine del marketplace. Il .cursor-plugin/plugin.json generato viene mantenuto per le versioni 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
OpenCode
Installa il pacchetto del plugin nel tuo progetto, quindi aggiungilo insieme al percorso delle sue skill a Riavvia OpenCode. Entrambi i server MCP vengono registrati automaticamente. Le skill richiedono la voce aggiuntiva Dovresti visualizzarle tutte e diciassette. Un percorso delle skill inesistente viene ignorato senza messaggi, quindi verifica invece di dare per scontato che siano state caricate.
opencode.json:skills.paths perché OpenCode non cerca le skill nei pacchetti installati.I percorsi relativi vengono risolti rispetto alla directory del progetto, quindi il pacchetto deve esistere in node_modules di quel progetto. Funziona anche un percorso assoluto e non richiede l’installazione locale.Verifica che le skill siano state caricate:VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clona il repository e registralo:Apri la vista Chat, vai su Plugins e aggiungi la cartella clonata. In alternativa, registrala in La chiave è un percorso, il valore lo abilita. Funzionano sia i percorsi assoluti sia
settings.json:~/; i percorsi relativi vengono risolti rispetto a ogni cartella del workspace. L’impostazione viene letta in tempo reale, quindi una finestra già aperta la applica senza riavvio.chat.pluginLocations è contrassegnato come sperimentale ed è un’impostazione con restrizioni, quindi il workspace deve essere considerato attendibile. Il supporto per gli agent plugin è una funzionalità in anteprima regolata da chat.plugins.enabled, attivo per impostazione predefinita.Kiro
Kiro
Kiro legge nativamente il manifest di Agent Plugins.Le skill vengono caricate da
1
Clone the repository
2
Open the Powers panel
In Kiro, apri il pannello Powers (l’icona Ghosty con il fulmine).
3
Import the folder
Scegli Add Custom Power → Import power from a folder, seleziona la directory clonata (quella contenente
plugin.json) e fai clic su Install.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 (MCP only)
Gemini CLI non dispone di una primitiva agent-skill, quindi sono disponibili solo i due server MCP. Riavvia Gemini CLI.
dodo-knowledge copre buona parte delle funzionalità offerte dalle skill e rimane automaticamente aggiornato.gemini-extension.json nella root del repository è il manifest.Cosa ottieni
Dopo l’installazione, il tuo agent ha accesso a due server MCP e diciassette skill.Server MCP
Entrambi i server utilizzano Streamable HTTP. Il
mcp.json canonico li dichiara nativamente, ed è utilizzato dai client conformi alla specifica, come Codex CLI e Kiro. Il manifest di compatibilità generato .mcp.json li collega tramite mcp-remote per i client che non possono comunicare direttamente con Streamable HTTP.
Agent skill
Le skill vengono caricate automaticamente: il tuo agent sceglie quella appropriata 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:webhook-integration, utilizzerà MCP dodo-knowledge per recuperare le forme più recenti dei payload e scriverà un handler con verifica della signature, seguendo la specifica Standard Webhooks.
Supporto dei client
Agent con installazione del plugin
Una sola installazione collega entrambi i server MCP e aggiunge le skill a ogni client che dispone di una primitiva per le skill.
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 di Agent Plugin. Configura manualmente i due server MCP e aggiungi le skill tramite Skills CLI, quando supportato.Documentazione creata per gli agent
Ogni pagina della documentazione di Dodo Payments è disponibile in un formato ottimizzato per il consumo 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
.mda qualsiasi URL della documentazione per ottenere la versione Markdown non elaborata (ad esempio,/api-reference/introduction.md) - Repository sorgente:
github.com/dodopayments/dodo-docs— clonalo per l’indicizzazione offline
Cosa può fare il tuo agent
Con il plugin installato, il tuo coding agent può:- Creare checkout session e payment link — Pagamenti una tantum e subscription
- Configurare il billing basato su subscription e utilizzo end-to-end — Subscription, billing basato sull’utilizzo, billing basato sui crediti
- Generare handler conformi a Standard Webhooks con verifica della signature — Webhook
- Montare route handler nel tuo framework utilizzando gli adapter ufficiali — Adapter per framework
- Collegare i componenti React di BillingSDK per tabelle dei prezzi e gestione delle subscription — BillingSDK
- Creare flussi con chiavi di licenza per prodotti digitali — Chiavi di licenza
- Implementare il billing basato sui crediti con entitlement, saldi, rollover e overage — Crediti
- Creare e gestire il catalogo prodotti con add-on e raccolte — Prodotti, Add-on, 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, contestazioni e self-service dei clienti — Rimborsi, Contestazioni, Customer portal
- Testare l’integrazione e andare live in sicurezza — Test mode e live mode
Sicurezza e best practice
- Utilizza prima la test mode. Crea e testa la tua integrazione con una API key di test prima di andare live. Consulta Test Mode e Live Mode.
- OAuth è l’impostazione predefinita. Agent Plugin esegue l’autenticazione tramite OAuth nel browser (senza secret locali). Utilizza la modalità con API key solo quando necessario.
- Esamina il codice generato dall’agent. Verifica sempre che gli handler dei webhook includano la verifica della signature seguendo la specifica Standard Webhooks.
Configura con una API Key
Per impostazione predefinita, Agent Plugin utilizza il server MCP remoto con OAuth tramite browser. Per utilizzare invece una API key locale, ad esempio in CI o su un server headless, passa alla modalità stdio.Local API key mode — Claude Code
Local API key mode — Claude Code
Apri Esegui
/plugins in Claude Code, seleziona Dodo Payments e scegli Configure options. Inserisci:dodo_api_key— la tua API key in test mode o live modedodo_webhook_key— il tuo secret per la firma dei webhookdodo_environment—test_modeolive_mode
.mcp.json per indirizzare dodopayments-api al server stdio locale:/reload-plugins per applicare le modifiche.Local API key mode — OpenCode
Local API key mode — OpenCode
Dichiara personalmente Riavvia OpenCode per applicare le modifiche.
dodopayments-api in opencode.json — la tua voce ha la precedenza sul server remoto predefinito del plugin:Prossimi passi
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 agent
API Reference
Riferimento OpenAPI completo per tutti gli endpoint di Dodo Payments