> ## 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. # MCP-Endpunkt > Claude, ChatGPT oder einen anderen MCP-Client mit deinem Workspace verbinden Der **Model Context Protocol (MCP)**-Endpunkt lässt eine KI-Anwendung mit denselben Workspace-Ressourcen arbeiten, die du im Dashboard nutzt – 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. ## Clients verbinden 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. 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. Verwende den obigen Endpunkt mit OAuth. Für vertrauenswürdige Server-zu-Server-Integrationen kannst du stattdessen einen Workspace-API-Key als Bearer-Token senden. ### 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 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. 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. ## Authentifizierung und Zustimmung Kompatible Clients starten die OAuth-Anmeldung automatisch. Der Zustimmungsbildschirm zeigt die angeforderten Berechtigungen, bevor irgendetwas freigegeben wird. Freigaben lassen sich in deinen Kontoeinstellungen widerrufen. Für eine manuelle oder Server-zu-Server-Verbindung sendest du einen Workspace-API-Key: ```http theme={null} Authorization: Bearer fam_... ``` Verwende die engstmöglichen Scopes. Schreib-Scopes schließen den entsprechenden Lesezugriff mit ein. ## Sichtbare Tools auswählen Der Standard-Endpunkt zeigt alle Tools, die das Credential erlaubt. Für eine kleinere Tool-Liste wählst du 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. | 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. ### Ö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. ## Beispiel-Prompts Sobald ein Client verbunden ist, erreicht normale Sprache jedes Tool, für das er freigegeben ist: | Aufgabe | Frag zum Beispiel | | ----------------- | --------------------------------------------------------------------------------------------------------------------------- | | Assistenten | „Erstelle einen Support-Assistenten für außerhalb der Geschäftszeiten und führe vor dem Livegang ein Testgespräch mit ihm.“ | | Anrufe | „Zeig mir die nicht erfolgreichen Anrufe der letzten Woche, jeweils mit Transkript.“ | | Kampagnen | „Starte die Q3-Verlängerungskampagne und sag mir, wie viele Kontakte in der Warteschlange stehen.“ | | Messaging | „Entwirf eine WhatsApp-Vorlage, die einen Kunden bittet, seinen Termin zu bestätigen.“ | | Knowledge | „Füge unsere Rückerstattungsrichtlinien-Seite als Wissensquelle hinzu und sag mir, wie viele Seiten sie indexiert hat.“ | | Automatisierungen | „Baue eine Automatisierung, die 30 Minuten nach einem verpassten Anruf eine SMS zur Nachverfolgung schickt.“ | Ein gut funktionierender Client liest den aktuellen Zustand, bevor er ihn ändert, und lässt dich alles bestätigen, was sich schwer rückgängig machen lässt – einen ausgehenden Anruf, eine gesendete Nachricht, den Start einer Kampagne, einen Kauf. Verwende E.164-Telefonnummern in deinen Prompts, prüfe einen generierten System-Prompt, bevor du den Client bittest, ihn zu speichern, und halte einen Workflow pro Prompt, damit eine mehrstufige Anfrage nachvollziehbar bleibt. ## Länger laufende Aufgaben Website-Importe, Simulationen, History-Exporte und große Kampagnenvorbereitungen können als MCP-Tasks im Hintergrund 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 | 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.