Hoppa till huvudinnehåll

Ö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:
  1. Docs Search Tool: Söker i dokumentationen om Dodo Payments API och SDK för att förstå tillgängliga operationer och parametrar.
  2. Code Execution Tool: Skriver TypeScript-kod mot SDK:t som körs i en säker sandlådemiljö.
Denna arkitektur låter agenter utföra komplexa flerstegsoperationer i ett enda anrop. Till exempel kan en agent lista alla aktiva prenumerationer, filtrera dem efter specifika kriterier och tillämpa rabatt på varje—allt inom ett enda skript.
Med Code Mode kan agenter kedja flera API-anrop, hantera villkorlig logik och utföra beräkningar utan att kräva flera rundresor till LLM:en.

Snabb uppsättning

Anslut till Dodo Payments MCP Server i din AI-klient:
Lägg till i ~/.cursor/mcp.json:
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
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:
Lägg till i ~/.cursor/mcp.json:
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}
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:
ServerSyfteAnvändningsfall
Dodo Knowledge MCPDokumentationssökning”Hur hanterar jag webhooks?”, “Vilka betalningsmetoder stöds?”
Dodo Payments MCPAPI-operationerSkapa betalningar, hantera prenumerationer, hantera återbetalningar
{
  "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"]
    }
  }
}
Med båda servrar konfigurerade kan din AI-assistent först söka dokumentation för att förstå hur en funktion ska implementeras och sedan köra faktiska API-anrop—allt inom en enda konversation.

Felsökning av Knowledge MCP

Om du stöter på anslutningsproblem:
  1. Rensa MCP-autentiseringscachen: rm -rf ~/.mcp-auth
  2. Starta om din klientapplikation
  3. Kontrollera klientloggar efter felmeddelanden
  4. 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.
1

Access the remote server

Navigera till https://mcp.dodopayments.com i din webbläsare.
2

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:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

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
Håll din API-nyckel säker. Använd testnycklar under utveckling.
4

Complete setup

Klicka Login and Approve för att auktorisera anslutningen.
När ansluten kan din AI-assistent interagera med Dodo Payments API å dina vägnar.

NPM-paket

Installera och kör MCP-servern lokalt med 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
Använd @latest för att alltid hämta den senaste versionen, eller fäst vid en specifik version som @1.0.0 för stabilitet.

Docker

Kör MCP-servern i en containeriserad miljö för konsekvent distribution.
# 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
Docker-images finns på GitHub Container Registry.

Klientkonfiguration

Konfigurera Dodo Payments MCP-servern i din föredragna AI-klient.
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:[Add to 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 konfiguration
1

Open Cursor settings

Navigera till Cursor Settings > Features > Model Context Protocol eller tryck Cmd/Ctrl + Shift + P och sök efter “MCP Settings”.
2

Edit configuration

Klicka Edit Config för att öppna mcp_config.json-filen.
3

Add Dodo Payments configuration

Välj en av följande konfigurationer:Fjärrserver (rekommenderad)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Lokal NPX
{
  "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

Spara konfigurationsfilen och starta om Cursor.
Verifiera anslutningen genom att fråga AI-assistenten om din Dodo Payments-data.

Miljövariabler

Konfigurera MCP-serverns beteende med miljövariabler.
VariabelBeskrivningObligatorisk
DODO_PAYMENTS_API_KEYDin Dodo Payments API-nyckelJa
DODO_PAYMENTS_WEBHOOK_KEYDin webhook-signeringsnyckelNej
DODO_PAYMENTS_ENVIRONMENTSätt till live_mode i produktionNej

Kör fjärrstyrt

Distribuera MCP-servern som en fjärrstyrd HTTP-server för webbaserade klienter eller agentiska arbetsflöden.
# Start as remote server
npx -y dodopayments-mcp --transport=http

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

Fjärrserverkonfiguration

När den är distribuerad kan klienter ansluta med server-URL:
{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Auktorisationsheaders

Den fjärranslutna servern accepterar autentisering via följande headers:
HeaderBeskrivning
AuthorizationBearer-token-autentisering
x-dodo-payments-api-keyDirekt 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.
Lägg aldrig in autentiseringsuppgifter i versionskontrollSpara API-nycklar i miljövariabler eller säkra hemlighetshanteringssystem.
# 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
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.
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.
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

Verifiera din API-nyckelSäkerställ att din API-nyckel är korrekt inställd och har nödvändiga behörigheter.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments
Kontrollera nätverksanslutningenVerifiera att du kan nå Dodo Payments API-endpoints.Granska klientloggarAktivera detaljerad loggning i din MCP-klient för att diagnostisera anslutningsproblem.
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.
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.

Resurser