MCP setup - Scanova API Documentation

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.

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

Claude
ChatGPT
Perplexity

Connectors-Einstellungen öffnen

Öffnen Sie in Claude Settings → Connectors.

Einen benutzerdefinierten Connector hinzufügen

Klicken Sie auf + Add custom connector.

Server-URL einfügen

Fügen Sie https://mcp.scanova.io/mcp aus dem Panel ein.

OAuth-Zugangsdaten einfügen

Fügen Sie die im Claude-Tab des Panels angezeigten Client ID und Client Secret ein.

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.

Entwicklermodus aktivieren

Öffnen Sie in ChatGPT Settings → Apps → Advanced settings und aktivieren Sie Developer mode.

Eine App erstellen

Erstellen Sie eine App und fügen Sie https://mcp.scanova.io/mcp als Server-URL ein.

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.

Autorisieren

Autorisieren Sie Scanova, wenn Sie dazu aufgefordert werden, und aktivieren Sie es anschließend über das Tools-Menü in Ihrem Chat.

Einen benutzerdefinierten Connector hinzufügen

Öffnen Sie in Perplexity Customise → Connectors und klicken Sie auf + Add Custom Connector.

Benennen und Server-URL einfügen

Vergeben Sie einen Namen und fügen Sie https://mcp.scanova.io/mcp als Server-URL ein.

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.

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.

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-Schlüssel mit environment=mcp, denselben Token-Typ, der unter Creating an API token 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:

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

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.

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 für alles, was Ihr KI-Assistent jetzt tun kann.

Weiterführende Informationen

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

​Voraussetzung

​Schritt 1: MCP-Integration öffnen

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

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

​Zugriff widerrufen

​Fehlerbehebung

​Nächster Schritt

​Weiterführende Informationen

Voraussetzung

Schritt 1: MCP-Integration öffnen

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

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

Zugriff widerrufen

Fehlerbehebung

Nächster Schritt

Weiterführende Informationen