Zum Hauptinhalt springen

​
Famulor MCP Server

Steuern Sie Ihre Famulor-KI-Voice-Agents — Anrufe, Leads, Kampagnen, Wissensdatenbanken, Konversationen, WhatsApp, SIP-Trunks — direkt aus ChatGPT, Claude, Cursor, Windsurf, VS Code und jedem anderen MCP-kompatiblen Client. Famulor MCP Server

Client verbinden

Einrichtung für ChatGPT, Claude, Cursor u. a.

Gehosteter Server

mcp.famulor.io — ohne Installation

GitHub

Quellcode und Deployment

​
Übersicht

Der Famulor-MCP-Server stellt die gesamte Famulor-Plattform als 66 Tools bereit, die Ihr KI-Assistent aufrufen kann. Fragen Sie in natürlicher Sprache — das Modell wählt die passenden Tools. 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“
Neu bei MCP? Starten Sie mit MCP Client einrichten — Server-URL hinzufügen, dann per OAuth und API-Schlüssel im Browser anmelden.

​
Gehostete Endpunkte

EndpunktURL
MCP (kanonisch)https://mcp.famulor.io/mcp
Basis-URLhttps://mcp.famulor.io/ (ebenfalls gültig)
Healthhttps://mcp.famulor.io/health
OAuth-Metadatenhttps://mcp.famulor.io/.well-known/oauth-authorization-server
Sowohl https://mcp.famulor.io/ als auch https://mcp.famulor.io/mcp funktionieren in Connector-Dialogen.

​
Was Sie steuern können

BereichFunktionen
AssistentenVoice Agents anlegen, aktualisieren, löschen · Stimmen, Sprachen, LLM-/Multimodal-Modelle, TTS/STT · Webhooks für eingehende Anrufe und Gesprächsende
AnrufeOutbound-Anrufe · Anrufliste abrufen, Details, löschen
KampagnenKampagnen anlegen, Retry-Regeln, erlaubte Zeitfenster · starten, stoppen, löschen
LeadsLeads hinzufügen (inkl. Sekundärkontakte) · Status und Variablen · löschen
WissensdatenbankenAnlegen · Website-Dokumente · aktualisieren / löschen
TelefonnummernSuche nach Land und Vorwahl · kaufen · freigeben · SIP-Trunk CRUD
KonversationenChats listen, lesen, beantworten · KI pro Konversation ein/aus (Human Takeover)
WhatsAppSender und Templates · 24h-Fenster · Template- oder Freitext-Nachrichten
SMSVersand über gekaufte Nummern
Mid-Call-ToolsEigene HTTP-Integrationen während des Gesprächs
AI RepliesKontextbezogene Antworten für externe Chat-Plattformen

​
Authentifizierung

Der Server nutzt MCP OAuth 2.1 (RFC 8414 Metadaten, RFC 7591 Dynamic Client Registration, PKCE S256):
  1. Ihr MCP-Client öffnet einen Browser-Tab.
  2. Sie fügen Ihren Famulor API-Schlüssel ein.
  3. Der Client erhält ein Access Token; der Server verschlüsselt es mit AES-256-GCM.
Ihr API-Schlüssel landet in keiner Datenbank — nur im Token, den Ihr Client speichert. Tokens laufen nach 30 Tagen ab; der Client fordert zur erneuten Anmeldung auf.
API-Schlüssel nicht in mcp.json, geteilte Umgebungsvariablen oder Versionskontrolle legen. Anmeldung immer über OAuth im Client.

​
Unterstützte Clients

  • ChatGPT — eigene App mit OAuth (Anleitung)
  • Claude — Desktop-Connector und Claude Code CLI (Anleitung)
  • Cursor, Windsurf, VS Code, Cline, Continue, Zed
Schritt-für-Schritt: MCP Client.

​
Demo-Video

​
Self-Hosting

Der gehostete Server unter https://mcp.famulor.io ist sofort nutzbar. Eigene Instanz:

​
Deployment auf Vercel

git clone https://github.com/bekservice/Famulor-MCP.git
cd Famulor-MCP
vercel --prod
Umgebungsvariablen im Vercel-Projekt:
VariablePflichtWert
MCP_SECRETjaopenssl rand -hex 32 — verschlüsselt OAuth-Tokens
MCP_ISSUERempfohlenÖffentliche URL, z. B. https://mcp.example.com
Domain auf das Deployment zeigen. Details in DEPLOYMENT.md im Repository (inkl. stdio-Modus).

​
Lokale Entwicklung

npm install
echo "MCP_SECRET=$(openssl rand -hex 32)" > .env
npm run dev:http
# Server unter http://localhost:8787

curl http://localhost:8787/health
curl http://localhost:8787/.well-known/oauth-authorization-server

​
Über MCP

Das Model Context Protocol (MCP) verbindet KI-Assistenten sicher mit externen Tools und Daten. Der Famulor-MCP-Server mappt Plattform-APIs auf MCP-Tools — damit ChatGPT, Claude und andere Clients Ihre Voice Agents verwalten können, nach OAuth-Anmeldung mit Ihrem API-Schlüssel.

​
Ressourcen

​
Lizenz

MIT — Details im GitHub-Repository.
Passende Seiten: MCP Client, Famulor Skill.