Getting started.

1. Ottieni una API key

/signup per una chiave Free (100 chiamate / mese, no carta). Salva la chiave subito — non viene rimostrata. Per limiti più alti vedi pricing.

2. Test in 30 secondi (curl)

Verifica che la chiave funzioni listando i tool disponibili al tuo tier:

curl -X POST https://mcp.qubitdata.it/mcp \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Risposta: array di tool con input schema. Free vede 9 tool, Pro 19, Max 20. tools/list + initialize sono gratis.

3. Prima chiamata reale

Trova le 5 strutture sanitarie più vicine al Colosseo:

curl -X POST https://mcp.qubitdata.it/mcp \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{"name":"nearest_n","arguments":{"lat":41.9028,"lon":12.4964,"n":5,"theme":"healthcare"}}
  }'

Risposta: array JSON con nome, source, distanza in metri, lat/lon. Sfoglia il catalogo completo su /tools.

4. Connetti Claude Desktop / Cursor

Aggiungi a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o equivalente:

{
  "mcpServers": {
    "qubitdata-gis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.qubitdata.it/mcp",
        "--header",
        "Authorization:Bearer ${MCP_KEY}"
      ],
      "env": {
        "MCP_KEY": "<your_api_key>"
      }
    }
  }
}

Imposta MCP_KEY al tuo gis_*_sk_. Riavvia il client. Il server qubitdata-gis appare con tutti i tool del tuo tier.

5. Cosa viene fatturato

Solo le tools/call riuscite contano sulla quota. Discovery e keepalive SSE sono gratis. Errori non vengono fatturati. Headers utili sulla risposta: x-mcp-calls-billed, x-mcp-calls-month, x-mcp-quota-month, x-quota-reset. Stato corrente: GET /v1/usage.

6. Errori comuni

7. Gestisci abbonamento

Aggiorna carta, scarica fatture, cancella: Customer Portal (Pro/Max).