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

# Tools und Scopes

> Der vollständige MCP-Tool-Katalog, wie du ihn eingrenzst, und das schreibgeschützte öffentliche Profil

Sobald ein Client verbunden ist (siehe [KI-Client verbinden](/de/mcp/overview)), erreicht normale Sprache jedes Tool, für das er freigegeben ist. Diese Seite behandelt den vollständigen Katalog, wie du ihn eingrenzst, und was bei lang laufenden oder fehlgeschlagenen Vorgängen passiert.

## Toolgruppen

Der vollständige Katalog ist in 13 Gruppen organisiert. Eine Verbindung per Workspace-API-Key erhält standardmäßig den vollständigen Katalog; eine OAuth-Verbindung (Claude, ChatGPT) erhält standardmäßig eine kuratierte Teilmenge von 7 – siehe [Was ein verbundener Client sehen kann](/de/mcp/overview#was-ein-verbundener-client-sehen-kann).

| Gruppe        | Kundenseitige Funktionen                                                                                                                                                                                                    |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `assistants`  | Assistenten, Versionen, Modelle, Stimmen, wiederverwendbare Tools, Buchungen und Simulationen                                                                                                                               |
| `calls`       | Anrufe, Gesprächsverlauf, Transkripte und erlaubte Anrufaktionen                                                                                                                                                            |
| `campaigns`   | Kampagnen, Zielgruppen, Leads, Sperrlisten und CRM-Synchronisierung                                                                                                                                                         |
| `messaging`   | Messaging- und E-Mail-Connectors, Vorlagen und Gespräche                                                                                                                                                                    |
| `telephony`   | Telefonnummern, SIP-Trunks, eigene Carrier-Verbindungen und BYOC-Import, Anrufer-ID- und Nummernverifizierung sowie das vollständige Famulor-Loop-System – Presence, Ring Groups, Queues, Routing-Regeln, Geräte und Recall |
| `knowledge`   | Wissensdatenbanken, Dokumente, Website-Importe und verbundene Dateiquellen                                                                                                                                                  |
| `dashboards`  | Analyse-Dashboards und Widgets                                                                                                                                                                                              |
| `automations` | Automatisierungen, Verbindungen, Milian Missions und Ausführungsverlauf                                                                                                                                                     |
| `billing`     | Guthaben, Nutzung, Transaktionen, Empfehlungen und Outbound-Limits                                                                                                                                                          |
| `settings`    | Workspace-Einstellungen, Domains, API-Keys und Aufbewahrung                                                                                                                                                                 |
| `platform`    | White-Label-Kundenverwaltung für berechtigte Reseller                                                                                                                                                                       |
| `migration`   | Famulor-1.0-Ressourcen oder inaktive Assistenten-Hüllen aus Retell AI, Vapi und Synthflow prüfen und importieren                                                                                                            |
| `tasks`       | Länger laufende Exporte, Crawls, Simulationen und Kampagnenvorbereitung                                                                                                                                                     |

Der MCP-Client erhält für jedes Tool, das er nutzen darf, das aktuelle Eingabeschema, die Berechtigungen und Sicherheitshinweise. Diese Live-Erkennung ist die verbindliche Referenz für einzelne Tool-Argumente.

## Sichtbare Tools auswählen

Wähle beim Verbinden eine oder mehrere Gruppen aus:

```text theme={null}
https://app.famulor.io/mcp?toolsets=assistants,calls
```

Du kannst auch `X-MCP-Toolsets: assistants,calls` senden. Der Header hat Vorrang vor dem Query-Parameter. Mit `list_mcp_toolsets` siehst du die für dein Konto verfügbaren Gruppen – dieses Tool ist immer verfügbar, unabhängig davon, welche Gruppen du ausgewählt hast.

Für eine Verbindung per Workspace-API-Key fügst du `?toolsets=all` hinzu, um statt der standardmäßig kuratierten Auswahl den vollständigen Katalog mit allen 13 Gruppen zu erhalten.

## Öffentliches Directory-Profil

Die geprüfte ChatGPT- und Claude-Directory-Verbindung verwendet:

```text theme={null}
https://app.famulor.io/mcp?profile=assistant-history
```

Dieses Profil ist auf schreibgeschützte Assistenteninformationen und schreibgeschützten Gesprächsverlauf begrenzt. Es schließt Änderungen an Assistenten, ausgehende Anrufe, Kampagnen, Messaging, Telefonnummernverwaltung, Abrechnung, Integrationen und Toolgruppen-Erkennung aus. Benutzerdefinierte MCP-Verbindungen behalten die bei ihrer eigenen Einrichtung gewählten Berechtigungen.

## Länger laufende Aufgaben

Website-Importe, Simulationen, History-Exporte und große Kampagnenvorbereitungen können als MCP-Tasks weiterlaufen. Ein kompatibler Client kann den Fortschritt anzeigen, das Ergebnis abrufen oder einen Abbruch anfordern. Der Abbruch stoppt verbleibende Arbeit, wenn möglich; eine bereits von einem externen Dienst angenommene Aktion kann trotzdem noch abgeschlossen werden.

Exporte verwenden kurzlebige, private Download-Links. Aufgaben und ihre Ergebnisse bleiben auf den Workspace und das Credential begrenzt, das sie erstellt hat.

Anrufverlaufs-Tools liefern ein providerneutrales `failure`-Objekt, wenn ein Anruf nicht abgeschlossen werden kann. Nutze dessen Code, kundensichere Meldung, Wiederholungshinweis und empfohlene Aktion, statt dich auf infrastrukturspezifische Details zu verlassen.

## Fehler

| Status | Bedeutung                                                                                          |
| ------ | -------------------------------------------------------------------------------------------------- |
| `401`  | Das Token fehlt oder ist ungültig; Client neu verbinden                                            |
| `403`  | Plan, Rolle oder freigegebene Scopes erlauben die angeforderte Aktion nicht                        |
| `405`  | MCP-Anfragen mit `POST` senden                                                                     |
| `429`  | Zu viele Anfragen; warten und erneut versuchen – siehe [Rate-Limits](/de/mcp/overview#rate-limits) |
