plugin.json e mcp.json. I client precedenti alla specifica caricano gli stessi contenuti tramite manifest di compatibilità generati.
Tre primitive, un plugin. L’Agent Plugin include tutto ciò di cui hai bisogno:
- Server MCP API — accesso in tempo reale a pagamenti, abbonamenti, clienti, prodotti, rimborsi, licenze e utilizzo. Esegue l’autenticazione tramite OAuth nel browser (non sono necessarie chiavi locali).
- Server MCP Knowledge — ricerca semantica in tutta la documentazione di Dodo Payments. Non sono necessarie credenziali.
- Diciassette skill per agent — schede di riferimento che il tuo agent carica su richiesta per checkout, abbonamenti, webhook, fatturazione basata sull’utilizzo e sui crediti, chiavi di licenza, catalogo prodotti, sconti, prezzi localizzati, checkout mobile, rimborsi e contestazioni, gestione dei clienti, adattatori 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, tranne Gemini CLI, aggiungono anche le diciassette skill.Claude Code
Claude Code
Installa dal marketplace:Il server MCP API usa OAuth nel 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à richiesto di accedere.
Dodo Agent Plugin on GitHub
Codice sorgente, opzioni di configurazione e istruzioni per lo sviluppo locale
Codex CLI
Codex CLI
Codex installa i plugin in due passaggi: registra il marketplace dalla shell, quindi installa il plugin dall’interno della TUI di Codex.Entrambi i server MCP e tutte le diciassette skill vengono registrati automaticamente una volta installato il plugin.Se hai già aggiunto il marketplace e il plugin non compare sotto
1
Register the marketplace
2
Install from the Codex TUI
Apri Codex ed esegui il comando slash Digita quindi
/plugins:/plugins, passa al marketplace Dodo Payments, seleziona il plugin dodopayments e scegli Install plugin.Codex CLI non dispone di un sottocomando
codex plugin install: l’installazione del plugin avviene sempre tramite il flusso /plugins nella TUI. Consulta la documentazione ufficiale sui plugin di Codex./plugins, aggiornalo:Cursor
Cursor
Installazione manuale — 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, come dichiarato in .cursor-plugin/plugin.json.Le build recenti di Cursor riconoscono direttamente anche Agent Plugins 1.0.0 e accettano
.cursor-plugin/marketplace.json o .claude-plugin/marketplace.json come origine del marketplace. Questo plugin include .claude-plugin/marketplace.json — usa quel percorso. .cursor-plugin/plugin.json, generato automaticamente, viene mantenuto per le build precedenti.OpenCode
OpenCode
OpenCode viene distribuito tramite npm. Aggiungi il plugin al tuo Riavvia OpenCode. Entrambi i server MCP (Le voci
opencode.json:dodopayments-api, dodo-knowledge) vengono registrati automaticamente tramite l’hook di configurazione del plugin. Non è necessario alcun blocco mcp manuale.Le skill richiedono una riga aggiuntiva. OpenCode non analizza i pacchetti installati alla ricerca delle skill, quindi indica manualmente la directory skills/ del pacchetto:skills.paths relative vengono risolte rispetto alla directory del progetto, quindi il pacchetto deve trovarsi nella node_modules di quel progetto — la cache dei plugin di OpenCode si trova in una posizione diversa. Funziona anche un percorso assoluto, che evita il requisito dell’installazione locale.VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clona il repository in una posizione qualsiasi, quindi registralo:Apri la vista Chat, vai su Plugins e aggiungi la cartella clonata. Puoi anche registrarla direttamente in La chiave è un percorso, il valore lo abilita. Funzionano sia i percorsi assoluti sia
settings.json:~/; un percorso relativo viene risolto rispetto a ogni cartella del workspace. L’impostazione viene letta in tempo reale, quindi una finestra già in esecuzione la acquisisce senza riavvio. Le skill vengono caricate da skills/, mentre entrambi i server MCP vengono caricati da .mcp.json.chat.pluginLocations è contrassegnato come sperimentale ed è un’impostazione limitata, quindi il workspace deve essere considerato attendibile perché abbia effetto. Il supporto agli agent plugin nel suo complesso è una funzionalità in anteprima regolata da chat.plugins.enabled, attiva per impostazione predefinita — devi impostarla solo se la tua organizzazione la disabilita tramite policy.VS Code non utilizza
$schema di Agent Plugins come chiave. Il suo loader cerca prima .plugin/plugin.json, poi .claude-plugin/plugin.json e infine una root plugin.json; inoltre imposta MCP su .mcp.json invece che su mcp.json. Poiché questo repository include un .claude-plugin/plugin.json generato, VS Code lo carica tramite quel ramo di compatibilità e utilizza il bridge mcp-remote invece dei transport nativi in mcp.json. Funziona tutto — cambia il percorso.Kiro
Kiro
Kiro legge nativamente il manifest di Agent Plugins e lo carica come Power.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 che contiene
plugin.json) e fai clic su Install.skills/, i server MCP da mcp.json e la presentazione specifica di Kiro proviene dal namespace di estensione dev.kiro in plugin.json.Per i plugin nel formato Agent Plugins, Kiro gestisce internamente i server MCP — non vengono scritti nel tuo
~/.kiro/settings/mcp.json a livello utente, quindi non aspettarti di trovarli lì. 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 — le diciassette skill non lo sono. Riavvia Gemini CLI.
dodo-knowledge copre comunque buona parte delle funzionalità offerte dalle skill e rimane aggiornato automaticamente.gemini-extension.json nella root del repository è il manifest.Usi un agent diverso? Le guide MCP Server e Agent Skills coprono Claude Desktop, Windsurf, Cline, Zed e qualsiasi client compatibile con MCP.
Cosa ottieni
Una volta installato il plugin, 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 (type: "streamable-http"), come utilizzato dai client nativi della specifica, ad esempio Codex CLI e Kiro. Il manifest di compatibilità generato .mcp.json collega invece gli stessi due endpoint tramite mcp-remote, consentendone l’esecuzione anche nei client che non possono connettersi direttamente a Streamable HTTP — Claude Code, VS Code e Cursor tramite l’installazione con git clone descritta sopra, il cui .cursor-plugin/plugin.json punta a .mcp.json.
Skill per agent
Le skill vengono caricate automaticamente: il tuo agent sceglie quella appropriata quando rileva un’attività pertinente. Consulta la documentazione Agent Skills per l’elenco completo e le istruzioni di installazione individuali.
Prova prima questo prompt
Una volta attivato il plugin, prova:webhook-integration, userà MCP dodo-knowledge per recuperare le forme più recenti dei payload e scriverà un handler con verifica della firma conforme alla specifica Standard Webhooks.
Supporto dei client
Client con installazione Agent Plugin
Una singola installazione collega entrambi i server MCP, oltre alle skill su ogni client che dispone di una primitiva per le skill.- OpenCode richiede una voce
skills.pathsaggiuntiva prima del caricamento delle sue diciassette skill — consulta la sezione di installazione sopra. - 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 Agent Plugin. Configura manualmente i due server MCP e aggiungi le skill tramite Skills CLI dove 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— fornisce l’indice completo della documentazione per l’acquisizione del contesto. - Markdown semplice: aggiungi
.mda qualsiasi URL della documentazione per ottenere la versione Markdown grezza (ad esempio,/api-reference/introduction.md). - Repository sorgente:
github.com/dodopayments/dodo-docs— clona il repository per l’indicizzazione offline.
Cosa può fare il tuo agent
Con il plugin installato, il tuo coding agent può:- Creare sessioni di checkout e link di pagamento — Pagamenti una tantum e abbonamenti
- Configurare la fatturazione per abbonamenti e basata sull’utilizzo end-to-end — Abbonamenti, Fatturazione basata sull’utilizzo, Fatturazione basata sui crediti
- Generare handler conformi a Standard Webhooks con verifica della firma — Webhooks
- Integrare gli handler di route nel tuo framework usando gli adattatori ufficiali — Adattatori per framework
- Integrare i componenti React di BillingSDK per le tabelle dei prezzi e la gestione degli abbonamenti — BillingSDK
- Creare flussi con chiavi di licenza per prodotti digitali — Chiavi di licenza
- Implementare la fatturazione basata 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
- Usa prima la test mode. Esegui il sandboxing dell’integrazione con le chiavi
dodo_test_...prima di andare live. Consulta Test Mode vs Live Mode. - OAuth è l’impostazione predefinita. L’Agent Plugin esegue l’autenticazione tramite OAuth nel browser (senza secret locali). Usa la modalità con API key solo se necessario — consulta la sezione Configura qui sotto.
- Esamina il codice generato dall’agent. Verifica sempre che gli handler webhook includano la verifica della firma secondo la specifica Standard Webhooks.
Configura con una API key
Per impostazione predefinita, l’Agent Plugin usa il server MCP remoto con OAuth nel browser — non sono necessarie credenziali locali. Se il tuo flusso di lavoro richiede una API key locale (ad esempio, ambienti CI o server headless), puoi passare 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 chiavedodo_test_...ododo_live_...dodo_webhook_key— il tuo secret di firma dei webhookdodo_environment—test_modeolive_mode
.mcp.json in modo che dodopayments-api punti al server stdio locale:/reload-plugins per applicare le modifiche alla sessione corrente.Local API key mode — OpenCode
Local API key mode — OpenCode
Dichiara Riavvia OpenCode per applicare la modifica.
dodopayments-api direttamente in opencode.json — la tua voce ha la precedenza sul server remoto predefinito del plugin:Prossimi passaggi
MCP Server
Riferimento completo per entrambi i server MCP — tutti i client supportati, la configurazione e gli strumenti disponibili
Agent Skills
Installazione delle singole skill, riferimento alle skill e istruzioni di configurazione per ogni agent
Sentra IDE Assistant
Assistente di fatturazione basato sull’AI per VS Code, Cursor e Windsurf — chiedi, crea e pianifica nel tuo editor
API Reference
Riferimento OpenAPI completo per tutti gli endpoint di Dodo Payments