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

# MCP-Server

> Verbinden Sie apinn mit Ihrem KI-Assistenten (Claude, Cursor…) über den MCP-Server.

apinn stellt einen **MCP-Server** (Model Context Protocol) bereit: Ihr KI-Assistent kann **in der Dokumentation suchen** und **die API aufrufen** (Sportarten auflisten, die Quoten eines Spiels abrufen, die Historie, die Specials…) direkt in natürlicher Sprache.

<Info>
  URL des MCP-Servers: **`https://docs.apinn.io/mcp`** (Transport HTTP streamable).
</Info>

## Den Server verbinden

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

    Dann in einer Sitzung: „liste die Live-Fußballspiele auf", „gib mir die Quoten des Events 1632003656".
  </Tab>

  <Tab title="Cursor">
    Fügen Sie zu `~/.cursor/mcp.json` hinzu (oder *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"]
        }
      }
    }
    ```

    Starten Sie Claude Desktop neu; der Server `apinn` erscheint in der Werkzeugliste.
  </Tab>

  <Tab title="Anderer MCP-Client">
    Jeder MCP-kompatible Client (Transport **HTTP streamable**) kann sich verbinden mit:

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

## Authentifizierung

* Die Werkzeuge zur **Dokumentationssuche** funktionieren ohne Schlüssel.
* Die Werkzeuge, die **die API aufrufen**, verwenden Ihren **apinn-Schlüssel** (`X-API-Key`). Stellen Sie ihn dem Assistenten / in der Konfiguration des MCP-Clients bereit, wenn er danach fragt. Jeder Aufruf zählt auf Ihr [stündliches Quota](/de/rate-limits).

<Warning>
  Fügen Sie Ihren Schlüssel niemals in ein öffentliches Repository oder ein Bildschirmteilen ein. Behandeln Sie ihn wie ein Geheimnis.
</Warning>

## Was der Assistent tun kann

* „Welche Sportarten sind verfügbar?" → `/api/sports`
* „Gib mir die Live-Fußballspiele" → `/api/fixtures?sport_id=29&live=1`
* „Aktuelle Quoten des Events 1632003656" → `/api/odds`
* „Vollständige Quotenhistorie dieses Spiels" → `/api/odds?full_history=1`
* „Champions-League-Sieger: Quoten der Favoriten" → `/api/specials/outrights`

Alle [Endpoints der API-Referenz](/de/api-reference/introduction) werden als MCP-Werkzeuge bereitgestellt (nur lesend).