Översikt
Model Context Protocol (MCP) är en öppen standard som möjliggör för AI-applikationer att säkert ansluta till externa datakällor och API:er. Dodo Payments MCP Server ger AI-assistenter som Claude, Cursor och andra MCP-kompatibla klienter strukturerad åtkomst till din betalningsinfrastruktur. Dodo Payments MCP Server använder Code Mode-arkitekturen. Istället för att exponera hundratals separata verktyg för varje API-endpoint ger Code Mode AI-agenter möjlighet att skriva och köra TypeScript-kod mot Dodo Payments SDK i en isolerad sandlådemiljö.Nyckelfunktioner
- Betalningsoperationer: Skapa, hämta och hantera betalningar och återbetalningar
- Prenumerationshantering: Hantera återkommande fakturering, uppgraderingar och avbokningar
- Kundadministration: Hantera kunddata och portalåtkomst
- Produktkatalog: Skapa och uppdatera produkter, prissättning och rabatter
- Licenshantering: Aktivera, validera och hantera programvarulicenser
- Användningsbaserad fakturering: Spåra och fakturera för mätanvändning
Hur Code Mode fungerar
Dodo Payments MCP Server erbjuder din AI-agent exakt två verktyg:- Docs Search Tool: Söker i dokumentationen om Dodo Payments API och SDK för att förstå tillgängliga operationer och parametrar.
- Code Execution Tool: Skriver TypeScript-kod mot SDK:t som körs i en säker sandlådemiljö.
Snabb uppsättning
Anslut till Dodo Payments MCP Server i din AI-klient:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Lägg till i
~/.cursor/mcp.json:Kräver Node.js 18 eller högre. Den fjärranslutna servern använder OAuth för autentisering — du kommer att uppmanas att ange din API-nyckel och välja din miljö vid första anslutningen.
Dodo Knowledge MCP
Utöver Dodo Payments MCP Server (för att köra API-operationer) erbjuder vi Dodo Knowledge MCP—en semantisk sökserver som ger AI-assistenter omedelbar tillgång till Dodo Payments-dokumentation och kunskapsbas.Byggt med ContextMCP.ai: Dodo Knowledge MCP drivs av ContextMCP, vilket möjliggör snabb semantisk sökning i vår dokumentation med vektorembeddingar.
Vad är Dodo Knowledge MCP?
Dodo Knowledge MCP är en fjärr-MCP-server som erbjuder:- Semantisk dokumentationssökning: Hitta relevant dokumentation med naturliga språkfrågor.
- Kontextuella svar: AI-assistenter får korrekt och uppdaterad information om Dodo Payments.
- Ingen installation: Inga API-nycklar eller lokal installation krävs—bara anslut och börja fråga.
Snabb uppsättning
Anslut till Dodo Knowledge MCP i din AI-klient:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Lägg till i
~/.cursor/mcp.json:Kräver Node.js 18 eller högre.
mcp-remote-paketet hanterar anslutningen till den fjärranslutna MCP-servern.Använd båda MCP-servrarna tillsammans
För bästa AI-assisterade utvecklingsupplevelse rekommenderar vi att använda båda MCP-servrarna:| Server | Syfte | Användningsfall |
|---|---|---|
| Dodo Knowledge MCP | Dokumentationssökning | ”Hur hanterar jag webhooks?”, “Vilka betalningsmetoder stöds?” |
| Dodo Payments MCP | API-operationer | Skapa betalningar, hantera prenumerationer, hantera återbetalningar |
Felsökning av Knowledge MCP
Om du stöter på anslutningsproblem:- Rensa MCP-autentiseringscachen:
rm -rf ~/.mcp-auth - Starta om din klientapplikation
- Kontrollera klientloggar efter felmeddelanden
- Verifiera Node.js-version: Kräver Node.js 18+
Knowledge MCP Server
Gå till Dodo Knowledge MCP:s konfigurationssida
Installation
Välj den installationsmetod som passar ditt arbetsflöde bäst.Fjärr-MCP-server (rekommenderad)
Få åtkomst till den hostade MCP-servern utan lokal installation. Det här är det snabbaste sättet att komma igång.Access the remote server
Navigera till https://mcp.dodopayments.com i din webbläsare.
Configure your MCP client
Kopiera den tillhandahållna JSON-konfigurationen för din specifika klient. För Cursor eller Claude Desktop lägg till detta i dina MCP-inställningar:
Authenticate and configure
OAuth-flödet kommer att uppmana dig att:
- Ange din Dodo Payments API-nyckel
- Välja din miljö (test eller live)
- Välja din MCP-klienttyp
NPM-paket
Installera och kör MCP-servern lokalt med NPM.- NPX (No Installation)
- MCP Client Configuration
Docker
Kör MCP-servern i en containeriserad miljö för konsekvent distribution.Docker-images finns på GitHub Container Registry.
Klientkonfiguration
Konfigurera Dodo Payments MCP-servern i din föredragna AI-klient.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
Ställ in Dodo Payments MCP-servern i Cursor för att få konversationell åtkomst till din betalningsdata.Ett klick InstalleraAnvänd knappen nedan för att installera MCP-servern direkt i Cursor:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Efter klicket, ange dina miljövariabler i Cursors
mcp.json via Cursor Settings > Tools & MCP > New MCP Server.Manuell konfigurationOpen Cursor settings
Navigera till Cursor Settings > Features > Model Context Protocol eller tryck
Cmd/Ctrl + Shift + P och sök efter “MCP Settings”.Add Dodo Payments configuration
Välj en av följande konfigurationer:Fjärrserver (rekommenderad)Lokal NPX
Miljövariabler
Konfigurera MCP-serverns beteende med miljövariabler.| Variabel | Beskrivning | Obligatorisk |
|---|---|---|
DODO_PAYMENTS_API_KEY | Din Dodo Payments API-nyckel | Ja |
DODO_PAYMENTS_WEBHOOK_KEY | Din webhook-signeringsnyckel | Nej |
DODO_PAYMENTS_ENVIRONMENT | Sätt till live_mode i produktion | Nej |
Kör fjärrstyrt
Distribuera MCP-servern som en fjärrstyrd HTTP-server för webbaserade klienter eller agentiska arbetsflöden.Fjärrserverkonfiguration
När den är distribuerad kan klienter ansluta med server-URL:Auktorisationsheaders
Den fjärranslutna servern accepterar autentisering via följande headers:| Header | Beskrivning |
|---|---|
Authorization | Bearer-token-autentisering |
x-dodo-payments-api-key | Direkt API-nyckel-header |
Säkerhetsbästa praxis
Code Mode erbjuder inneboende säkerhet genom att köra kod i en sandlådemiljö och injicera API-nycklar på serversidan. Följ dessa ytterligare rekommendationer för att skydda dina autentiseringsuppgifter.API Key Management
API Key Management
Lägg aldrig in autentiseringsuppgifter i versionskontrollSpara API-nycklar i miljövariabler eller säkra hemlighetshanteringssystem.Rotera nycklar regelbundetGenerera nya API-nycklar med jämna mellanrum och återkalla gamla via din Dodo Payments-instrumentpanel.Använd testnycklar för utvecklingAnvänd alltid API-nycklar i testläge under utveckling för att undvika påverkan på produktionsdata.
Access Control
Access Control
Implementera autentisering för fjärrservrarNär du distribuerar fjärrservrar, kräva alltid autentisering via
Authorization-headern eller x-dodo-payments-api-key-headern.Övervaka API-användningSpåra MCP-serveraktivitet via din Dodo Payments-instrumentpanel och konfigurera varningar för ovanliga mönster.Network Security
Network Security
Använd HTTPS för fjärrservrarDistribuera alltid fjärranslutna MCP-servrar bakom HTTPS-slutpunkter.Implementera hastighetsbegränsningSkydda mot missbruk genom att implementera hastighetsbegränsningar både vid MCP-servern och på API-nivå.Begränsa nätverksåtkomstKonfigurera brandväggsregler för att begränsa vilka klienter som kan ansluta till din MCP-server.
Felsökning
Connection issues
Connection issues
Verifiera din API-nyckelSäkerställ att din API-nyckel är korrekt inställd och har nödvändiga behörigheter.Kontrollera nätverksanslutningenVerifiera att du kan nå Dodo Payments API-endpoints.Granska klientloggarAktivera detaljerad loggning i din MCP-klient för att diagnostisera anslutningsproblem.
Authentication errors
Authentication errors
Bekräfta API-nyckelns miljöSäkerställ att du använder testnycklar med testendpoints och live-nycklar med produktionsendpoints.Kontrollera miljövariabelnVerifiera att
DODO_PAYMENTS_ENVIRONMENT är korrekt inställd (live_mode för produktion).Generera nya autentiseringsuppgifterOm problemen kvarstår, generera en ny API-nyckel via din instrumentpanel.Tool execution failures
Tool execution failures
Validera inparametrarSäkerställ att AI-assistenten tillhandahåller korrekt formaterade parametrar för varje verktyg.Granska felmeddelandenKontrollera felresponsen från API:et för specifik vägledning om vad som gick fel.Testa direkt mot API:etVerifiera att operationen fungerar när du anropar Dodo Payments API direkt via curl eller Postman.
Varför Code Mode
Traditionella MCP-implementationer lider ofta av “verktygsproliferation”, där varje API-endpoint exponeras som ett separat verktyg. Code Mode är en överlägsen metod av flera skäl:LLM är bättre på att skriva kod än att kalla verktyg
LLM:er har tränats på miljontals rader verklig kod, vilket gör dem naturligt skickliga på att skriva skript. Verktygskallning baseras ofta på syntetiska exempel.“Att få en LLM att utföra uppgifter med verktygskallning är som att låta Shakespeare gå en månads lång klass i mandarin och sedan be honom skriva ett skådespel på det.” — Cloudflare
Eliminerar överbelastning av kontextfönstret
I en traditionell metod förbrukar varje verktygsdefinition tokens innan konversationen ens startat. Att exponera 50+ verktyg kan enkelt äta upp 55K–100K+ tokens. Anthropic upptäckte att verktygsdefinitioner kunde konsumera upp till 134K tokens före optimering. Med Code Mode laddas bara 2 verktygsdefinitioner (~1K tokens). Agenten söker efter dokumentationen den behöver efter behov. Anthropics Tool Search Tool bevarade 95% av kontextfönstret och minskade overhead från 77K till 8,7K tokens.Minskar latens via programmatisk orkestrering
Traditionell verktygskallning kräver en full modellinferens-rundtur för varje enskild operation. Om en uppgift kräver 20 API-anrop blir det 20 rundresor. I Code Mode skriver agenten ett skript som kör alla anrop och returnerar endast slutresultatet. Anthropic observerade en 37% minskning i tokens och förbättrad noggrannhet (kunskapsinläsning förbättrades från 25,6% till 28,5%) med denna programmatisk metod.Mer säkert per design
Code Mode erbjuder inneboende säkerhetsfördelar:- Inga API-nycklar i parametrarna: API-nycklar injiceras på serversidan och exponeras aldrig i verktygsparametrarna som skickas till LLM:en.
- Isolerad sandlåda: Koden körs i en säker miljö utan åtkomst till nätverket eller värdfilsystemet.
- Kontrollerat SDK: Endast auktoriserade SDK-metoder är tillgängliga för agenten.
Skalbart till vilken API-storlek som helst
När ett API växer försämras traditionell MCP-prestanda eftersom fler verktyg måste laddas in i kontexten. Code Mode förblir konstant med 2 verktyg oavsett API:ets omfattning. Cloudflare lyckades sammanfatta över 2 500 API-endpoints till bara 2 verktyg och cirka 1 000 tokens kontext.För mer detaljer om fördelarna med denna arkitektur, se ingenjörsbloggarna från Anthropic och Cloudflare, samt dokumentationen för Programmatic Tool Calling från Claude.