Skip to main content
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.
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.

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

Dieselben Kundenfunktionen stehen über die REST-API zur Verfügung. Wähle die Schnittstelle, die am besten zu deiner Integration passt.