Skip to main content
Il Dodo Agent Plugin integra due server MCP e diciassette skill di integrazione nel tuo AI coding agent con una singola installazione. Funziona con Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode. Gemini CLI riceve solo i due server MCP. I server MCP e la CLI delle skill funzionano con qualsiasi client compatibile con MCP. Il plugin segue la specifica Agent Plugins 1.0.0, quindi i client con supporto nativo lo caricano direttamente dalla root 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

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 installa i plugin in due passaggi: registra il marketplace dalla shell, quindi installa il plugin dall’interno della TUI di Codex.
1

Register the marketplace

2

Install from the Codex TUI

Apri Codex ed esegui il comando slash /plugins:
Digita quindi /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 una volta installato il 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.
Se hai già aggiunto il marketplace e il plugin non compare sotto /plugins, aggiornalo:
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.
Le versioni precedenti alla 0.5.0 includevano skills/ come symlink verso un git submodule, quindi questo clone produceva un plugin con skill non funzionanti. Ora le skill vengono incluse come file reali. Se hai installato una versione precedente, elimina la directory e clona nuovamente.
OpenCode viene distribuito tramite npm. Aggiungi il plugin al tuo opencode.json:
Riavvia OpenCode. Entrambi i server MCP (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:
Le voci 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.
Un percorso delle skill inesistente viene ignorato silenziosamente. Verifica invece di dare per scontato:
Dovresti visualizzarle tutte e diciassette. La documentazione delle versioni precedenti alla 0.5.0 indicava che queste skill venivano rilevate automaticamente — non era così, quindi gli utenti di OpenCode avevano i server MCP ma nessuna skill.
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 settings.json:
La chiave è un percorso, il valore lo abilita. Funzionano sia i percorsi assoluti sia ~/; 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 legge nativamente il manifest di Agent Plugins e lo carica come Power.
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.
Le skill vengono caricate da 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 non dispone di una primitiva agent-skill, quindi sono disponibili solo i due server MCP — le diciassette skill non lo sono. dodo-knowledge copre comunque buona parte delle funzionalità offerte dalle skill e rimane aggiornato automaticamente.
Riavvia Gemini CLI. 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:
Il tuo agent caricherà la skill 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.paths aggiuntiva 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 .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 — clona il repository per l’indicizzazione offline.

Cosa può fare il tuo agent

Con il plugin installato, il tuo coding agent può:

Sicurezza e best practice

Non eseguire mai il commit delle API keys di produzione. Usa la test mode durante lo sviluppo. L’Agent Plugin usa OAuth nel browser per impostazione predefinita — passa alle API keys locali solo se il tuo flusso di lavoro lo richiede.
  • 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.
Apri /plugins in Claude Code, seleziona Dodo Payments e scegli Configure options. Inserisci:
  • dodo_api_key — la tua chiave dodo_test_... o dodo_live_...
  • dodo_webhook_key — il tuo secret di firma dei webhook
  • dodo_environmenttest_mode o live_mode
Modifica quindi .mcp.json in modo che dodopayments-api punti al server stdio locale:
Esegui /reload-plugins per applicare le modifiche alla sessione corrente.
Dichiara dodopayments-api direttamente in opencode.json — la tua voce ha la precedenza sul server remoto predefinito del plugin:
Riavvia OpenCode per applicare la modifica.

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
Ultima modifica il 17 agosto 2026