> ## Documentation Index
> Fetch the complete documentation index at: https://docs.panderra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop verbinden in 5 Min

> Verbinde deinen Big-Panda-Tenant per OAuth mit Claude Desktop und beantworte interne Fragen direkt aus deinem Wissen.

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

<Check>**Claude Desktop installiert** — Mac, Windows oder Linux. Aktuelle Version ([Download](https://claude.com/download)).</Check>
<Check>**Aktiver Big-Panda-Account** mit Login-Daten für deinen Tenant. Falls du noch keinen hast, [trage dich auf der Beta-Liste ein](https://big-panda.ai).</Check>
<Check>**Subdomain deines Tenants** — Format `<dein-tenant>.app.big-panda.ai`. Steht im Admin-UI oben links und in deiner Begrüßungs-Mail.</Check>

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

## Schritt 1 — Connector in Claude Desktop hinzufügen

<Steps>
  <Step title="Einstellungen öffnen">
    Klicke in Claude Desktop oben links auf das Menü und wähle
    **Einstellungen** → **Connectors** (engl. „Settings → Connectors").
  </Step>

  <Step title="Custom Connector hinzufügen">
    Wähle **„Add custom connector"** (am Ende der Connector-Liste).
    Es öffnet sich ein Dialog mit einem URL-Eingabefeld.
  </Step>

  <Step title="MCP-URL eintragen">
    Gib deine Big-Panda-MCP-URL ein:

    ```
    https://<dein-tenant>.app.big-panda.ai/mcp/sse
    ```

    Beispiel für den Tenant `acme-gmbh`:

    ```
    https://acme-gmbh.app.big-panda.ai/mcp/sse
    ```

    Bestätige mit **„Add"**.
  </Step>
</Steps>

<Tip>
  Die URL endet auf `/mcp/sse` — der Pfad ist URL-Compat aus der ursprünglichen SSE-Implementierung; der Transport dahinter ist Streamable HTTP. Wenn du nur `/mcp` einträgst, leitet der Server automatisch auf `/mcp/sse` um — beides funktioniert, `/mcp/sse` ist der saubere Weg.
</Tip>

## Schritt 2 — Im Browser anmelden

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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"**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Schritt 3 — Wissens-Tools aktivieren

<Steps>
  <Step title="Tool-Liste öffnen">
    In Claude Desktop unten im Eingabefeld auf das **Werkzeug-Symbol**
    klicken. Du siehst alle verfügbaren Connectors mit ihren MCP-Tools.
  </Step>

  <Step title="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](/mcp-tools/overview).
  </Step>
</Steps>

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

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

## 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:

```text theme={null}
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](/concepts/bootstrap).

## Verifikation

<AccordionGroup>
  <Accordion title="Wissens-Suche funktioniert">
    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.
  </Accordion>

  <Accordion title="Schreibrechte respektiert">
    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](/concepts/auth)).
  </Accordion>

  <Accordion title="Sichtbarkeit gefiltert">
    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.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="„Could not connect“ beim Hinzufügen">
    Prüfe die URL — sie muss exakt `https://<tenant>.app.big-panda.ai/mcp/sse`
    lauten. Häufige Fehler: vergessenes `app.`-Segment, Tippfehler in
    der Tenant-ID, http statt https, fehlendes `/sse` am Ende.
  </Accordion>

  <Accordion title="Login-Seite zeigt „Unbekannter Mandant“">
    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).
  </Accordion>

  <Accordion title="Consent-Screen zeigt zu viele Berechtigungen">
    Der Consent listet die maximalen Scopes des MCP-Token-Typs. Was
    Claude Desktop **tatsächlich** darf, ist zusätzlich durch deine
    Rolle begrenzt. Ein `employee`-Account kann z.B. keine Skills
    schreiben, selbst wenn der Token den Scope `knowledge:write` hat.
  </Accordion>

  <Accordion title="Tools tauchen in Claude Desktop nicht auf">
    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.
  </Accordion>

  <Accordion title="Claude antwortet, aber sucht nicht aktiv">
    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
  </Accordion>

  <Accordion title="Zugriff widerrufen">
    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.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Knowledge-Suche in 5 Min" href="/tutorials/wissens-suche" icon="magnifying-glass">
    Wie du das Such-Widget auf deiner Website oder im Shop einbindest
    und Endkunden direkt antworten lässt.
  </Card>

  <Card title="Eigene App per OAuth" href="/tutorials/oauth-setup" icon="key">
    Wenn du eine eigene Anwendung (Custom-GPT, n8n, eigenes Tool) gegen
    Big Panda authentifizieren willst.
  </Card>

  <Card title="Bootstrap konfigurieren" href="/concepts/bootstrap" icon="brain">
    So formulierst du das KI-Mentalmodell für deinen Tenant — Glossar,
    Stil, Tonfall, Standardannahmen.
  </Card>

  <Card title="MCP-Tools-Referenz" href="/mcp-tools/overview" icon="wrench">
    Die komplette Liste aller verfügbaren MCP-Tools mit Parametern und
    Beispielen.
  </Card>
</CardGroup>