Tous les articles

Serveur MCP Carpe Diem : le brancher sur Claude Code ou Cursor

·Par Carpe Diem Team — Lumen Labs·4 min de lecture
tutorielguidetechnicalai
Câble USB, carnet fermé et petite lampe laiton sur un bureau en noyer

Vous voulez comparer deux modèles du catalogue, ou générer une image, sans quitter Claude Code ou Cursor. Le serveur MCP carpe-diem-mcp leur donne les outils Carpe Diem : catalogue, chat, image, solde, sans coller une base URL dans chaque projet. En HTTP, carpe-diem-mcp@0.1.0 expose 33 outils. Lors de notre essai, un carpe_chat a répondu pong pour 0,000044 $.

Câble USB, carnet et lampe sur un bureau

Illustration générée avec seedream-v5-lite sur Carpe Diem.

Ce qu'il vous faut

  • Un compte Carpe Diem, des crédits et une clé cdm_, créée dans API → Keys.
  • Node.js 20 ou plus, déjà installé.
  • Claude Code, Cursor, ou un terminal pour le mode HTTP.

Le paquet est public : carpe-diem-mcp@0.1.0, MIT, source. Il tourne sur votre machine ; l'assistant le lance via npx, et il parle à Carpe avec votre clé. Sans clé, les outils gratuits du catalogue restent disponibles.

Étape 1 : créer une clé

Dans API → Keys, choisissez Credits ou Prepaid, donnez-lui un nom si vous voulez, puis cliquez sur Create a key. La clé ne s'affiche qu'une fois : copiez-la tout de suite.

L'onglet MCP du Quick Start propose déjà la commande à coller pour Claude Code :

Onglet MCP du Quick Start : commande claude mcp add carpe

Étape 2 : brancher l'assistant

Claude Code, telle qu'affichée dans Quick Start :

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, dans ~/.cursor/mcp.json (tous les projets) ou .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" }
    }
  }
}

Rechargez les serveurs MCP du client, puis demandez : « Appelle carpe_status. »

Étape 3 : vérifier le serveur en HTTP

Pour tester le serveur sans IDE, lancez-le en HTTP :

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

Il écoute http://127.0.0.1:13333/mcp. Le Model Context Protocol commence par initialize : le serveur carpe-diem-mcp@0.1.0 s'identifie, et tools/list renvoie 33 outils, dont carpe_status, carpe_chat, carpe_image_generate et carpe_balance. Le catalogue, le statut et les prix sont gratuits ; chat, image, audio et vidéo sont payants.

On envoie ensuite un tools/call en reprenant l'en-tête 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",
      },
    },
  }),
});

Si le serveur répond en text/event-stream, le JSON utile est sur la dernière ligne data:. Lors de notre essai :

pong

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

Le coût et le marché sont dans la réponse de l'outil : vous n'avez pas à ouvrir le tableau de bord pour ce ping.

Garder la main sur la dépense

Le serveur estime chaque appel payant avant de l'envoyer, à partir de devis gratuits, et le refuse localement s'il dépasse une limite. Par défaut, CARPE_MAX_PER_CALL_USD vaut 0,50 $ et CARPE_MAX_SPEND_USD vaut 5 $ pour la session. Si vous ne voulez aucune dépense, CARPE_READ_ONLY=1 ne garde que les outils gratuits.

Si ça ne marche pas

SPEND_LIMIT_PER_CALL. Avec une limite trop basse, rien n'est parti vers Carpe :

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

Relevez CARPE_MAX_PER_CALL_USD si la dépense est voulue.

npx introuvable. Installez Node 20 ou plus, et ouvrez le client depuis un terminal où node -v répond.

NO_PAYMENT_METHOD. Ni clé ni wallet x402 n'est arrivé au processus. Vérifiez le bloc env du client et relancez-le.

402. Le solde ne couvre pas l'appel : rechargez dans API → Balance, ou demandez carpe_topup_link : il renvoie un lien de recharge à ouvrir dans le navigateur.

ChatGPT et claude.ai sur le web n'acceptent pas encore un serveur MCP local (ils veulent un MCP distant avec OAuth).

Aller plus loin

Les extraits Claude Desktop, VS Code et Codex sont dans Integrations : copiez celui de votre client, collez-y la clé cdm_, rechargez MCP, et demandez carpe_status. Même clé, sans MCP : le tuto Cline CLI branche l'agent sur OpenAI Compatible, et Hermes lance un agent en terminal. Pour lire le coût d'un appel depuis un script, le tuto SDK OpenAI Python montre les en-têtes. Le serveur HTTP ne se lie pas à une autre adresse sans jeton : ne l'exposez pas sur une URL publique.

Créez une clé dans API → Keys, collez-la dans votre client, et demandez carpe_status.

Méthode : essai du 8 novembre 2026, carpe-diem-mcp@0.1.0 en HTTP. Image, vidéo, x402, Cursor, VS Code et claude mcp add n'ont pas été exécutés.