Skip to main content
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. 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. Cosa ottieni:
  • 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

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
Registra il marketplace, quindi installa dal Codex TUI.
1

Register the marketplace

2

Install from the Codex TUI

Apri Codex ed esegui /plugins:
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:
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.
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.
Installa il pacchetto del plugin nel tuo progetto, quindi aggiungilo insieme al percorso delle sue skill a opencode.json:
Riavvia OpenCode. Entrambi i server MCP vengono registrati automaticamente. Le skill richiedono la voce aggiuntiva 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:
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.
Clona il repository e registralo:
Apri la vista Chat, vai su Plugins e aggiungi la cartella clonata. In alternativa, registrala in settings.json:
La chiave è un percorso, il valore lo abilita. Funzionano sia i percorsi assoluti sia ~/; 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 legge nativamente il manifest di Agent Plugins.
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.
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 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 automaticamente aggiornato.
Riavvia Gemini CLI. gemini-extension.json nella root del repository è il manifest.
Usi un agent diverso? Le guide MCP Server e Agent Skills trattano Claude Desktop, Windsurf, Cline, Zed e qualsiasi client compatibile con MCP.

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:
Il tuo agent caricherà la skill 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 .md a 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ò:

Sicurezza e best practice

Non eseguire mai il commit delle API key live. Utilizza la test mode durante lo sviluppo.
  • 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.
Apri /plugins in Claude Code, seleziona Dodo Payments e scegli Configure options. Inserisci:
  • dodo_api_key — la tua API key in test mode o live mode
  • dodo_webhook_key — il tuo secret per la firma dei webhook
  • dodo_environment — test_mode o live_mode
Modifica quindi .mcp.json per indirizzare dodopayments-api al server stdio locale:
Esegui /reload-plugins per applicare le modifiche.
Dichiara personalmente dodopayments-api in opencode.json — la tua voce ha la precedenza sul server remoto predefinito del plugin:
Riavvia OpenCode per applicare le modifiche.

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
Ultima modifica il 26 settembre 2026