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.

Overview

The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and APIs. The Dodo Payments MCP Server provides AI assistants like Claude, Cursor, and other MCP-compatible clients with structured access to your payment infrastructure. Il server Dodo Payments MCP utilizza l’architettura Code Mode. Invece di esporre centinaia di strumenti individuali per ogni endpoint API, Code Mode consente agli agenti AI di scrivere ed eseguire codice TypeScript contro l’SDK Dodo Payments in un ambiente sandbox isolato.

Key capabilities

  • Payment Operations: Create, retrieve, and manage payments and refunds
  • Subscription Management: Handle recurring billing, upgrades, and cancellations
  • Customer Administration: Manage customer data and portal access
  • Product Catalog: Create and update products, pricing, and discounts
  • License Management: Activate, validate, and manage software licenses
  • Usage-Based Billing: Track and bill for metered usage

How Code Mode Works

Il server Dodo Payments MCP fornisce al tuo agente AI esattamente due strumenti:
  1. Docs Search Tool: interroga la documentazione sull’API e sull’SDK di Dodo Payments per comprendere le operazioni e i parametri disponibili.
  2. Code Execution Tool: scrive codice TypeScript contro l’SDK che viene eseguito in un ambiente sandbox sicuro.
Questa architettura consente agli agenti di eseguire operazioni complesse e multi-step in un’unica invocazione. Ad esempio, un agente può elencare tutte le sottoscrizioni attive, filtrarle in base a criteri specifici e applicare uno sconto a ciascuna, tutto all’interno di uno script.
Usando Code Mode, gli agenti possono concatenare più chiamate API, gestire la logica condizionale ed eseguire calcoli senza richiedere molteplici round-trip al LLM.

Configurazione rapida

Connettiti al server Dodo Payments MCP nel tuo client AI:
Richiede Node.js 18 o superiore. Il server remoto utilizza OAuth per l’autenticazione — ti verrà richiesto di inserire la tua chiave API e selezionare il tuo ambiente alla prima connessione.

Dodo Knowledge MCP

Oltre al Dodo Payments MCP Server (per l’esecuzione delle operazioni API), forniamo Dodo Knowledge MCP—un server di ricerca semantica che offre agli assistenti AI accesso immediato alla documentazione e alla knowledge base di Dodo Payments.
Costruito con ContextMCP.ai: Dodo Knowledge MCP è alimentato da ContextMCP, consentendo una rapida ricerca semantica nella nostra documentazione utilizzando incorporamenti vettoriali.

Cos’è Dodo Knowledge MCP?

Dodo Knowledge MCP è un server MCP remoto che fornisce:
  • Ricerca semantica nella documentazione: Trova documentazione pertinente utilizzando query in linguaggio naturale.
  • Risposte contestuali: Gli assistenti AI ottengono informazioni accurate e aggiornate su Dodo Payments.
  • Nessuna configurazione: Nessuna chiave API o installazione locale richiesta—basta connettersi e iniziare a interrogare.

Configurazione rapida

Collegati a Dodo Knowledge MCP nel tuo client AI:
Aggiungi a ~/.cursor/mcp.json:
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}
Richiede Node.js 18 o superiore. Il pacchetto mcp-remote gestisce la connessione al server MCP remoto.

Utilizzo di entrambi i server MCP insieme

Per la migliore esperienza di sviluppo assistita da AI, si consiglia di utilizzare entrambi i server MCP:
ServerScopoCaso d’uso
Dodo Knowledge MCPRicerca documentazione”Come gestisco i webhook?”, “Quali metodi di pagamento sono supportati?”
Dodo Payments MCPOperazioni APICreare pagamenti, gestire abbonamenti, trattare rimborsi
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Con entrambi i server configurati, il tuo assistente AI può prima cercare documentazione per capire come implementare una funzione, quindi eseguire le chiamate API effettive—tutto in una singola conversazione.

Risoluzione dei problemi di Knowledge MCP

Se riscontri problemi di connessione:
  1. Cancella cache di autenticazione MCP: rm -rf ~/.mcp-auth
  2. Riavvia la tua applicazione client
  3. Controlla i log del client per messaggi di errore
  4. Verifica la versione di Node.js: Richiede Node.js 18+

Knowledge MCP Server

Accedi alla pagina di configurazione di Dodo Knowledge MCP

Installazione

Scegli il metodo di installazione che meglio si adatta al tuo flusso di lavoro.

Server MCP remoto (Consigliato)

Accedi al server MCP ospitato senza alcuna configurazione o installazione locale. Questo è il modo più veloce per iniziare.
1

