MCP Client einrichten
Verbinden Sie den gehosteten Famulor-MCP-Server mit Ihrem KI-Client in wenigen Schritten. Nach der Einrichtung melden Sie sich im Browser mit Ihrem Famulor API-Schlüssel an — der Schlüssel gehört nicht in Konfigurationsdateien.MCP Server
Funktionen, Auth und Self-Hosting
API-Schlüssel
Für OAuth-Anmeldung erforderlich
Server-URL
Kanonischer Endpunkt:https://mcp.famulor.io/mcp
Sowohl https://mcp.famulor.io/ als auch https://mcp.famulor.io/mcp funktionieren — fügen Sie eine der URLs im Connector-Dialog Ihres Clients ein.
Schnellstart
- Server im Client hinzufügen (siehe ChatGPT, Claude oder weitere Clients).
- Bei Aufforderung OAuth-Anmeldung im Browser abschließen und Ihren Famulor API-Schlüssel einfügen.
- In natürlicher Sprache fragen, z. B. „Zeige meine letzten 10 Anrufe“ oder „Liste meine Assistenten“.
Die Authentifizierung nutzt MCP OAuth 2.1 (PKCE). Ihr API-Schlüssel wird nicht in einer Datenbank gespeichert — nur verschlüsselt im Access Token auf Ihrem Gerät. Tokens laufen nach 30 Tagen ab; der Client fordert Sie zur erneuten Anmeldung auf.
ChatGPT
Famulor ist in ChatGPT (Web) als eigene App verfügbar. Sie benötigen einen ChatGPT-Plan mit Apps/Connectors und aktivierten Entwicklermodus.Famulor-App hinzufügen
- ChatGPT → Einstellungen → Apps (oder Connectors).
- App erstellen / Neue App wählen.
- Ausfüllen:
| Feld | Wert |
|---|---|
| Name | Famulor |
| Beschreibung | Famulor Voice Agent (optional) |
| URL des MCP-Servers | https://mcp.famulor.io oder https://mcp.famulor.io/mcp |
| Authentifizierung | OAuth |
- Sicherheitshinweis bestätigen und Erstellen klicken.
- OAuth-Anmeldung abschließen und Ihren API-Schlüssel einfügen.

Famulor im Chat nutzen
- Neuen Chat starten und bei Bedarf Entwicklermodus aktivieren.
- Famulor im Tools-/Apps-Menü des Eingabefelds auswählen.
- Fragen zu Ihrem Konto stellen — z. B. „Was waren meine letzten Anrufe?“

Claude
Famulor funktioniert in Claude Desktop (eigener Connector) und Claude Code (CLI). Beide nutzen OAuth — melden Sie sich mit Ihrem API-Schlüssel an, wenn Sie dazu aufgefordert werden.Claude Desktop
- Claude → Einstellungen → Connectors öffnen.
- Benutzerdefinierten Connector hinzufügen wählen.
- Ausfüllen:
| Feld | Wert |
|---|---|
| Name | Famulor |
| URL | https://mcp.famulor.io/mcp |
- Hinzufügen klicken und OAuth-Anmeldung im Browser abschließen.

Famulor in Claude nutzen
- Neuen Chat starten und den Connector Famulor für die Konversation aktivieren.
- In natürlicher Sprache fragen — z. B. „Nutze Famulor und zeige mir meine letzten Anrufe“.

Claude Code
Weitere Clients
Global: Cursor Einstellungen → Tools & MCP → New MCP Server (öffnet~/.cursor/mcp.json)
Projekt: .cursor/mcp.json im Projektroot anlegen.
Windsurf
~/.codeium/windsurf/mcp_config.json
VS Code
.vscode/mcp.json
Cline
Cline-Erweiterung → MCP Servers → ConfigureContinue
~/.continue/config.yaml
Zed
~/.config/zed/settings.json
Beispiel-Prompts
- „Erstelle einen deutschen Vertriebsassistenten mit GPT-4.1-mini und der Stimme Susi“
- „Starte Kampagne #42 und füge diese 50 Leads hinzu“
- „Zeige alle Anrufe von heute, bei denen das Ziel nicht erreicht wurde“
- „Was waren meine letzten Anrufe?“
Self-Hosting
Eigenen Server statt des gehosteten betreiben: MCP Server — Self-Hosting.Fehlerbehebung
OAuth / Anmeldung schlägt fehl
- API-Schlüssel prüfen (ohne Leerzeichen).
- Erneut anmelden — Tokens laufen nach 30 Tagen ab.
- Bei ChatGPT: Entwicklermodus aktivieren und OAuth wählen (kein API-Key in Headern).
Server verbindet nicht
https://mcp.famulor.io/mcp(oderhttps://mcp.famulor.io/) verwenden.- Health-Check: https://mcp.famulor.io/health
- Client neu starten; bei Cursor: Einstellungen → MCP → Aktualisieren.
Tools erscheinen nicht
- OAuth-Anmeldung nach dem Hinzufügen des Servers abschließen.
- In ChatGPT: App Famulor für den aktuellen Chat auswählen.

