Mit Metapherkarten bauen

Cursor und Cline nutzen das gleiche MCP-Config-Format. Der Block ist identisch zu Claude.

{
  "mcpServers": {
    "makcards": {
      "type": "http",
      "url": "https://mcp.makcards.online/v1",
      "headers": {
        "Authorization": "Bearer mk_live_xxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Zwei Optionen. MCP-Node (in aktuellen n8n-Builds verfügbar) – auf https://mcp.makcards.online/v1 zeigen, den Authorization-Header in den Credentials setzen. HTTP-Request-Node – REST direkt aufrufen:

URL:      https://app.makcards.online/api/v1/public/draw
Method:   POST
Headers:  Authorization: Bearer mk_live_xxxxxxxxxxxxxxxxxx
          Content-Type: application/json
Body:     { "scope": "any", "count": 1, "image_width": 1024 }

Custom GPT Actions liest OpenAPI. Verwenden Sie das KI-sichere Subset, damit der Chat nicht versehentlich Perlen ausgeben kann.

Action source: https://makcards.online/api/v1/public/openapi.ai.json
Authentication: API Key (Bearer)
Auth value:     mk_live_xxxxxxxxxxxxxxxxxx

Local stdio MCP. Der Schlüssel verlässt Ihre Maschine nicht – er geht direkt als Bearer an unsere REST-API. Erfordert Node.js 20+.

{
  "mcpServers": {
    "makcards": {
      "command": "npx",
      "args": ["-y", "@maccards/mcp"],
      "env": {
        "MAKCARDS_API_KEY": "mk_live_xxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Kein Node.js? Starten Sie dieselbe Binary als Container. Das Image wird nur für linux/amd64 veröffentlicht, daher braucht Apple Silicon einen zusätzlichen Flag (siehe unten). Falls Sie Node 20+ haben, ist der npx-Tab oben einfacher.

linux/amd64-Hosts (Intel Mac, Intel/AMD Linux, Windows WSL2):

{
  "mcpServers": {
    "makcards": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "MAKCARDS_API_KEY",
        "ghcr.io/makcards/mcp:latest",
        "node", "dist/transports/stdio.js"
      ],
      "env": {
        "MAKCARDS_API_KEY": "mk_live_xxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Apple Silicon (M1 / M2 / M3 / M4): fügen Sie --platform linux/amd64 hinzu, damit Docker das amd64-Image lädt und es über Rosetta ausführt. Funktioniert, aber der Start ist langsamer als die native npx-Option oben.

{
  "mcpServers": {
    "makcards": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--platform", "linux/amd64",
        "-e", "MAKCARDS_API_KEY",
        "ghcr.io/makcards/mcp:latest",
        "node", "dist/transports/stdio.js"
      ],
      "env": {
        "MAKCARDS_API_KEY": "mk_live_xxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Wenn Ihr Agent ohnehin in einer Shell läuft (Claude Code, Cursor Agent Mode, Aider, Codex, beliebige Container), ist das der kürzeste Weg: schlichtes HTTPS + Bearer, JSON-Antworten, keine MCP-Runtime zu installieren. Die vier Rezepte unten decken alles ab, was unsere MCP-Tools kapseln.

# Einmalige Einrichtung
export MAKCARDS_API_KEY=mk_live_xxxxxxxxxxxxxxxxxx
BASE=https://app.makcards.online/api/v1/public
H="Authorization: Bearer $MAKCARDS_API_KEY"

# Decks auflisten, die der Schlüssel lesen darf
curl -s -H "$H" "$BASE/decks" | jq

# 3 Karten aus beliebigem zugänglichen Deck ziehen
curl -s -X POST "$BASE/draw" -H "$H" -H "Content-Type: application/json" \
  -d '{"scope":"any","count":3,"image_width":1024}' | jq

# Erstes Kartenbild direkt auf Platte speichern
curl -s -X POST "$BASE/draw" -H "$H" -H "Content-Type: application/json" \
  -d '{"scope":"any","count":1,"image_width":1024}' \
  | jq -r '.drawn[0].image_url' \
  | xargs curl -s -o card.jpg

# Rate-Limit-Zustand prüfen
curl -s -H "$H" "$BASE/usage" | jq

Zwei Gründe für Bash statt MCP: kleinerer Agent-Kontext (keine Tool-Schemata zu laden) und ein Prozess weniger zu verwalten. Gründe für MCP: Ihr Client hat keine Shell (ChatGPT Apps, Claude Desktop, Cursor ohne Agent Mode), oder Sie wollen Slash-Command-Prompts.