SmartCompanion MCP-Server

Mit dem SmartCompanion MCP-Server pflegen Sie Ihren Audioguide direkt aus einem KI-Assistenten wie Claude, ChatGPT, Cursor oder VS Code: Stationen und Touren anlegen, Texte kürzen und übersetzen, Bilder und Audios hinzufügen oder das Design der App anpassen. Der Server nutzt das offene Model Context Protocol (MCP) und richtet sich an Museen, Schlösser und Ausstellungen, die SmartCompanion nutzen.

Sie brauchen dafür ein SmartCompanion-Konto. Kostenloses Konto anlegen

Assistenten verbinden

In allen Assistenten fügen Sie die Server-Adresse oben hinzu und melden sich anschließend mit Ihrem SmartCompanion-Konto an. Die Menünamen können sich mit neuen Versionen der Assistenten ändern.

Claude (Web und Desktop)

1. Öffnen Sie Customize › Connectors und wählen Sie „+ Add“ › „Add custom connector“.
2. Geben Sie einen Namen ein, z. B. „SmartCompanion“, und die Server-Adresse. Bestätigen Sie mit Continue und Add.
3. Melden Sie sich mit Ihrem SmartCompanion-Konto an und bestätigen Sie den Zugriff.
4. Aktivieren Sie den Connector im Chat über „+“ › Connectors.

Custom Connectors sind in allen Claude-Tarifen verfügbar, im kostenlosen Tarif ist ein eigener Connector möglich. In Team- und Enterprise-Konten fügen Administratoren den Connector unter Organization settings › Connectors hinzu. Details: Anleitung von Anthropic.

Claude Code

claude mcp add --transport http smartcompanion https://admin.smartcompanion.app/mcp

Starten Sie danach Claude Code, rufen Sie /mcp auf und melden Sie sich beim Server „smartcompanion“ an. Haben Sie den Connector bereits in Claude im Browser eingerichtet, steht er in Claude Code automatisch zur Verfügung.

ChatGPT

1. Öffnen Sie in ChatGPT im Browser die Plugins, wählen Sie „+“ › „Add custom MCP server“.
2. Geben Sie einen Namen und unter Connection die Server-Adresse ein, als Authentifizierung OAuth.
3. Bestätigen Sie den Hinweis und wählen Sie „Create as a plugin“. Installieren Sie das Plugin und melden Sie sich an.
4. Wählen Sie den Server in einem neuen Chat mit @ aus.

Eigene MCP-Server sind nicht in jedem ChatGPT-Tarif und nur im Browser verfügbar; in Firmen-Workspaces legen Administratoren fest, wer sie hinzufügen darf. Details: Anleitung von OpenAI.

Cursor

Tragen Sie den Server in ~/.cursor/mcp.json (für alle Projekte) oder .cursor/mcp.json (für ein Projekt) ein:

{
  "mcpServers": {
    "smartcompanion": {
      "url": "https://admin.smartcompanion.app/mcp"
    }
  }
}

VS Code

Tragen Sie den Server in .vscode/mcp.json oder in die MCP-Konfiguration Ihres Profils ein:

{
  "servers": {
    "smartcompanion": {
      "type": "http",
      "url": "https://admin.smartcompanion.app/mcp"
    }
  }
}

Beim ersten Verbinden öffnet sich der Browser für die Anmeldung.

Anmeldung und Berechtigungen

• Anmeldung mit Ihrem SmartCompanion-Konto (OAuth 2.1): Sie melden sich im Browser an und bestätigen den Zugriff. Sie brauchen keine API-Schlüssel und geben Ihr Passwort nicht an den Assistenten weiter.
• Automatische Registrierung: Der Assistent registriert sich beim ersten Verbinden selbst beim Server (Dynamic Client Registration), Sie müssen nichts manuell einrichten.
• Gleiche Rechte wie Ihr Konto: Der Assistent sieht und ändert nur die Audioguides, die Sie auch im Admin bearbeiten dürfen.
• Jederzeit widerrufbar: Alle verbundenen Assistenten sehen Sie im Admin unter „KI-Verbindungen“, dort können Sie den Zugriff jederzeit entziehen.

Werkzeuge

Der Server stellt 25 Werkzeuge bereit. Die Spalte „Art“ zeigt, ob ein Werkzeug nur liest, etwas ändert oder löscht; viele Assistenten fragen vor ändernden und löschenden Aktionen nach.

Bilder, Audios und Logos übergibt der Assistent als öffentliche Adresse oder über einen Upload-Link: Mit create-upload-link erstellt er einen Link, über den Sie Dateien im Browser hochladen. So bleiben Qualität und Metadaten Ihrer Dateien erhalten.

Entwurf und Veröffentlichung

Neue Konten starten mit einem Beispiel-Audioguide, sodass Sie gleich mit echten Inhalten ausprobieren können. Alle Änderungen über MCP landen im Entwurf Ihres Audioguides: Sie sehen sie nach wenigen Sekunden in der unveröffentlichten Vorschau im Admin und prüfen sie dort. Die Veröffentlichung wird nach einer kurzen Prüfung durch SmartCompanion freigeschaltet; danach veröffentlichen Sie selbst im Admin. Über MCP ist Veröffentlichen nicht möglich, get-audioguide zeigt aber, ob die Veröffentlichung schon freigeschaltet ist.

Beispiele

• „Zeige mir alle Touren meines Audioguides.“
• „Lege für die neue Sonderausstellung eine Tour mit acht Stationen an. Die Texte findest du im angehängten Dokument.“
• „Kürze alle Stationstexte der Tour ‚Rittersaal‘ auf maximal 120 Wörter und behalte den Tonfall bei.“
• „Ergänze bei allen Stationen die englischen Übersetzungen, wo sie noch fehlen.“
• „Ersetze das Titelbild der Familientour durch das Foto, das ich gerade hochgeladen habe.“
• „Passe die Primärfarbe der App an unser neues Corporate Design an.“

Datenschutz

Über den MCP-Server verarbeitet SmartCompanion Ihre Kontodaten für die Anmeldung, die Zugriffsschlüssel des verbundenen Assistenten und die Inhalte Ihres Audioguides, die der Assistent liest oder ändert. Ihr KI-Anbieter (z. B. Anthropic oder OpenAI) verarbeitet diese Inhalte nach seinen eigenen Bedingungen. Personenbezogene Daten von Besucherinnen und Besuchern Ihrer App sind dabei nicht im Spiel. Mehr dazu in unserer Datenschutzerklärung.

Fehlerbehebung und Support

• Die Adresse zeigt im Browser einen Fehler (405): Das ist richtig so – der Server ist nur für KI-Assistenten gedacht, nicht für den Browser.
• Die Anmeldung schlägt fehl: Sie brauchen zuerst ein SmartCompanion-Konto. Prüfen Sie außerdem, ob die Adresse genau https://admin.smartcompanion.app/mcp lautet.
• Der Assistent sieht keinen Audioguide: Ihr Konto hat noch keinen Audioguide oder keine Berechtigung dafür.
• Neue Werkzeuge erscheinen nicht: Starten Sie einen neuen Chat oder verbinden Sie den Server neu.

Fragen? Schreiben Sie uns an hello@smartcompanion.app.