MCP-Server Carpe Diem an Claude Code oder Cursor anbinden

Sie wollen zwei Modelle aus dem Katalog vergleichen oder ein Bild erzeugen, ohne Claude Code oder Cursor zu verlassen. Der MCP-Server carpe-diem-mcp gibt ihnen die Werkzeuge von Carpe Diem: Katalog, Chat, Bild, Saldo, ohne in jedes Projekt eine Basis-URL zu kleben. Über HTTP stellt carpe-diem-mcp@0.1.0 33 Werkzeuge bereit. Bei unserem Versuch hat ein carpe_chat mit pong geantwortet, für 0,000044 $.

Illustration erzeugt mit seedream-v5-lite auf Carpe Diem.

Was Sie brauchen

• Ein Konto bei Carpe Diem, Credits und einen Schlüssel cdm_, angelegt unter API → Keys.
• Node.js 20 oder neuer, bereits installiert.
• Claude Code, Cursor, oder ein Terminal für den HTTP-Modus.

Das Paket ist öffentlich: carpe-diem-mcp@0.1.0, MIT, Quellcode. Es läuft auf Ihrer Maschine; der Assistent startet es über npx und spricht mit Carpe über Ihren Schlüssel. Ohne Schlüssel bleiben die kostenlosen Katalogwerkzeuge verfügbar.

Schritt 1: einen Schlüssel anlegen

Unter API → Keys wählen Sie Credits oder Prepaid, geben Sie ihm bei Bedarf einen Namen, dann klicken Sie auf Create a key. Der Schlüssel erscheint nur einmal: kopieren Sie ihn sofort.

Der Reiter MCP im Quick Start bietet bereits den Befehl zum Einfügen für Claude Code:

Schritt 2: den Assistenten anbinden

Claude Code, so wie im Quick Start gezeigt:

claude mcp add carpe --scope user \
  --env CARPE_API_KEY=cdm_your_key_here \
  --env CARPE_MAX_SPEND_USD=5 \
  -- npx -y carpe-diem-mcp

Cursor, in ~/.cursor/mcp.json (benutzerweit) oder .cursor/mcp.json:

{
  "mcpServers": {
    "carpe": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "carpe-diem-mcp"],
      "env": { "CARPE_API_KEY": "cdm_your_key_here", "CARPE_MAX_SPEND_USD": "5" }
    }
  }
}

Laden Sie die MCP-Server des Clients neu, dann fragen Sie: «Rufen Sie carpe_status auf.»

Schritt 3: den Server per HTTP prüfen

Um den Server ohne IDE zu testen, starten Sie ihn per HTTP:

CARPE_API_KEY=cdm_your_key_here CARPE_MAX_SPEND_USD=5 \
  npx -y carpe-diem-mcp@0.1.0 --http --port 13333

Er lauscht auf http://127.0.0.1:13333/mcp. Das Model Context Protocol beginnt mit initialize: der Server carpe-diem-mcp@0.1.0 identifiziert sich, und tools/list liefert 33 Werkzeuge, darunter carpe_status, carpe_chat, carpe_image_generate und carpe_balance. Katalog, Status und Preise sind kostenlos; Chat, Bild, Audio und Video sind kostenpflichtig.

Anschließend sendet man einen tools/call und übernimmt den Header mcp-session-id:

const BASE = "http://127.0.0.1:13333/mcp";
const headers = {
  "content-type": "application/json",
  accept: "application/json, text/event-stream",
};
const init = await fetch(BASE, {
  method: "POST",
  headers,
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "initialize",
    params: {
      protocolVersion: "2025-03-26",
      capabilities: {},
      clientInfo: { name: "carpe-reporter-probe", version: "1.0.0" },
    },
  }),
});
const sessionId = init.headers.get("mcp-session-id");
const chat = await fetch(BASE, {
  method: "POST",
  headers: { ...headers, "mcp-session-id": sessionId },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 2,
    method: "tools/call",
    params: {
      name: "carpe_chat",
      arguments: {
        messages: [{ role: "user", content: "Reply with the exact word: pong" }],
        model: "deepseek-v4-1-flash",
      },
    },
  }),
});

Wenn der Server mit text/event-stream antwortet, steht das nützliche JSON in der letzten data:-Zeile. Bei unserem Versuch:

pong

— $0.000044 · /v1 (Carpe TEE) · deepseek-v4-1-flash

Kosten und Markt stehen in der Antwort des Werkzeugs: für diesen Ping müssen Sie das Dashboard nicht öffnen.

Die Ausgabe im Griff behalten

Der Server schätzt jeden kostenpflichtigen Aufruf vor dem Senden anhand kostenloser Angebote und lehnt ihn lokal ab, wenn er ein Limit überschreitet. Standardmäßig gilt CARPE_MAX_PER_CALL_USD 0,50 $ und CARPE_MAX_SPEND_USD 5 $ für die Sitzung. Wenn Sie keine Ausgabe wollen, behält CARPE_READ_ONLY=1 nur die kostenlosen Werkzeuge.

Wenn es nicht klappt

SPEND_LIMIT_PER_CALL. Bei einem zu niedrigen Limit ging nichts zu Carpe:

carpe_chat is estimated at $0.0008, above the per-call limit of $0.00. Nothing was sent.

Erhöhen Sie CARPE_MAX_PER_CALL_USD, wenn die Ausgabe gewollt ist.

npx nicht gefunden. Installieren Sie Node 20 oder neuer, und öffnen Sie den Client aus einem Terminal, in dem node -v antwortet.

NO_PAYMENT_METHOD. Weder Schlüssel noch x402-Wallet erreichten den Prozess. Prüfen Sie den env-Block des Clients und starten Sie ihn neu.

402. Der Saldo deckt den Aufruf nicht: laden Sie unter API → Balance auf, oder fragen Sie carpe_topup_link: es liefert einen Auflade-Link zum Öffnen im Browser.

ChatGPT und claude.ai im Web akzeptieren noch keinen lokalen MCP-Server (sie wollen ein entferntes MCP mit OAuth).

Weitergehen

Die Ausschnitte für Claude Desktop, VS Code und Codex stehen unter Integrations: kopieren Sie den für Ihren Client, fügen Sie den Schlüssel cdm_ ein, laden Sie MCP neu, und fragen Sie carpe_status. Derselbe Schlüssel, ohne MCP: das Tutorial Cline CLI bindet den Agenten an OpenAI Compatible, und Hermes startet einen Agenten im Terminal. Um die Kosten eines Aufrufs aus einem Skript zu lesen, zeigt das Tutorial OpenAI Python SDK die Header. Der HTTP-Server bindet sich ohne Token an keine andere Adresse: setzen Sie ihn nicht auf eine öffentliche URL.

Legen Sie einen Schlüssel unter API → Keys an, fügen Sie ihn in Ihren Client ein, und fragen Sie carpe_status.

Vorgehen: Versuch vom 8. November 2026, carpe-diem-mcp@0.1.0 per HTTP. Bild, Video, x402, Cursor, VS Code und claude mcp add wurden nicht ausgeführt.