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:- Docs Search Tool: interroga la documentazione sull’API e sull’SDK di Dodo Payments per comprendere le operazioni e i parametri disponibili.
- Code Execution Tool: scrive codice TypeScript contro l’SDK che viene eseguito in un ambiente sandbox sicuro.
Configurazione rapida
Connettiti al server Dodo Payments MCP nel tuo client AI:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Il Dodo Agent Plugin installa sia i server MCP che tutte le otto competenze in un solo passaggio per Claude Code, Codex CLI, Cursor e OpenCode. Vedi la guida agli AI Coding Agents per i comandi di installazione per agente.Se il tuo agente non è in questo elenco, usa le schede di seguito per configurare direttamente il server MCP.
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:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Aggiungi a
~/.cursor/mcp.json: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:| Server | Scopo | Caso d’uso |
|---|---|---|
| Dodo Knowledge MCP | Ricerca documentazione | ”Come gestisco i webhook?”, “Quali metodi di pagamento sono supportati?” |
| Dodo Payments MCP | Operazioni API | Creare pagamenti, gestire abbonamenti, trattare rimborsi |
Risoluzione dei problemi di Knowledge MCP
Se riscontri problemi di connessione:- Cancella cache di autenticazione MCP:
rm -rf ~/.mcp-auth - Riavvia la tua applicazione client
- Controlla i log del client per messaggi di errore
- 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.Access the remote server
Naviga a https://mcp.dodopayments.com nel tuo browser.
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:
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
Pacchetto NPM
Installa ed esegui il server MCP localmente usando NPM.- NPX (No Installation)
- MCP Client Configuration
Docker
Esegui il server MCP in un ambiente containerizzato per un deployment coerente.Le immagini Docker sono disponibili su GitHub Container Registry.
Configurazione del client
Configura il server MCP di Dodo Payments nel tuo client AI preferito.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
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:[
](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 manualeOpen Cursor settings
Naviga a Cursor Settings > Features > Model Context Protocol oppure premi
Cmd/Ctrl + Shift + P e cerca “MCP Settings”.Add Dodo Payments configuration
Scegli una delle seguenti configurazioni:Server remoto (Consigliato)NPX locale
Variabili d’ambiente
Configura il comportamento del server MCP utilizzando variabili d’ambiente.| Variabile | Descrizione | Richiesto |
|---|---|---|
DODO_PAYMENTS_API_KEY | La tua chiave API Dodo Payments | Sì |
DODO_PAYMENTS_WEBHOOK_KEY | La tua chiave di firma webhook | No |
DODO_PAYMENTS_ENVIRONMENT | Imposta su live_mode per la produzione | No |
Esecuzione Remota
Distribuisci il server MCP come server HTTP remoto per client basati sul web o flussi di lavoro agentici.Configurazione del Server Remoto
Una volta distribuito, i client possono connettersi utilizzando l’URL del server:Headers di Autorizzazione
Il server remoto accetta l’autenticazione tramite i seguenti headers:| Header | Descrizione |
|---|---|
Authorization | Autenticazione token Bearer |
x-dodo-payments-api-key | Header 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.API Key Management
API Key Management
Non committare mai credenziali al controllo versioneMemorizza le chiavi API in variabili d’ambiente o sistemi di gestione segreti sicuri.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.
Access Control
Access Control
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.Network Security
Network Security
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
Connection issues
Connection issues
Verifica la tua chiave APIAssicurati che la tua chiave API sia correttamente impostata e abbia le permessi necessari.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.
Authentication errors
Authentication errors
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.Tool execution failures
Tool execution failures
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