Servidor MCP Carpe Diem: ligar Claude Code ou Cursor

Quer comparar dois modelos do catálogo, ou gerar uma imagem, sem sair do Claude Code ou do Cursor. O servidor MCP carpe-diem-mcp dá-lhes as ferramentas Carpe Diem: catálogo, chat, imagem, saldo, sem colar uma URL de base em cada projeto. Em HTTP, carpe-diem-mcp@0.1.0 expõe 33 ferramentas. No nosso ensaio, um carpe_chat respondeu pong por 0,000044 $.

Ilustração gerada com seedream-v5-lite na Carpe Diem.

O que precisa

• Uma conta Carpe Diem, créditos e uma chave cdm_, criada em API → Keys.
• Node.js 20 ou mais recente, já instalado.
• Claude Code, Cursor, ou um terminal para o modo HTTP.

O pacote é público: carpe-diem-mcp@0.1.0, MIT, código. Corre na sua máquina; o assistente lança-o via npx, e fala com a Carpe com a sua chave. Sem chave, as ferramentas gratuitas do catálogo continuam disponíveis.

Passo 1: criar uma chave

Em API → Keys, escolha Credits ou Prepaid, dê-lhe um nome se quiser, depois clique em Create a key. A chave só aparece uma vez: copie-a de imediato.

O separador MCP do Quick Start já propõe o comando a colar para o Claude Code:

Passo 2: ligar o assistente

Claude Code, tal como mostrado no 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, em ~/.cursor/mcp.json (âmbito de utilizador) 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" }
    }
  }
}

Recarregue os servidores MCP do cliente, depois peça: «Chame carpe_status.»

Passo 3: verificar o servidor em HTTP

Para testar o servidor sem IDE, lance-o em HTTP:

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

Escuta em http://127.0.0.1:13333/mcp. O Model Context Protocol começa por initialize: o servidor carpe-diem-mcp@0.1.0 identifica-se, e tools/list devolve 33 ferramentas, incluindo carpe_status, carpe_chat, carpe_image_generate e carpe_balance. O catálogo, o estado e os preços são gratuitos; chat, imagem, áudio e vídeo são pagos.

Em seguida envia-se um tools/call reutilizando o cabeçalho 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",
      },
    },
  }),
});

Se o servidor responder em text/event-stream, o JSON útil está na última linha data:. No nosso ensaio:

pong

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

O custo e o mercado estão na resposta da ferramenta: não precisa de abrir o painel para este ping.

Manter o gasto sob controlo

O servidor estima cada chamada paga antes de a enviar, a partir de cotações gratuitas, e recusa-a localmente se ultrapassar um limite. Por omissão, CARPE_MAX_PER_CALL_USD vale 0,50 $ e CARPE_MAX_SPEND_USD vale 5 $ para a sessão. Se não quiser nenhum gasto, CARPE_READ_ONLY=1 deixa só as ferramentas gratuitas.

Se não funcionar

SPEND_LIMIT_PER_CALL. Com um limite demasiado baixo, nada foi enviado para a 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 se o gasto for intencional.

npx não encontrado. Instale Node 20 ou mais recente, e abra o cliente a partir de um terminal onde node -v responda.

NO_PAYMENT_METHOD. Nem chave nem wallet x402 chegou ao processo. Verifique o bloco env do cliente e volte a lançá-lo.

402. O saldo não cobre a chamada: recarregue em API → Balance, ou peça carpe_topup_link: devolve um link de recarga para abrir no browser.

O ChatGPT e o claude.ai na web ainda não aceitam um servidor MCP local (querem um MCP remoto com OAuth).

Ir mais longe

Os excertos Claude Desktop, VS Code e Codex estão em Integrations: copie o do seu cliente, cole a chave cdm_, recarregue MCP, e peça carpe_status. A mesma chave, sem MCP: o tutorial Cline CLI liga o agente a OpenAI Compatible, e o Hermes lança um agente no terminal. Para ler o custo de uma chamada a partir de um script, o tutorial SDK OpenAI Python mostra os cabeçalhos. O servidor HTTP não se liga a outro endereço sem token: não o exponha numa URL pública.

Crie uma chave em API → Keys, cole-a no seu cliente, e peça carpe_status.

Procedimento: ensaio de 8 de novembro de 2026, carpe-diem-mcp@0.1.0 em HTTP. Imagem, vídeo, x402, Cursor, VS Code e claude mcp add não foram executados.