Construye con cartas metafóricas

Cursor y Cline comparten el mismo formato de configuración MCP. El bloque es idéntico al de Claude.

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

Dos opciones. Nodo MCP (disponible en compilaciones recientes de n8n) – apunta a https://mcp.makcards.online/v1 y configura la cabecera Authorization en las credenciales. Nodo HTTP Request – llama a REST directamente:

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 lee OpenAPI. Usa el subset apto para IA para que el chat no pueda gastar perlas por accidente.

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

MCP local sobre stdio. La clave nunca sale de tu máquina: va directa a nuestra REST API como Bearer. Requiere Node.js 20+.

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

¿Sin Node.js? Ejecuta el mismo binario como contenedor. La imagen se publica solo para linux/amd64, así que Apple Silicon necesita un flag extra (ver abajo). Si tienes Node 20+, la pestaña de npx es más sencilla.

Hosts linux/amd64 (Mac Intel, Linux Intel/AMD, 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): añade --platform linux/amd64 para que Docker descargue la imagen amd64 y la ejecute mediante Rosetta. Funciona, pero el arranque es más lento que la opción nativa de npx.

{
  "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"
      }
    }
  }
}

Si tu agente ya corre en una shell (Claude Code, Cursor en modo agente, Aider, Codex, cualquier contenedor), este es el camino más corto: HTTPS plano + Bearer, respuestas JSON, sin runtime MCP que instalar. Las cuatro recetas siguientes cubren todo lo que envuelven nuestras tools MCP.

# Configuración inicial
export MAKCARDS_API_KEY=mk_live_xxxxxxxxxxxxxxxxxx
BASE=https://app.makcards.online/api/v1/public
H="Authorization: Bearer $MAKCARDS_API_KEY"

# Listar las barajas que tu clave puede leer
curl -s -H "$H" "$BASE/decks" | jq

# Tirar 3 cartas de cualquier baraja accesible
curl -s -X POST "$BASE/draw" -H "$H" -H "Content-Type: application/json" \
  -d '{"scope":"any","count":3,"image_width":1024}' | jq

# Guardar directo a disco la primera imagen
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

# Consultar el estado del rate limit
curl -s -H "$H" "$BASE/usage" | jq

Dos razones para preferir Bash a MCP: menor contexto del agente (sin esquemas de tools que cargar) y un proceso menos que gestionar. Razones para preferir MCP: tu cliente no tiene shell (ChatGPT Apps, Claude Desktop, Cursor sin modo agente) o quieres prompts de tipo slash-command.