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

# KI-Client verbinden

> Verbinde Claude, ChatGPT oder einen anderen MCP-Client mit deinem Famulor-Workspace

Der **Model Context Protocol (MCP)**-Endpunkt lässt eine KI-Anwendung mit denselben Workspace-Ressourcen arbeiten, die du im Dashboard nutzt – Assistenten, Anrufe, Kampagnen, Wissensdatenbanken und mehr – abhängig von deinem Plan, deiner Rolle und den freigegebenen Berechtigungen.

```text theme={null}
https://app.famulor.io/mcp
```

Auf einer White-Label-Domain verwendest du stattdessen diese Domain. Anmelde- und Zustimmungsbildschirm verwenden dasselbe Branding. Dein Plan muss **Connect AI / MCP** enthalten.

<Note>
  Diese Seite behandelt das Verbinden eines KI-Clients (Claude, ChatGPT und andere) *mit* Famulor. Möchtest du stattdessen einen deiner Assistenten *nach außen* mit einem externen MCP-Server mitten im Anruf verbinden – deinem eigenen CRM oder internen Tools? Siehe stattdessen [Tools & Webhooks](/de/api/tools-and-webhooks#externe-mcp-server).
</Note>

## Clients verbinden

<Tabs>
  <Tab title="Claude">
    1. Öffne **Settings → Connectors → Add custom connector**.
    2. Trage `https://app.famulor.io/mcp` ein.
    3. Melde dich an und bestätige die angeforderten Berechtigungen.
    4. Die freigegebenen Tools erscheinen in Claude.
  </Tab>

  <Tab title="ChatGPT">
    1. Öffne **Settings → Connectors → Create**.
    2. Trage `https://app.famulor.io/mcp` ein und wähle **OAuth**.
    3. Melde dich an und bestätige die angeforderten Berechtigungen.
  </Tab>

  <Tab title="Andere Clients">
    Cursor, Windsurf, VS Code, Cline, Continue, Zed und jeder andere MCP-kompatible Client funktionieren auf die gleiche Weise: Richte den Client auf den obigen Endpunkt und schließe die OAuth-Anmeldung ab. Für vertrauenswürdige Server-zu-Server-Integrationen kannst du stattdessen einen Workspace-API-Key als Bearer-Token senden – siehe [Authentifizierung](#authentifizierung-und-zustimmung) weiter unten.
  </Tab>
</Tabs>

### Von Famulor aus verbinden

Wähle **Connect** in der Sidebar oder **Use with ChatGPT & Claude** im Dashboard. Der Dialog zeigt die passende MCP-URL für deine aktuelle Domain, lässt dich auswählen, mit welchen Toolgruppen du dich verbinden möchtest (siehe [Tools und Scopes](/de/mcp/tools-and-scopes)), und bietet Start-Prompts für gängige Aufgaben – einen Assistenten bauen, einen fehlerhaften diagnostizieren, deinen letzten Anruf analysieren, dich anhand deiner letzten 30 Anrufe verbessern oder eine Kampagne starten. Dieselbe Auswahl steht jederzeit unter **Settings → API & MCP** zur Verfügung.

<Tip>
  Wenn du von einem Coding-Agenten wie Claude Code, Cursor oder Codex aus arbeitest, installiere den quelloffenen [Famulor Skill](https://github.com/bekservice/Famulor-Skill) mit `npx skills add bekservice/Famulor-Skill`. Er bringt die Endpunkt-Konfiguration mit (füge die URL manuell hinzu, falls dein Client sie nicht automatisch übernimmt) sowie Famulor-spezifische Arbeitsregeln zusätzlich zum reinen MCP-Zugriff: aktuellen Zustand lesen, bevor du ihn änderst, alles bestätigen lassen, was sich schwer rückgängig machen lässt, und innerhalb des authentifizierten Workspace bleiben.
</Tip>

## Authentifizierung und Zustimmung

Kompatible Clients starten die OAuth-Anmeldung automatisch. Der Zustimmungsbildschirm zeigt die angeforderten Toolgruppen, bevor irgendetwas freigegeben wird, und deine Auswahl wird für künftige Verbindungen gespeichert. Freigegebene Verbindungen werden unter **Settings → API & MCP** aufgelistet, wo sich jede davon jederzeit widerrufen lässt.

Für eine manuelle oder Server-zu-Server-Verbindung sendest du stattdessen einen Workspace-API-Key:

```http theme={null}
Authorization: Bearer fam_...
```

Verwende die engstmöglichen Scopes. Schreib-Scopes schließen den entsprechenden Lesezugriff mit ein.

## Was ein verbundener Client sehen kann

Ein per OAuth verbundener Client (Claude, ChatGPT und ähnliche) erhält standardmäßig eine kuratierte Auswahl von **7 Toolgruppen** – `assistants`, `calls`, `campaigns`, `knowledge`, `telephony`, `billing` und `settings` – statt des vollständigen Katalogs. Das ist eine bewusste Begrenzung, keine Plan-Einschränkung: Famulors vollständiger Tool-Katalog ist umfangreich, und ihn komplett auf einmal zu laden, ist mehr, als diese Clients zuverlässig unterstützen. Wählst du beim Einrichten alle Gruppen aus, landest du aus diesem Grund trotzdem bei der kuratierten Auswahl.

Um weniger Gruppen zu nutzen, wähle beim Verbinden die nicht benötigten ab, oder ändere deine Auswahl jederzeit unter **Settings → API & MCP**. Siehe [Tools und Scopes](/de/mcp/tools-and-scopes) dafür, was jede Gruppe abdeckt.

Wenn deine Integration wirklich den vollständigen Katalog braucht – alle 13 Gruppen –, verbinde dich mit einem Workspace-API-Key statt mit OAuth und füge der Endpunkt-URL `?toolsets=all` hinzu. Dieser Weg ist für deine eigenen Skripte und Server-zu-Server-Integrationen gedacht, nicht für einen allgemeinen KI-Client.

## Rate-Limits

MCP-Anfragen sind ratenbegrenzt, damit die Plattform für jeden Workspace reaktionsschnell bleibt:

| Limit                   | Wert           |
| ----------------------- | -------------- |
| Anfragen pro Credential | 120 pro Minute |
| Anfragen pro Workspace  | 600 pro Minute |
| Größe des Request-Bodys | 1 MB           |

Ein Client, der diese Grenzwerte überschreitet, erhält eine `429`-Antwort und sollte vor einem erneuten Versuch warten – siehe [Fehler](/de/mcp/tools-and-scopes#fehler).

<Tip>
  Dieselben Kundenfunktionen stehen über die [REST-API](/de/api-reference/introduction) zur Verfügung. Wähle die Schnittstelle, die am besten zu deiner Integration passt.
</Tip>