Server MCP

apinn espone un server MCP (Model Context Protocol): il tuo assistente IA può cercare nella documentazione e chiamare l’API (elencare gli sport, recuperare le quote di un match, lo storico, gli specials…) direttamente in linguaggio naturale.

URL del server MCP: https://api.apinn.io/mcp (transport HTTP streamable). L’MCP di ricerca nella documentazione resta disponibile separatamente su https://docs.apinn.io/mcp (senza chiave). Connettori senza header (claude.ai, ChatGPT): passa la chiave nell’URL — https://api.apinn.io/mcp?key=<LA_TUA_CHIAVE> — o tramite l’argomento api_key degli strumenti.

Connettere il server

Claude Code
Cursor
Claude Desktop
Altro client MCP

claude mcp add --transport http apinn https://api.apinn.io/mcp --header "X-API-Key: <LA_TUA_CHIAVE>"

Poi in una sessione: « elenca i match di calcio in diretta », « dammi le quote dell’event 1632003656 ».

Aggiungi a ~/.cursor/mcp.json (o Settings → MCP → Add):

{
  "mcpServers": {
    "apinn": {
      "url": "https://api.apinn.io/mcp",
      "headers": { "X-API-Key": "<LA_TUA_CHIAVE>" }
    }
  }
}

In claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "apinn": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.apinn.io/mcp", "--header", "X-API-Key: <LA_TUA_CHIAVE>"]
    }
  }
}

Riavvia Claude Desktop; il server apinn appare nell’elenco degli strumenti.

Qualsiasi client compatibile MCP (transport HTTP streamable) può connettersi a:

https://api.apinn.io/mcp

Autenticazione

Gli strumenti di ricerca nella documentazione funzionano senza chiave.
Gli strumenti che chiamano l’API utilizzano la tua chiave apinn (X-API-Key). Forniscila all’assistente / nella configurazione del client MCP quando la richiede. Ogni chiamata conta nella tua quota oraria.

Non incollare mai la tua chiave in un repository pubblico o in una condivisione dello schermo. Trattala come un segreto.

Cosa può fare l’assistente

« Quali sono gli sport disponibili? » → /api/sports
« Dammi i match di calcio in diretta » → /api/fixtures?sport_id=29&live=1
« Quote attuali dell’event 1632003656 » → /api/odds
« Storico completo delle quote di questo match » → /api/odds?full_history=1
« Vincitore della Champions League: quote dei favoriti » → /api/specials/outrights

Tutti gli endpoint del riferimento API sono esposti come strumenti MCP (sola lettura).

Iniziare

Concetti

Connettere il server

Autenticazione

Cosa può fare l’assistente

​Connettere il server

​Autenticazione

​Cosa può fare l’assistente

Connettere il server

Autenticazione

Cosa può fare l’assistente