Verbindung zu MCP-kompatiblen Tools herstellen – Helpdesk

Dieser Artikel erklärt, wie Scanova mit LLM-gestützten Tools wie ChatGPT, LangChain, AutoGen, Cursor, Claude Desktop und anderen unter Verwendung des Model Context Protocol (MCP) integriert wird.

Einführung

Das Model Context Protocol (MCP) ermöglicht eine sichere Integration zwischen einem Scanova-Konto und KI-Tools oder Entwicklungsumgebungen wie ChatGPT, LangChain, AutoGen, VS Code, Cursor und Claude Desktop. Mithilfe von MCP können Benutzer QR-Codes direkt aus MCP-kompatiblen Anwendungen generieren, verwalten und herunterladen, wodurch manuelle Schritte reduziert und Automatisierung ermöglicht wird.

Diese Integration eignet sich ideal für Entwickler und technische Teams, die mit groß angelegten oder KI-gesteuerten QR-Code-Workflows arbeiten.

A. Erstellen eines MCP-Tokens in Scanova

Um ein Scanova-Konto sicher mit einem MCP-kompatiblen Tool zu verknüpfen, gehen Sie wie folgt vor:

Melden Sie sich im Scanova-Konto an
Gehen Sie in der linken Seitenleiste zu Integrationen > Model Context Protocol (MCP)
Klicken Sie auf Einrichten
Klicken Sie auf Token generieren

Der generierte Token dient als Autorisierungsnachweis für den MCP-Server. Er sollte sicher aufbewahrt und nicht öffentlich geteilt werden.

B. Konfiguration des MCP-Clients

Nachdem der Token generiert wurde, muss er in die Konfigurationsdatei des MCP-kompatiblen Tools eingetragen werden. Nachfolgend finden Sie Beispielkonfigurationen für häufig verwendete Umgebungen:

Für Cursor (`~/.cursor/mcp.json`):

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

Für VS Code (`~/.vscode/mcp.json`):

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

Für Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):

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

Ersetzen Sie YOUR_SCANOVA_API_KEY_HERE durch den in Schritt A generierten Token.

C. Unterstützte Tools und Aktionen

Der Scanova MCP-Server unterstützt eine Reihe von Aktionen, die über Klartext-Eingaben oder direkt über unterstützte MCP-kompatible Tools ausgelöst werden können:

Tool	Beschreibung	Beispielphrase
`create_qr_code`	Einen neuen QR-Code erstellen	„create qr“, „make qr code“
`list_qr_codes`	Alle QR-Codes auflisten	„list qr codes“, „show qrs“
`update_qr_code`	Name oder URL eines QR-Codes bearbeiten	„update qr“, „edit qr code“
`retrieve_qr_code`	QR-Code-Details abrufen	„get qr details“, „qr info“
`download_qr_code`	QR-Code-Bild herunterladen	„download qr“, „get qr image“
`activate_qr_code`	Einen deaktivierten QR-Code reaktivieren	„activate qr“
`deactivate_qr_code`	Einen QR-Code deaktivieren	„deactivate qr“

Diese Tools verwenden die Scanova-API über die MCP-Schicht, um eine reibungslose und sichere Nutzung zu gewährleisten.

D. Öffentliches GitHub-Repository für Scanova MCP

Scanova stellt einen Open-Source-MCP-Server bereit, der geklont, erweitert oder lokal zu Entwicklungszwecken ausgeführt werden kann.

Besuchen Sie: Scanova MCP auf GitHub

Das Repository enthält:

Installationsanleitungen
Anweisungen zur Docker-Bereitstellung
Richtlinien zum lokalen Testen
Vollständige Liste der unterstützten Tools und API-Endpunkte

E. Fehlerbehebung

Problem	Vorgeschlagene Maßnahme
„API-Schlüssel wird benötigt“	Stellen Sie sicher, dass der Token korrekt unter `Authorization` in der Konfigurationsdatei eingetragen ist
„Ungültiger Token“-Fehler	Generieren Sie den Token im Scanova-Dashboard neu
„Verbindungsfehler“	Überprüfen Sie, ob die URL korrekt ist und Internetzugang besteht
„Tool nicht gefunden“	Starten Sie die IDE neu und stellen Sie sicher, dass die Konfiguration gültig ist

Den Status des MCP-Servers können Sie unter folgender Adresse prüfen: https://mcp.scanova.io/health

Wenn weitere Unterstützung benötigt wird

Für zusätzliche Anleitungen oder Hilfe bei der MCP-Einrichtung können Benutzer diese Wissensdatenbank besuchen oder sich an das Kundenserviceteam unter support@scanova.io wenden.