Access the remote server

Naviga a https://mcp.dodopayments.com nel tuo browser.
2

Configure your MCP client

Copia la configurazione JSON fornita per il tuo client specifico. Per Cursor o Claude Desktop, aggiungi questo alle tue impostazioni MCP:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

Authenticate and configure

Il flusso OAuth ti chiederà di:
  • Inserire la tua chiave API Dodo Payments
  • Selezionare il tuo ambiente (test o live)
  • Scegliere il tipo di client MCP
Mantieni la tua chiave API sicura. Usa le chiavi modalità test durante lo sviluppo.
4

Complete setup

Clicca Login e Approva per autorizzare la connessione.
Una volta connesso, il tuo assistente AI può interagire con l’API di Dodo Payments a tuo nome.

Pacchetto NPM

Installa ed esegui il server MCP localmente usando NPM.
# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"

# Run the latest version
npx -y dodopayments-mcp@latest
Usa @latest per ottenere sempre l’ultima versione, oppure imposta una versione specifica come @1.0.0 per stabilità.

Docker

Esegui il server MCP in un ambiente containerizzato per un deployment coerente.
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="live_mode" \
  ghcr.io/dodopayments/mcp:latest
Le immagini Docker sono disponibili su GitHub Container Registry.

Configurazione del client

Configura il server MCP di Dodo Payments nel tuo client AI preferito.
Imposta il server MCP di Dodo Payments in Cursor per abilitare l’accesso conversazionale ai tuoi dati di pagamento.Installazione con un clicUsa il pulsante qui sotto per installare il server MCP direttamente in Cursor:[Aggiungi a Cursor](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Dopo aver cliccato, imposta le tue variabili d’ambiente in mcp.json di Cursor attraverso Cursor Settings > Tools & MCP > New MCP Server.Configurazione manuale
1

Open Cursor settings

Naviga a Cursor Settings > Features > Model Context Protocol oppure premi Cmd/Ctrl + Shift + P e cerca “MCP Settings”.
2

Edit configuration

Clicca Edit Config per aprire il file mcp_config.json.
3

Add Dodo Payments configuration

Scegli una delle seguenti configurazioni:Server remoto (Consigliato)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
NPX locale
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}
4

Save and restart

Salva il file di configurazione e riavvia Cursor.
Verifica la connessione chiedendo all’assistente AI informazioni sui tuoi dati di Dodo Payments.

Variabili d’ambiente

Configura il comportamento del server MCP utilizzando variabili d’ambiente.
VariabileDescrizioneRichiesto
DODO_PAYMENTS_API_KEYLa tua chiave API Dodo Payments
DODO_PAYMENTS_WEBHOOK_KEYLa tua chiave di firma webhookNo
DODO_PAYMENTS_ENVIRONMENTImposta su live_mode per la produzioneNo

Esecuzione Remota

Distribuisci il server MCP come server HTTP remoto per client basati sul web o flussi di lavoro agentici.
# Start as remote server
npx -y dodopayments-mcp --transport=http

# Specify a custom port
npx -y dodopayments-mcp --transport=http --port=3000

Configurazione del Server Remoto

