Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.big-panda.ai/llms.txt

Use this file to discover all available pages before exploring further.

Am Ende dieses Tutorials nutzt Claude Desktop die Wissensdatenbank deines Big-Panda-Tenants als Quelle. Du fragst Claude eine Frage zu internem Wissen, Claude sucht über die Big-Panda-MCP-Tools, antwortet mit Belegen und folgt deinen Skills und deinem Bootstrap. Die Verbindung läuft über OAuth 2.1 — Claude Desktop bekommt einen Token, der nur dir gehört, mit deinen Rollen und deiner Sichtbarkeits- Stufe. Es geht kein API-Key über den Tisch, und du kannst die Verbindung jederzeit über das Big-Panda-Admin-UI wieder trennen.

​
Voraussetzungen

Claude Desktop installiert — Mac, Windows oder Linux. Aktuelle Version (Download).
Aktiver Big-Panda-Account mit Login-Daten für deinen Tenant. Falls du noch keinen hast, trage dich auf der Beta-Liste ein.
Subdomain deines Tenants — Format <dein-tenant>.app.big-panda.ai. Steht im Admin-UI oben links und in deiner Begrüßungs-Mail.
Diese Anleitung gilt für die Cloud-Variante auf big-panda.ai. Bei On-Premise-Installationen ersetzt du die Hostnamen durch deinen eigenen, der OAuth-Flow ist identisch.

​
Schritt 1 — Connector in Claude Desktop hinzufügen

1

Einstellungen öffnen

Klicke in Claude Desktop oben links auf das Menü und wähle Einstellungen → Connectors (engl. „Settings → Connectors”).
2

Custom Connector hinzufügen

Wähle „Add custom connector” (am Ende der Connector-Liste). Es öffnet sich ein Dialog mit einem URL-Eingabefeld.
3

MCP-URL eintragen

Gib deine Big-Panda-MCP-URL ein:
https://<dein-tenant>.app.big-panda.ai/mcp
Beispiel für den Tenant acme-gmbh:
https://acme-gmbh.app.big-panda.ai/mcp
Bestätige mit „Add”.
Die URL endet auf /mcp — ohne Slash danach, ohne weitere Pfad-Segmente. Das ist der Streamable-HTTP-Endpoint, den Claude Desktop selbst per Discovery prüft.

​
Schritt 2 — Im Browser anmelden

Claude Desktop öffnet automatisch deinen Standard-Browser auf der Login-Seite deines Big-Panda-Tenants.
1

Login mit deinen Big-Panda-Zugangsdaten

Trage E-Mail und Passwort für deinen Tenant ein. Falls 2FA aktiviert ist, gibst du danach den Code aus deiner Authenticator-App ein.
2

Berechtigungen prüfen und freigeben

Du landest auf dem Consent-Screen. Hier siehst du:
  • Welcher Client um Zugriff bittet (Claude Desktop)
  • Welche Berechtigungen er bekommt: Wissen lesen/schreiben, Suchen, Chats führen
  • Dass diese Berechtigungen durch deine Rolle und deine Sichtbarkeits-Stufe zusätzlich begrenzt sind
Klicke „Erlauben”.
3

Zurück zu Claude Desktop

Der Browser zeigt eine Bestätigungsseite („Du kannst dieses Fenster schließen”). Wechsle zurück in Claude Desktop. Der Connector erscheint jetzt mit einem grünen „Connected”-Status.

​
Schritt 3 — Wissens-Tools aktivieren

1

Tool-Liste öffnen

In Claude Desktop unten im Eingabefeld auf das Werkzeug-Symbol klicken. Du siehst alle verfügbaren Connectors mit ihren MCP-Tools.
2

Big-Panda-Tools aktivieren

Stell sicher, dass die Big-Panda-Tools angehakt sind:
  • search_knowledge — semantische Suche in deiner Wissensbasis
  • get_knowledge_entry — Volltext eines Eintrags abrufen
  • list_skills / get_skill — deine angelegten Skills nutzen
  • get_bootstrap — dein KI-Mentalmodell laden
  • recall / remember — auf Memory zugreifen
  • load_project — kompletten Projekt-Kontext laden
Mehr zu diesen Tools findest du in der MCP-Tools-Referenz.

​
Schritt 4 — Erste Frage stellen

