Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Il plugin Dodo Agent connette due server MCP e otto competenze di integrazione nel tuo agente di codifica AI in un’unica installazione. Funziona con Claude Code, Codex CLI, Cursor e OpenCode — e i server MCP e la CLI delle competenze funzionano con qualsiasi client compatibile con MCP.
Tre primitive, un plugin. Il plugin Agent raccoglie tutto ciò di cui hai bisogno:
  • Server API MCP — accesso live a pagamenti, abbonamenti, clienti, prodotti, rimborsi, licenze e utilizzo. Autenticazione tramite OAuth del browser (non sono necessarie chiavi locali).
  • Server di conoscenza MCP — ricerca semantica in tutta la documentazione di Dodo Payments. Nessuna credenziale necessaria.
  • Otto competenze degli agenti — schede di riferimento rapido che il tuo agente carica su richiesta per checkout, abbonamenti, webhook, fatturazione basata sull’uso, fatturazione basata su crediti, chiavi di licenza, BillingSDK e best practices.

​
Installa il plugin

Scegli il tuo agente di codifica qui sotto. L’installazione aggiunge automaticamente entrambi i server MCP e tutte e otto le competenze.

Claude Code

Installa dal marketplace:
claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments
Il server API MCP utilizza di default OAuth del browser — non sono necessarie chiavi al momento dell’installazione. Alla prima chiamata di uno strumento Dodo da parte del tuo agente, ti verrà chiesto 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 tua shell, poi installa il plugin dall’interno del TUI di Codex.
1

Register the marketplace

codex plugin marketplace add dodopayments/dodo-agent-plugin
2

Install from the Codex TUI

Apri Codex ed esegui il comando slash /plugins:
codex
Poi digita /plugins, passa al marketplace Dodo Payments, seleziona il plugin dodopayments e scegli Installa plugin.
Entrambi i server MCP e tutte le otto competenze 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 in-TUI /plugins. Vedi la documentazione ufficiale dei plugin di Codex.
Se hai precedentemente aggiunto il marketplace e il plugin non appare sotto /plugins, aggiornalo:
codex plugin marketplace upgrade dodopayments
Installazione manuale — clona il repository nella directory dei plugin locali di Cursor:
git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin
Riavvia Cursor. Il plugin carica le competenze da .claude/skills/ (tramite il layer di compatibilità Claude Code di Cursor) e i server MCP da .mcp.json.
Il supporto marketplace per Cursor è in arrivo. Per ora, usa l’installazione manuale sopra descritta.
OpenCode distribuisce tramite npm. Aggiungi il plugin al tuo opencode.json:
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"]
}
Riavvia OpenCode. Entrambi i server MCP (dodopayments-api, dodo-knowledge) sono registrati automaticamente tramite il gancio di configurazione del plugin, e le otto competenze vengono scoperte automaticamente dal pacchetto installato. Non è necessario alcun blocco mcp manuale.
Usi un agente diverso? Le guide MCP Server e Agent Skills coprono Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed e qualsiasi client compatibile con MCP.

​
Cosa ottieni

Una volta installato il plugin, il tuo agente ha accesso a due server MCP e otto competenze.

​
Server MCP

ServerScopoAutenticazione
dodopayments-apiAccesso API live — pagamenti, abbonamenti, clienti, prodotti, rimborsi, licenze, utilizzoOAuth (browser)
dodo-knowledgeRicerca semantica in tutta la documentazione di Dodo PaymentsNessuna
Entrambi i server sono connessi tramite mcp-remote in modo da funzionare con qualsiasi client compatibile con MCP.

​
Competenze dell’agente

CompetenzaDescrizione
best-practicesGuida completa all’integrazione dei Dodo Payments con le migliori pratiche
checkout-integrationCreazione di sessioni di checkout e flussi di pagamento
subscription-integrationImplementazione di flussi di fatturazione per abbonamenti
webhook-integrationConfigurazione e gestione dei webhook per eventi di pagamento
usage-based-billingImplementazione di fatturazione misurata con eventi e contatori
credit-based-billingDiritto ai crediti, saldi e deduzione di crediti misurati
license-keysGestione delle chiavi di licenza per prodotti digitali
billing-sdkUtilizzo dei componenti React di BillingSDK
Le competenze si caricano automaticamente — il tuo agente sceglie quella giusta quando rileva un compito pertinente. Vedi la documentazione delle competenze dell’agente per l’elenco completo e l’installazione individuale.