Una volta distribuito, i client possono connettersi utilizzando l’URL del server:
{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Headers di Autorizzazione

Il server remoto accetta l’autenticazione tramite i seguenti headers:
HeaderDescrizione
AuthorizationAutenticazione token Bearer
x-dodo-payments-api-keyHeader diretto chiave API

Migliori pratiche di Sicurezza

Code Mode fornisce sicurezza intrinseca eseguendo il codice in un ambiente isolato e iniettando le chiavi API lato server. Segui queste pratiche migliori per proteggere le tue credenziali.
Non committare mai credenziali al controllo versioneMemorizza le chiavi API in variabili d’ambiente o sistemi di gestione segreti sicuri.
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
Rota le chiavi regolarmenteGenera periodicamente nuove chiavi API e revoca le vecchie tramite la tua dashboard di Dodo Payments.Usa chiavi di test per lo sviluppoUsa sempre chiavi API modalità test durante lo sviluppo per evitare di alterare i dati di produzione.
Implementa autenticazione per i server remotiDurante la distribuzione remota, richiedi sempre l’autenticazione tramite l’header Authorization o x-dodo-payments-api-key.Monitora l’uso dell’APITraccia l’attività del server MCP attraverso la tua dashboard di Dodo Payments e configura avvisi per modelli insoliti.
Usa HTTPS per i server remotiDistribuisci sempre i server MCP remoti dietro endpoint HTTPS.Implementa limiti di frequenzaProteggi contro gli abusi implementando limiti di frequenza sia a livello del server MCP che API.Restringi l’accesso alla reteConfigura regole firewall per limitare quali client possono connettersi al tuo server MCP.

Risoluzione dei Problemi

Verifica la tua chiave APIAssicurati che la tua chiave API sia correttamente impostata e abbia le permessi necessari.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments
Controlla la tua connessione di reteVerifica che puoi raggiungere gli endpoint API di Dodo Payments.Rivedi i log del clientAbilita la registrazione dettagliata nel tuo client MCP per diagnosticare problemi di connessione.
Conferma l’ambiente della chiave APIAssicurati di usare chiavi di test con endpoint di test e chiavi live con endpoint di produzione.Controlla la variabile d’ambienteVerifica che DODO_PAYMENTS_ENVIRONMENT sia impostato correttamente (live_mode per la produzione).Rigenera le credenzialiSe i problemi persistono, genera una nuova chiave API tramite la tua dashboard.
Valida i parametri di inputAssicurati che l’assistente AI fornisca parametri correttamente formattati per ciascun strumento.Rivedi i messaggi di erroreControlla la risposta di errore dell’API per una guida specifica su cosa è andato storto.Prova direttamente con l’APIVerifica che l’operazione funzioni chiamando direttamente l’API di Dodo Payments via curl o Postman.

Perché Code Mode

Le implementazioni tradizionali di MCP soffrono spesso di “proliferazione degli strumenti,” dove ogni endpoint API è esposto come uno strumento separato. Code Mode è un approccio superiore per diversi motivi:

Gli LLM sono migliori a scrivere codice che a chiamare strumenti

Gli LLM sono stati addestrati su milioni di righe di codice del mondo reale, rendendoli naturalmente abili a scrivere script. Al contrario, la chiamata agli strumenti è spesso basata su esempi sintetici.
“Far eseguire compiti a un LLM con la chiamata agli strumenti è come sottoporre Shakespeare a un corso intensivo di un mese in mandarino e poi chiedergli di scrivere un’opera in quella lingua.” — Cloudflare

Elimina il gonfiore della finestra contestuale

In un approccio tradizionale, ogni definizione di strumento consuma token prima ancora che la conversazione inizi. Esporre 50+ strumenti può facilmente consumare 55K–100K+ token. Anthropic ha scoperto che le definizioni di strumento potevano consumare fino a 134K token prima dell’ottimizzazione. Con Code Mode, solo 2 definizioni di strumento vengono caricate (~1K token). L’agente ricerca la documentazione necessaria su richiesta. Il Tool Search Tool di Anthropic ha conservato il 95% della finestra contestuale, riducendo l’overhead da 77K a 8.7K token.

Riduce la latenza attraverso l’orchestrazione programmatica

La chiamata agli strumenti tradizionale richiede un round-trip di inferenza completa del modello per ogni singola operazione. Se un compito richiede 20 chiamate API, sono 20 round-trip. In Code Mode, l’agente scrive uno script che esegue tutte le chiamate e restituisce solo il risultato finale. Anthropic ha osservato una riduzione del 37% dei token e un miglioramento della precisione (il recupero delle conoscenze è migliorato dal 25,6% al 28,5%) utilizzando questo approccio programmatico.

Più sicuro per design

Code Mode fornisce vantaggi di sicurezza intrinseci:
  • Nessuna chiave API nei parametri: Le chiavi API vengono iniettate lato server e non vengono mai esposte nei parametri degli strumenti inviati agli LLM.
  • Sandbox isolato: Il codice viene eseguito in un ambiente sicuro senza accesso alla rete o al file system host.
  • SDK controllato: Solo i metodi SDK autorizzati sono disponibili per l’agente.

Scala a qualsiasi dimensione API

Man mano che un’API cresce, le prestazioni tradizionali del MCP degradano perché più strumenti devono essere caricati nel contesto. Code Mode rimane costante con 2 strumenti indipendentemente dall’area dell’API. Cloudflare ha ridotto con successo oltre 2.500 endpoint API in soli 2 strumenti e circa 1.000 token di contesto.
Per i dettagli sui benefici di questa architettura, vedi i blog ingegneristici di Anthropic e Cloudflare, e la documentazione di Programmatic Tool Calling di Claude.

Risorse

API Reference

Esplora la documentazione completa dell’API di Dodo Payments

MCP Protocol

Scopri di più sullo standard del Model Context Protocol

GitHub Repository

Visualizza il codice sorgente del server MCP e contribuisci

NPM Package

Installa il server MCP da NPM
Last modified on May 4, 2026