Construa com cartas metafóricas

Cursor e Cline compartilham o mesmo formato de config MCP. O bloco é idêntico ao do Claude.

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

Duas opções. Nó MCP (disponível em builds recentes do n8n) – aponte para https://mcp.makcards.online/v1 e configure o header Authorization nas credenciais. Nó HTTP Request – chame REST diretamente:

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 }

O Custom GPT Actions lê OpenAPI. Use o subset seguro para IA para que o chat não consiga gastar pérolas por engano.

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

MCP local em stdio. A chave nunca sai da sua máquina: vai direto para nossa REST API como Bearer. Exige Node.js 20+.

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

Sem Node.js? Rode o mesmo binário como container. A imagem é publicada apenas para linux/amd64, então Apple Silicon precisa de uma flag extra (veja abaixo). Se você tem Node 20+, a aba npx acima é mais simples.

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): adicione --platform linux/amd64 para que o Docker baixe a imagem amd64 e a execute via Rosetta. Funciona, mas a inicialização é mais lenta do que a opção nativa via 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"
      }
    }
  }
}

Se seu agente já roda em um shell (Claude Code, Cursor em modo agente, Aider, Codex, qualquer container), este é o caminho mais curto: HTTPS simples + Bearer, respostas em JSON, sem runtime MCP para instalar. As quatro receitas abaixo cobrem tudo que nossas tools MCP empacotam.

# Configuração inicial
export MAKCARDS_API_KEY=mk_live_xxxxxxxxxxxxxxxxxx
BASE=https://app.makcards.online/api/v1/public
H="Authorization: Bearer $MAKCARDS_API_KEY"

# Listar baralhos que a chave pode ler
curl -s -H "$H" "$BASE/decks" | jq

# Puxar 3 cartas de qualquer baralho acessível
curl -s -X POST "$BASE/draw" -H "$H" -H "Content-Type: application/json" \
  -d '{"scope":"any","count":3,"image_width":1024}' | jq

# Salvar a primeira imagem direto no disco
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

# Verificar o estado do rate-limit
curl -s -H "$H" "$BASE/usage" | jq

Duas razões para preferir Bash a MCP: contexto do agente menor (sem schemas de tools para carregar) e um processo a menos para gerenciar. Razões para preferir MCP: seu cliente não tem shell (ChatGPT Apps, Claude Desktop, Cursor sem modo agente), ou você quer prompts via slash-commands.