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

# MCP setup

> Verbinden Sie Claude, ChatGPT, Perplexity oder einen beliebigen MCP-kompatiblen Client mit Ihrem Scanova-Konto.

<Note>
  Diese Anleitung basiert auf der MCP-Integrationskomponente des Dashboards (`McpBody`) und ihrer Konfiguration sowie der echten, öffentlichen `trycon/scanova-mcp`-Server-Quelle – nicht auf einem Live-Durchklick. Das für diese Überprüfung bereitgestellte Testkonto stieß auf eine Passkey-MFA-Herausforderung ohne zugänglichen Backup-Code, was eine automatisierte Browser-Anmeldung blockierte, bevor das Panel abfotografiert werden konnte. Jede URL, jede Client-Tab-Liste und jeder Schritt unten ist aus dem tatsächlich gerenderten Inhalt der Komponente übertragen, sollte also exakt mit dem Live-Panel übereinstimmen – melden Sie es, falls nicht.
</Note>

Es gibt zwei Wege, sich zu verbinden, je nachdem, ob Ihr KI-Tool native OAuth-basierte Connector-Unterstützung hat.

## Voraussetzung

Ihr Konto benötigt eine freigeschaltete MCP-Integration – siehe [Zugriffsvoraussetzungen](/de/mcp/overview#zugriffsvoraussetzungen). Zeigt die Kachel **Integrations → Model Context Protocol** **Upgrade** statt **Connect** an, ist der Rest dieser Seite noch nicht anwendbar.

## Schritt 1: MCP-Integration öffnen

Gehen Sie im Dashboard zu **Integrations** und klicken Sie auf die Kachel **Model Context Protocol**. Dies öffnet ein Setup-Panel mit Ihrer Scanova-MCP-Server-URL:

```
https://mcp.scanova.io/mcp
```

mit einem **OAuth**-Badge und einer Kopierschaltfläche. Dies ist die eine URL, mit der sich jeder Client unten verbindet – ein echter, aktiver Endpunkt (verifiziert anhand der Quelle des bereitgestellten Servers und seiner `/health`-/`/`-Info-Antworten), kein Platzhalter.

## Option A: OAuth-native Clients (Claude, ChatGPT, Perplexity)

Das Panel hat einen Tab pro Client, jeweils mit eigenen nummerierten Schritten und einem inline angezeigten **Client ID**/**Client Secret**-Paar (kopieren Sie diese aus dem Panel selbst – sie werden hier nicht wiedergegeben). Dies sind öffentliche Connector-Kennungen für das jeweilige KI-Produkt, kein persönliches Geheimnis; Sie schließen anschließend dennoch eine echte OAuth-Anmeldung und -Zustimmung gegenüber Scanova ab.

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="Connectors-Einstellungen öffnen">
        Öffnen Sie in Claude **Settings → Connectors**.
      </Step>

      <Step title="Einen benutzerdefinierten Connector hinzufügen">
        Klicken Sie auf **+ Add custom connector**.
      </Step>

      <Step title="Server-URL einfügen">
        Fügen Sie `https://mcp.scanova.io/mcp` aus dem Panel ein.
      </Step>

      <Step title="OAuth-Zugangsdaten einfügen">
        Fügen Sie die im Claude-Tab des Panels angezeigten **Client ID** und **Client Secret** ein.
      </Step>

      <Step title="Verbinden und autorisieren">
        Klicken Sie auf **Add**, dann auf **Connect**, und gewähren Sie den Zugriff. Melden Sie sich bei Scanova an, wenn Sie dazu aufgefordert werden.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="Entwicklermodus aktivieren">
        Öffnen Sie in ChatGPT **Settings → Apps → Advanced settings** und aktivieren Sie **Developer mode**.
      </Step>

      <Step title="Eine App erstellen">
        Erstellen Sie eine App und fügen Sie `https://mcp.scanova.io/mcp` als Server-URL ein.
      </Step>

      <Step title="OAuth-Zugangsdaten einfügen">
        Klicken Sie auf **Advanced OAuth settings** und fügen Sie die im ChatGPT-Tab des Panels angezeigten **Client ID** und **Client Secret** ein.
      </Step>

      <Step title="Autorisieren">
        Autorisieren Sie Scanova, wenn Sie dazu aufgefordert werden, und aktivieren Sie es anschließend über das Tools-Menü in Ihrem Chat.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Perplexity">
    <Steps>
      <Step title="Einen benutzerdefinierten Connector hinzufügen">
        Öffnen Sie in Perplexity **Customise → Connectors** und klicken Sie auf **+ Add Custom Connector**.
      </Step>

      <Step title="Benennen und Server-URL einfügen">
        Vergeben Sie einen Namen und fügen Sie `https://mcp.scanova.io/mcp` als Server-URL ein.
      </Step>

      <Step title="OAuth-Zugangsdaten einfügen">
        Klicken Sie auf den Schalter **Advanced** und fügen Sie die im Perplexity-Tab des Panels angezeigten **Client ID** und **Client Secret** ein.
      </Step>

      <Step title="Hinzufügen und autorisieren">
        Klicken Sie auf **Add**, autorisieren Sie Scanova, wenn Sie dazu aufgefordert werden, und beginnen Sie, es in Ihren Perplexity-Unterhaltungen zu nutzen.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Option B: konfigurationsdateibasierte Clients (Cursor, VS Code, Claude Desktop oder alles andere)

Für MCP-Clients ohne native OAuth-Connector-Oberfläche – sie erwarten stattdessen eine JSON-Konfigurationsdatei – klappen Sie unten im Panel **Use a token instead** aus. Dies erzeugt einen Scanova-[Management-API](/de/api-reference/management-api/overview)-Schlüssel mit `environment=mcp`, denselben Token-Typ, der unter [Creating an API token](/de/api-reference/management-api/tokens/create) dokumentiert ist. Klicken Sie auf **Generate token** und kopieren Sie anschließend den angezeigten Wert (im Panel maskiert; die Kopierschaltfläche überträgt den vollständigen Wert in Ihre Zwischenablage).

Fügen Sie ihn als Wert des `Authorization`-Headers zur MCP-Konfiguration Ihres Clients hinzu – dies ist genau das Format, das im eigenen README des Servers dokumentiert ist:

<CodeGroup>
  ```json Cursor (~/.cursor/mcp.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```

  ```json VS Code (~/.vscode/mcp.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```

  ```json Claude Desktop (claude_desktop_config.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```
</CodeGroup>

<Warning>
  Setzen Sie den rohen Token-Wert in den `Authorization`-Header – ohne `Bearer`-Präfix. Der Server liest, was auch immer in diesem Header steht (er akzeptiert auch `X-API-Key` oder `Scanova-API-Key`) und leitet ihn unverändert an Scanovas Management API weiter, die alles außer dem reinen Schlüssel ablehnt.
</Warning>

Starten Sie Ihre IDE/Ihren Client nach dem Speichern der Konfiguration neu.

## Zugriff widerrufen

**Token-Clients:** Klicken Sie im erweiterten Abschnitt **Use a token instead** des Panels auf das Papierkorb-Symbol neben dem Token und bestätigen Sie. Dies deaktiviert sofort jeden MCP-Client, der dieses Token verwendet.

**OAuth-Clients (Claude/ChatGPT/Perplexity):** Entfernen Sie den Connector aus der eigenen Connector-/Einstellungsliste des jeweiligen KI-Tools – es verwendet ein standardmäßiges OAuth-Access-Token, das speziell für diesen Client ausgestellt wurde, unabhängig von der obigen Token-Alternative.

## Fehlerbehebung

* **"Invalid token" / Tool-Aufrufe scheitern mit 401** – das Token wurde widerrufen oder ist abgelaufen. Erzeugen Sie ein neues und aktualisieren Sie die Konfiguration Ihres Clients.
* **Tool nach dem Hinzufügen des Servers nicht gefunden** – starten Sie Ihre IDE oder Ihren Client neu; die meisten MCP-Clients rufen die Tool-Liste nur einmal ab, beim Start oder Verbindungsaufbau.
* **Verbindungsfehler** – prüfen Sie, ob die URL exakt `https://mcp.scanova.io/mcp` lautet (nicht `/health` oder der reine Origin) und ob Ihr Netzwerk sie erreichen kann.

## Nächster Schritt

Siehe [Available tools](/de/mcp/available-tools) für alles, was Ihr KI-Assistent jetzt tun kann.

## Weiterführende Informationen

* [MCP overview](/de/mcp/overview) – was der Server tut, die Zugriffsvoraussetzungen und das Kontingent-Gate `INTEGRATION_MCP`.
* [Available tools](/de/mcp/available-tools) – die vollständige, verifizierte Liste der nach dem Verbinden verfügbaren Tools.
* [Create an API token](/de/api-reference/management-api/tokens/create) – derselbe Schlüsseltyp, den die hier beschriebene Token-Alternative erzeugt, mit `environment=mcp`.
* [Management API overview](/de/api-reference/management-api/overview) – die Zwei-Host-Auth-Architektur, gegen die sich die Token-Alternative authentifiziert.