> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Server MCP

> Collega apinn al tuo assistente IA (Claude, Cursor…) tramite il 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.

<Info>
  URL del server MCP: **`https://docs.apinn.io/mcp`** (transport HTTP streamable).
</Info>

## Connettere il server

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http apinn https://docs.apinn.io/mcp
    ```

    Poi in una sessione: « elenca i match di calcio in diretta », « dammi le quote dell'event 1632003656 ».
  </Tab>

  <Tab title="Cursor">
    Aggiungi a `~/.cursor/mcp.json` (o *Settings → MCP → Add*):

    ```json theme={null}
    {
      "mcpServers": {
        "apinn": {
          "url": "https://docs.apinn.io/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    In `claude_desktop_config.json` (Settings → Developer → Edit Config):

    ```json theme={null}
    {
      "mcpServers": {
        "apinn": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://docs.apinn.io/mcp"]
        }
      }
    }
    ```

    Riavvia Claude Desktop; il server `apinn` appare nell'elenco degli strumenti.
  </Tab>

  <Tab title="Altro client MCP">
    Qualsiasi client compatibile MCP (transport **HTTP streamable**) può connettersi a:

    ```
    https://docs.apinn.io/mcp
    ```
  </Tab>
</Tabs>

## 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](/it/rate-limits).

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

## 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](/it/api-reference/introduction) sono esposti come strumenti MCP (sola lettura).