Stell Claude eine Frage zu Wissen, das in deiner Big-Panda-Wissensbasis liegt. Konkret und so, dass sie nur mit deinem internen Wissen beantwortbar ist: 
Wie sieht unser Reklamations-Workflow aus?
Claude entscheidet selbst, ob die Frage Big-Panda-Wissen braucht, ruft search_knowledge auf, lädt relevante Treffer mit get_knowledge_entry und beantwortet dir die Frage mit Quellen-Belegen.
Beim ersten Tool-Aufruf zeigt Claude Desktop einen Bestätigungs-Dialog: „Big Panda möchte search_knowledge ausführen.” Du kannst pro Aufruf erlauben oder „immer für diesen Connector” anhaken.

​
Schritt 5 — Bootstrap einbinden (optional, aber empfohlen)

Damit Claude jedes Gespräch mit dem Mentalmodell deines Unternehmens startet (Begriffs-Glossar, Abkürzungen, Standards, dein Tonfall), lass Claude beim Sitzungs-Start einmal get_bootstrap aufrufen. Du kannst das in deinem Claude-Desktop-System-Prompt hinterlegen: 
Lade beim Start dieser Sitzung einmal das Big-Panda-Bootstrap und
verwende es als Mentalmodell für alle weiteren Antworten. Nutze
Big-Panda-Skills proaktiv, wenn ihre Trigger passen.
Den Bootstrap-Inhalt selbst pflegst du im Big-Panda-Admin-UI unter Settings → KI-Bootstrap. Mehr dazu unter Bootstrap konfigurieren.

​
Verifikation

Frage Claude nach einem konkreten Eintrag aus deiner Wissensbasis. Antwort sollte den Eintrag zitieren (Titel, Auszug). Wenn Claude keine Quelle nennt, hat es nicht gesucht — siehe Troubleshooting.
Bitte Claude einen neuen Skill anzulegen. Wenn deine Rolle employee ist, kommt ein 403 Forbidden zurück — das ist korrekt. Skills schreiben dürfen nur Admin und Supervisor (siehe Schreibrechts-Enforcement).
Wenn dein Tenant Einträge mit Visibility restricted hat, auf die deine Rolle keinen Zugriff hat, tauchen sie auch über Claude nicht auf — der Visibility-Ceiling-Filter greift im Backend, unabhängig vom Client.

​
Troubleshooting

Prüfe die URL — sie muss exakt https://<tenant>.app.big-panda.ai/mcp lauten. Häufige Fehler: vergessenes app.-Segment, Tippfehler in der Tenant-ID, http statt https.
Der Subdomain-Teil deiner URL passt nicht zu einem registrierten Tenant. Schau im Admin-UI unter Account nach der korrekten Tenant-ID (steht auch in deiner Onboarding-Mail).
  1. Connector neu laden: in den Connector-Einstellungen einmal deaktivieren und wieder aktivieren.
  2. Token abgelaufen: Access-Tokens leben standardmäßig 1 Stunde, Refresh-Tokens werden automatisch erneuert. Falls die Verbindung lange gestanden hat und nicht erneuert wurde, trenne und verbinde neu.
  3. Claude Desktop aktualisieren: ältere Versionen unterstützen MCP-OAuth nicht.
Manche Modelle (vor allem ohne System-Prompt) versuchen die Frage aus eigenem Wissen zu beantworten, statt Tools aufzurufen. Hilft meist:
  • Frage explizit auf interne Quellen ausrichten („nutze unsere Wissensbasis und antworte mit Quellen”)
  • System-Prompt setzen (siehe Schritt 5)
  • Das stärkere Modell (Sonnet/Opus) wählen — Haiku tooled zurückhaltender
Im Big-Panda-Admin-UI unter Settings → Verbundene Apps siehst du alle aktiven OAuth-Clients. Mit „Trennen” revokest du den Token sofort — Claude Desktop wird beim nächsten Aufruf einen neuen Login verlangen.

​
Nächste Schritte

Knowledge-Suche in 5 Min

Wie du das Such-Widget auf deiner Website oder im Shop einbindest und Endkunden direkt antworten lässt.

Eigene App per OAuth

Wenn du eine eigene Anwendung (Custom-GPT, n8n, eigenes Tool) gegen Big Panda authentifizieren willst.

Bootstrap konfigurieren

So formulierst du das KI-Mentalmodell für deinen Tenant — Glossar, Stil, Tonfall, Standardannahmen.

MCP-Tools-Referenz

Die komplette Liste aller verfügbaren MCP-Tools mit Parametern und Beispielen.