> ## 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.

# Serveur MCP

> Branchez apinn à votre assistant IA (Claude, Cursor…) via le serveur MCP.

apinn expose un **serveur MCP** (Model Context Protocol) : votre assistant IA peut **chercher dans la documentation** et **appeler l'API** (lister les sports, récupérer les cotes d'un match, l'historique, les specials…) directement en langage naturel.

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

## Connecter le serveur

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

    Puis dans une session : « liste les matchs de foot en direct », « donne‑moi les cotes de l'event 1632003656 ».
  </Tab>

  <Tab title="Cursor">
    Ajoutez à `~/.cursor/mcp.json` (ou *Settings → MCP → Add* ) :

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

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

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

    Redémarrez Claude Desktop ; le serveur `apinn` apparaît dans la liste des outils.
  </Tab>

  <Tab title="Autre client MCP">
    Tout client compatible MCP (transport **HTTP streamable**) peut se connecter à :

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

## Authentification

* Les outils de **recherche de documentation** fonctionnent sans clé.
* Les outils qui **appellent l'API** utilisent votre **clé apinn** (`X-API-Key`). Fournissez‑la à l'assistant / dans la configuration du client MCP quand il la demande. Chaque appel compte dans votre [quota horaire](/rate-limits).

<Warning>
  Ne collez jamais votre clé dans un dépôt public ou un partage d'écran. Traitez‑la comme un secret.
</Warning>

## Ce que l'assistant peut faire

* « Quels sont les sports disponibles ? » → `/api/sports`
* « Donne‑moi les matchs de foot en direct » → `/api/fixtures?sport_id=29&live=1`
* « Cotes actuelles de l'event 1632003656 » → `/api/odds`
* « Historique complet des cotes de ce match » → `/api/odds?full_history=1`
* « Vainqueur de la Champions League : cotes des favoris » → `/api/specials/outrights`

Tous les [endpoints de la référence API](/api-reference/introduction) sont exposés comme outils MCP (lecture seule).