Overview
Il Model Context Protocol (MCP) è uno standard aperto che consente alle applicazioni AI di connettersi a origini dati e API esterne. Dodo Payments MCP Server offre ad assistenti AI come Claude, Cursor e altri client compatibili con MCP l’accesso alla tua infrastruttura di pagamento. Dodo Payments MCP Server utilizza un’architettura Code Mode. Invece di esporre centinaia di strumenti individuali per ogni endpoint dell’API, Code Mode consente agli agenti AI di scrivere ed eseguire codice TypeScript sull’SDK di Dodo Payments in una sandbox isolata.Funzionalità principali
- Operazioni di pagamento — Crea, recupera e gestisci pagamenti e rimborsi
- Gestione degli abbonamenti — Gestisci fatturazione ricorrente, upgrade e cancellazioni
- Amministrazione dei clienti — Gestisci i dati dei clienti e l’accesso al portale
- Catalogo prodotti — Crea e aggiorna prodotti, prezzi e sconti
- Gestione delle licenze — Attiva, convalida e gestisci le licenze software
- Fatturazione basata sull’utilizzo — Monitora e fattura l’utilizzo misurato
How Code Mode Works
Dodo Payments MCP Server offre al tuo agente AI due strumenti:- Strumento di ricerca della documentazione — Interroga la documentazione sull’API e sull’SDK di Dodo Payments per comprendere le operazioni e i parametri disponibili.
- Strumento di esecuzione del codice — Scrive codice TypeScript basato sull’SDK, che viene eseguito in una sandbox sicura.
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 entrambi i server MCP e tutte le diciassette skill in un unico passaggio per Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode (OpenCode richiede un’impostazione
skills.paths aggiuntiva). Gemini CLI riceve solo i due server MCP, poiché non dispone di una primitiva agent-skill. Consulta la guida agli AI Coding Agents per i comandi di installazione specifici per ogni 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 versione successiva. Il server remoto utilizza OAuth per l’autenticazione. Alla prima connessione, ti verrà richiesto di inserire la tua API key e selezionare il tuo ambiente.
Dodo Knowledge MCP
Oltre a Dodo Payments MCP Server (per eseguire operazioni API), forniamo Dodo Knowledge MCP, un server di ricerca semantica che offre agli assistenti AI accesso immediato alla documentazione 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 la ricerca semantica nella documentazione. Trova la documentazione pertinente utilizzando query in linguaggio naturale, ottieni informazioni accurate e aggiornate su Dodo Payments e connettiti senza bisogno di API key o installazioni locali.Configurazione rapida
Connettiti a Dodo Knowledge MCP nel tuo client AI:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Aggiungi a
~/.cursor/mcp.json:Richiede Node.js 18 o versione successiva. Il pacchetto
mcp-remote gestisce la connessione al server MCP remoto.Utilizzo congiunto dei due server MCP
Per ottenere la migliore esperienza di sviluppo assistita dall’AI, utilizza entrambi i server MCP:Risoluzione dei problemi di Knowledge MCP
Se riscontri problemi di connessione, svuota la cache di autenticazione MCP conrm -rf ~/.mcp-auth, riavvia l’applicazione client, controlla i log del client per individuare eventuali messaggi di errore e verifica la versione di Node.js (è richiesta la versione 18 o successiva).
Knowledge MCP Server
Accedi alla pagina di configurazione di Dodo Knowledge MCP
Installazione
Scegli il metodo di installazione più adatto al tuo flusso di lavoro.Server MCP remoto (consigliato)
Accedi al server MCP ospitato senza configurazione o installazione locale.1
Access the remote server
Apri https://mcp.dodopayments.com nel browser.
2
Configure your MCP client
Copia la configurazione JSON fornita per il tuo client specifico. Per Cursor o Claude Desktop, aggiungila alle impostazioni MCP:
3
Authenticate and configure
Il flusso OAuth ti chiederà di:
- Inserire la tua API key di Dodo Payments
- Selezionare il tuo ambiente (test o live)
- Scegliere il tipo di client MCP
4
Complete setup
Fai clic su Login and Approve per autorizzare la connessione.
Una volta connesso, il tuo assistente AI potrà interagire con l’API di Dodo Payments per tuo conto.
Pacchetto NPM
Installa ed esegui il server MCP localmente.- NPX (No Installation)
- MCP Client Configuration
Docker
Esegui il server MCP in un container.Le immagini Docker sono disponibili su GitHub Container Registry.
Configurazione del client
Configura il server MCP Dodo Payments nel tuo client AI preferito.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
Configura il server MCP Dodo Payments in Cursor per abilitare l’accesso conversazionale ai tuoi dati di pagamento.Installazione con un clicUsa il pulsante seguente per installare direttamente il server MCP in Cursor:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Dopo aver fatto clic, imposta le variabili d’ambiente in
mcp.json di Cursor tramite Cursor Settings > Tools & MCP > New MCP Server.Configurazione manuale1
Open Cursor settings
Vai a Cursor Settings > Tools & MCP oppure premi
Cmd/Ctrl + Shift + P e cerca “MCP Settings”.2
Edit configuration
Fai clic su New MCP Server per aprire il file
mcp.json.3
Add Dodo Payments configuration
Scegli una delle seguenti configurazioni:Remote Server (Recommended)Local NPX
4
Save and restart
Salva il file di configurazione e riavvia Cursor.
Verifica la connessione chiedendo all’assistente AI informazioni sui tuoi dati di pagamento Dodo Payments.
Variabili d’ambiente
Configura il comportamento del server MCP usando le variabili d’ambiente.Esecuzione remota
Distribuisci il server MCP come server HTTP remoto per client basati sul web o flussi di lavoro agentici.Configurazione del server remoto
Dopo la distribuzione, i client possono connettersi usando l’URL del server:Header di autorizzazione
Il server remoto accetta l’autenticazione tramite i seguenti header:Best practice di sicurezza
Code Mode offre sicurezza intrinseca eseguendo il codice in un ambiente sandbox e iniettando le API key lato server. Segui queste best practice per proteggere le tue credenziali.API Key Management
API Key Management
Non eseguire mai il commit delle credenziali nel controllo versione. Archivia le API key nelle variabili d’ambiente o in sistemi sicuri di gestione dei segreti:Ruota regolarmente le chiavi generando periodicamente nuove API key e revocando quelle vecchie tramite la dashboard di Dodo Payments. Usa sempre API key in modalità test durante lo sviluppo per evitare di modificare i dati di produzione.
Access Control
Access Control
Quando esegui la distribuzione remota, richiedi sempre l’autenticazione tramite l’header
Authorization o l’header x-dodo-payments-api-key.Network Security
Network Security
Distribuisci sempre i server MCP remoti dietro endpoint HTTPS. Proteggiti dagli abusi implementando limiti di frequenza sia a livello di server MCP sia a livello di API. Configura le regole del firewall per limitare i client che possono connettersi al server MCP.
Risoluzione dei problemi
Connection issues
Connection issues
Verifica che la tua API key sia impostata correttamente e disponga delle autorizzazioni necessarie:Verifica di poter raggiungere gli endpoint API di Dodo Payments. Abilita il logging dettagliato nel client MCP per diagnosticare i problemi di connessione.
Authentication errors
Authentication errors
Assicurati di usare chiavi di test con endpoint di test e chiavi live con endpoint di produzione. Verifica che
DODO_PAYMENTS_ENVIRONMENT sia impostato correttamente (live_mode per la produzione). Se i problemi persistono, genera una nuova API key tramite la dashboard.Tool execution failures
Tool execution failures
Assicurati che l’assistente AI fornisca parametri formattati correttamente per ogni strumento. Controlla la risposta di errore dell’API per indicazioni specifiche su cosa non ha funzionato. Verifica che l’operazione funzioni quando chiami direttamente l’API di Dodo Payments tramite curl o Postman.
Perché Code Mode
Le implementazioni MCP tradizionali soffrono della “proliferazione degli strumenti”, in cui ogni endpoint API viene esposto come strumento separato. Code Mode è migliore per diversi motivi:Gli LLM sono più bravi a scrivere codice che a chiamare strumenti
Gli LLM sono addestrati su milioni di righe di codice reale, quindi scrivono naturalmente script efficaci. Le chiamate agli strumenti si basano spesso su esempi sintetici.“Far eseguire attività a un LLM tramite le chiamate agli strumenti è come sottoporre Shakespeare a un corso intensivo di mandarino della durata di un mese e poi chiedergli di scrivere un’opera teatrale in quella lingua.” — Cloudflare
Elimina il sovraccarico della finestra di contesto
Negli approcci tradizionali, ogni definizione di strumento consuma token prima dell’inizio della conversazione. L’esposizione di oltre 50 strumenti può consumare 55K–100K+ token. Anthropic ha rilevato che le definizioni degli strumenti potevano consumare fino a 134K token prima dell’ottimizzazione. Code Mode carica solo 2 definizioni di strumenti (circa 1K token). L’agente cerca la documentazione su richiesta. Tool Search Tool di Anthropic ha preservato il 95% della finestra di contesto, riducendo l’overhead da 77K a 8,7K token.Riduce la latenza tramite l’orchestrazione programmatica
Le chiamate agli strumenti tradizionali richiedono un ciclo completo di inferenza del modello per ogni operazione. Se un’attività richiede 20 chiamate API, sono necessari 20 cicli. 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 una maggiore accuratezza (il recupero delle conoscenze è migliorato dal 25,6% al 28,5%) usando questo approccio.Più sicuro per progettazione
Code Mode offre vantaggi di sicurezza intrinseci:- Nessuna API key nei parametri — Le API key vengono iniettate lato server e non sono mai esposte nei parametri degli strumenti inviati all’LLM.
- Sandbox isolata — Il codice viene eseguito in un ambiente sicuro senza accesso alla rete o al filesystem dell’host.
- SDK controllato — Per l’agente sono disponibili solo i metodi SDK autorizzati.
Si adatta a API di qualsiasi dimensione
Con la crescita di un’API, le prestazioni dell’MCP tradizionale peggiorano perché è necessario caricare più strumenti. Code Mode rimane costante con 2 strumenti indipendentemente dalla superficie dell’API. Cloudflare ha condensato oltre 2.500 endpoint API in 2 strumenti e circa 1.000 token di contesto.Per ulteriori dettagli, consulta i blog tecnici di Anthropic e Cloudflare, nonché la documentazione Programmatic Tool Calling di Claude.
Risorse
API Reference
Esplora la documentazione completa dell’API di Dodo Payments
MCP Protocol
Scopri di più sullo standard Model Context Protocol
GitHub Repository
Visualizza il codice sorgente del server MCP e contribuisci
NPM Package
Installa il server MCP da NPM