​
Prova questo prompt prima

Una volta che il plugin è attivo, prova: 
Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.
Il tuo agente caricherà la competenza webhook-integration, userà il server MCP dodo-knowledge per ottenere le forme di payload più recenti e scriverà un gestore con verifica della firma seguendo la specifica Standard Webhooks.

​
Altri agenti supportati

Il plugin Agent copre Claude Code, Codex CLI, Cursor e OpenCode. Se utilizzi un altro agente, connettiti a Dodo Payments tramite i server MCP e la CLI delle competenze:
AgentePercorso più veloceSupporta anche
Claude CodePlugin Agent (un comando)Server MCP, competenze individuali
Codex CLIPlugin Agent (un comando)Server MCP
CursorPlugin Agent (git clone)Configurazione del server MCP, CLI delle competenze
OpenCodePlugin Agent (npm)Configurazione del server MCP, CLI delle competenze
GitHub Copilot (VS Code)Guida MCP ServerCLI delle competenze
Claude DesktopGuida MCP Server—
WindsurfGuida MCP ServerCLI delle competenze
Cline / Zed / altriGuida MCP ServerCLI delle competenze

​
Documenti costruiti per agenti

Ogni pagina della documentazione di Dodo Payments è disponibile in un formato ottimizzato per il consumo AI:
  • Indice completo dei documenti: docs.dodopayments.com/llms.txt — fornisce l’indice completo della documentazione per l’ingestione contestuale.
  • Markdown semplice: Aggiungi .md a qualsiasi URL della documentazione per ottenere la versione raw markdown (ad es., /api-reference/introduction.md).
  • Repository di origine: github.com/dodopayments/dodo-docs — clona per l’indicizzazione offline.

​
Cosa può fare il tuo agente

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

​
Sicurezza e migliori pratiche

Non commettere mai chiavi API di produzione. Usa modalità test durante lo sviluppo. Il plugin Agent utilizza di default OAuth del browser — passa alle chiavi API locali solo se il tuo flusso di lavoro lo richiede.
  • Usa prima la modalità test. Sandbox la tua integrazione con chiavi dodo_test_... prima di andare live. Vedi Modalità test vs Modalità live.
  • OAuth è il default. Il plugin Agent si autentica tramite OAuth del browser (nessun segreto locale). Usa la modalità chiave API solo se necessario — vedi la sezione Configura sotto.
  • Rivedi il codice generato dall’agente. Verifica sempre che i gestori dei webhook includano la verifica della firma secondo la standard Webhooks spec.

​
Configurare con una chiave API

Di default, il plugin Agent utilizza il server remoto MCP con OAuth del browser — nessuna credenziale locale necessaria. Se il tuo flusso di lavoro richiede una chiave API locale (es., ambienti CI, server senza testa), puoi passare alla modalità stdio.
Apri /plugins in Claude Code, seleziona Dodo Payments e scegli Configura opzioni. Compila:
  • dodo_api_key — la tua chiave dodo_test_... o dodo_live_...
  • dodo_webhook_key — il tuo segreto di firma del webhook
  • dodo_environment — test_mode o live_mode
Poi modifica .mcp.json per puntare 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 alla tua sessione corrente.
Dichiara dodopayments-api da solo in opencode.json — la tua voce prevarrà 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": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}
Riavvia OpenCode per applicare.

​
Passi successivi

MCP Server

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

Agent Skills

Installazione individuale delle competenze, riferimento delle competenze e istruzioni per la configurazione per agente

Sentra IDE Assistant

Assistente di fatturazione AI-powered per VS Code, Cursor e Windsurf — chiedi, costruisci e pianifica nel tuo editor

API Reference

Riferimento completo OpenAPI per tutti gli endpoint di Dodo Payments
Last modified on May 14, 2026