Servidor MCP Carpe Diem: conectar Claude Code o Cursor

Quiere comparar dos modelos del catálogo, o generar una imagen, sin salir de Claude Code o Cursor. El servidor MCP carpe-diem-mcp les da las herramientas Carpe Diem: catálogo, chat, imagen, saldo, sin pegar una URL base en cada proyecto. En HTTP, carpe-diem-mcp@0.1.0 expone 33 herramientas. En nuestro ensayo, un carpe_chat respondió pong por 0,000044 $.

Ilustración generada con seedream-v5-lite en Carpe Diem.

Qué hace falta

• Una cuenta Carpe Diem, créditos y una clave cdm_, creada en API → Keys.
• Node.js 20 o posterior, ya instalado.
• Claude Code, Cursor, o un terminal para el modo HTTP.

El paquete es público: carpe-diem-mcp@0.1.0, MIT, código. Corre en su máquina; el asistente lo lanza vía npx, y habla con Carpe con su clave. Sin clave, las herramientas gratuitas del catálogo siguen disponibles.

Paso 1: crear una clave

En API → Keys, elija Credits o Prepaid, póngale un nombre si quiere, luego pulse Create a key. La clave se muestra una sola vez: cópiela enseguida.

La pestaña MCP del Quick Start ya propone el comando a pegar para Claude Code:

Paso 2: conectar el asistente

Claude Code, tal como aparece en 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, en ~/.cursor/mcp.json (ámbito de usuario) o .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" }
    }
  }
}

Recargue los servidores MCP del cliente, luego pida: «Llame a carpe_status.»

Paso 3: comprobar el servidor en HTTP

Para probar el servidor sin IDE, láncelo 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

Escucha en http://127.0.0.1:13333/mcp. El Model Context Protocol empieza por initialize: el servidor carpe-diem-mcp@0.1.0 se identifica, y tools/list devuelve 33 herramientas, entre ellas carpe_status, carpe_chat, carpe_image_generate y carpe_balance. El catálogo, el estado y los precios son gratuitos; chat, imagen, audio y vídeo son de pago.

A continuación se envía un tools/call reutilizando la cabecera 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 el servidor responde en text/event-stream, el JSON útil está en la última línea data:. En nuestro ensayo:

pong

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

El coste y el mercado están en la respuesta de la herramienta: no hace falta abrir el panel para este ping.

Controlar el gasto

El servidor estima cada llamada de pago antes de enviarla, a partir de presupuestos gratuitos, y la rechaza en local si supera un límite. Por defecto, CARPE_MAX_PER_CALL_USD vale 0,50 $ y CARPE_MAX_SPEND_USD vale 5 $ para la sesión. Si no quiere ningún gasto, CARPE_READ_ONLY=1 deja solo las herramientas gratuitas.

Si no funciona

SPEND_LIMIT_PER_CALL. Con un límite demasiado bajo, no salió nada hacia Carpe:

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

Suba CARPE_MAX_PER_CALL_USD si el gasto es voluntario.

npx no encontrado. Instale Node 20 o posterior, y abra el cliente desde un terminal donde node -v responda.

NO_PAYMENT_METHOD. Ni clave ni wallet x402 llegó al proceso. Compruebe el bloque env del cliente y reláncelo.

402. El saldo no cubre la llamada: recargue en API → Balance, o pida carpe_topup_link: devuelve un enlace de recarga para abrir en el navegador.

ChatGPT y claude.ai en la web aún no aceptan un servidor MCP local (quieren un MCP remoto con OAuth).

Ir más lejos

Los extractos Claude Desktop, VS Code y Codex están en Integrations: copie el de su cliente, pégele la clave cdm_, recargue MCP, y pida carpe_status. La misma clave, sin MCP: el tutorial Cline CLI conecta el agente a OpenAI Compatible, y Hermes lanza un agente en terminal. Para leer el coste de una llamada desde un script, el tutorial SDK OpenAI Python muestra las cabeceras. El servidor HTTP no se liga a otra dirección sin token: no lo exponga en una URL pública.

Cree una clave en API → Keys, péguela en su cliente, y pida carpe_status.

Procedimiento: ensayo del 8 noviembre 2026, carpe-diem-mcp@0.1.0 en HTTP. Imagen, vídeo, x402, Cursor, VS Code y claude mcp add no se ejecutaron.