Verbinde einen MCP-Client mit HappySupport

Du kannst externe, MCP-kompatible Tools mit HappySupport verbinden und so Coding-Agenten und Chat-Apps Zugriff auf dein Help Center, deine Artikel und dein Glossar geben. Du brauchst keinen API-Schlüssel. Kompatible Clients erkennen den Login-Flow automatisch durch OAuth.

Du musst in einer Unternehmensorganisation arbeiten. Persönliche Organisationen können nicht mit externen Apps verbunden werden.

Öffne die MCP-Einstellungen

1. Gehe zu Einstellungen
   Melde dich bei HappySupport an und öffne das Hauptprodukt. Klicke auf "Einstellungen" in der Seitenleiste.

2. Öffne die MCP-Seite
   Klicke im Einstellungen-Seitenmenü unter "Aktive Organisation" auf "MCP". Dies öffnet die MCP-Einstellungsseite.

Richte einen Coding-Agent ein

3. Wähle deinen Client
   Klicke im Bereich "Coding-Agenten" auf den Tab für deinen Client: "Claude Code", "Codex", "GitHub Copilot" oder "Sonstiges". Der ausgewählte Tab zeigt Anweisungen zur Einrichtung und eine kopierbare Serveradresse.

4. Kopiere die Serveradresse oder den Befehl
   Klicke auf die "Kopieren"-Schaltfläche neben der Adresse oder dem Befehl im Tab. Die Schaltfläche ändert sich kurz, um das Kopieren zu bestätigen.

5. Füge den Server zu deinem Client hinzu
   Folge den Anweisungen für deinen spezifischen Client:

   • Claude Code: Füge den Server von deinem Terminal aus mit dem angezeigten Befehl hinzu, dann starte Claude Code. Führe /mcp aus, wähle happysupport aus und klicke auf "Authentifizieren".
   • Codex: Füge die angezeigte Serverkonfiguration mit Codex CLI oder ihrer Konfigurationsdatei hinzu, führe dann den angezeigten Login-Befehl aus.
   • GitHub Copilot: Füge den Server in .vscode/mcp.json hinzu oder nutze "MCP: Add Server" aus der VS Code-Befehlspalette und wähle "HTTP". Starte den Server mit der "Start"-Schaltfläche über dem Servereintrag oder nutze "MCP: List Servers" > happysupport > "Start", bestätige dann VS Codes Anfrage zur Authentifizierung bei HappySupport.
   • Sonstiges: Füge einen Remote-MCP-Server mit Streaming-HTTP hinzu und füge die im Tab "Sonstiges" angezeigte Serveradresse ein. Diese Methode gilt auch für Clients wie Cursor, die OAuth und MCP-Autorisierungserkennung unterstützen.

Richte eine Chat-App ein

6. Wähle deine Chat-App
   Wähle im Bereich "Chat-Apps" den relevanten Tab aus: "Claude", "ChatGPT" oder "Gemini".

7. Füge den Connector in deiner App hinzu
   Folge den Anweisungen für deine spezifische App:

   • Claude: Öffne "Einstellungen > Connectors", klicke auf "Custom Connector hinzufügen", gib "HappySupport" im Namensfeld ein, füge die Serveradresse in das Feld "Server URL" ein, klicke auf "Hinzufügen" und dann auf "Verbinden" für den neuen Connector. Custom Connectors erfordern einen bezahlten Claude-Plan.
   • ChatGPT: Öffne die ChatGPT-Einstellungen und aktiviere Developer Mode, falls dies von deinem Plan oder Workspace erforderlich ist. Füge HappySupport als benutzerdefinierten Remote-MCP-Server oder Connector hinzu, füge die Serveradresse ein, wähle OAuth, wenn du dazu aufgefordert wirst, und schließe den Autorisierungsflow ab. Je nach deiner ChatGPT-Version können diese Optionen unter Apps, Connectors oder Plugins angezeigt werden. Bezahlte Pläne können erforderlich sein, und Business- oder Enterprise-Nutzer müssen möglicherweise einen Workspace-Administrator bitten, den Developer Mode zu aktivieren.
   • Gemini: Öffne "Einstellungen & Hilfe > Verbundene Apps", klicke dann unter "Custom apps for Spark" auf "Custom App hinzufügen", füge die Serveradresse ein und klicke auf "Weiter". Custom Apps erfordern Zugriff auf Gemini Spark und ein persönliches Google-Konto.

Autorisiere die Verbindung

8. Überprüfe die Autorisierungsanfrage
   Wenn der Client die HappySupport-Autorisierungsseite öffnet, ist die Seite mit "App verbinden" überschrieben. Falls du abgemeldet warst, wirst du zunächst angemeldet und kehrst dann zur Autorisierungsanfrage zurück. Überprüfe den Namen der Anwendung. Der Name wird von der verbindenden Anwendung bereitgestellt und wird von HappySupport nicht überprüft. Falls du die Verbindung nicht selbst gestartet hast, klicke auf "Ablehnen". Es wird nichts verbunden und nichts geteilt.

9. Wähle eine Organisation
   Wähle im Bereich für Organisationszugriff die Organisation mit dem Organisations-Selektor aus. Nur berechtigte Unternehmensorganisationen werden angezeigt. Die "Erlauben"-Schaltfläche bleibt deaktiviert, bis du eine Organisation auswählst.

10. Wähle eine Zugriffsstufe
    Wähle eine Zugriffsstufe mit den Radio-Schaltflächen:

    • Lesen und Schreiben: Erlaubt dem Client, Inhalte zu durchsuchen und Artikel sowie Glossareinträge zu erstellen, zu ändern, zu verschieben und zu löschen. Dies ist standardmäßig ausgewählt.
    • Nur Lesen: Erlaubt dem Client, das Help Center, Artikel und Glossareinträge zu durchsuchen, verhindert aber, dass etwas verändert wird.

11. Genehmige die Verbindung
    Klicke auf "Erlauben", um die Verbindung zu genehmigen. Der Browser kehrt zum MCP-Client zurück, der die Authentifizierung abschließt und sein eigenes Zugangstoken speichert. Dein Browser-Sitzungstoken wird nicht an den Client weitergegeben.

Behandle Autorisierungsfehler

12. Abgelaufen oder bereits verwendet
    Falls die Autorisierungsanfrage abgelaufen ist oder bereits verwendet wurde, zeigt der Bildschirm "Diese Anfrage ist nicht mehr gültig" und "Abgelaufen oder bereits verwendet". Es wurde nichts verbunden oder geteilt. Starte die Verbindung von deinem externen Client neu.

13. Keine berechtigte Organisation
    Falls dein Konto nur eine persönliche Organisation hat, zeigt der Bildschirm "Es kann keine Organisation verbunden werden". Externe Apps können sich nur mit einer Unternehmensorganisation verbinden. Erstelle eine Unternehmensorganisation oder trete einer bei und versuche es erneut.

Die Verbindung bleibt an die Organisation gebunden, die du während der Zustimmung ausgewählt hast, auch wenn du später in HappySupport zu einer anderen Organisation wechselst. Alle Schreibvorgänge über die Verbindung werden deinem Benutzerkonto zugeordnet. Wenn du deine Mitgliedschaft in dieser Organisation beendest, wird die Verbindung sofort unterbrochen.