Famulor MCP Server

Steuere deine 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.

Client verbinden

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

Gehosteter Server

app.famulor.de/mcp — ohne Installation

GitHub

Quellcode und Deployment

Übersicht

Der Famulor-MCP-Server stellt die gesamte Famulor-Plattform als 76 Tools bereit, die dein KI-Assistent aufrufen kann. Frag in natürlicher Sprache — das Modell wählt die passenden Tools. Alle Tools liefern strukturierte Ausgaben (Output-Schemas + structuredContent) und Title-Annotations für Directory-kompatible Clients. 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“
„Lege einen Ordner ‚Kunden‘ an und verschiebe alle Inbound-Assistenten hinein“

Mehr Inspiration: Use Cases & Prompts — gruppierte Anwendungsfälle mit fertigen Prompts und Best Practices.

Neu bei MCP? Starte mit MCP Client einrichten — Server-URL hinzufügen, dann per OAuth und API-Schlüssel im Browser anmelden.

Gehostete Endpunkte

Endpunkt	URL
MCP (kanonisch)	`https://app.famulor.de/mcp`
Basis-URL	`https://app.famulor.de/mcp`
Health	https://app.famulor.de/health
OAuth-Metadaten	`https://app.famulor.de/.well-known/oauth-authorization-server`

Verwende in Connector-Dialogen https://app.famulor.de/mcp.

Was du steuern kannst

Bereich	Funktionen
Assistenten	Voice Agents anlegen, aktualisieren, löschen · Stimmen, Sprachen, LLM-/Multimodal-Modelle, TTS/STT · Webhooks für eingehende Anrufe und Gesprächsende · per `folder_id` / `label_ids` organisieren
Ordner & Labels	Assistenten in Ordner organisieren (ein Ordner pro Assistent) · Labels mit Farben taggen (mehrere pro Assistent) · anlegen, umbenennen, löschen
Anrufe	Outbound-Anrufe · Anrufliste abrufen, Details, löschen
Kampagnen	Kampagnen anlegen, Retry-Regeln, erlaubte Zeitfenster · starten, stoppen, löschen
Leads	Leads hinzufügen (inkl. Sekundärkontakte) · Status und Variablen · löschen
Wissensdatenbanken	Anlegen · Website-Dokumente · aktualisieren / löschen
Telefonnummern	Suche nach Land und Vorwahl · kaufen · Nickname setzen (`update_phone_number`) · freigeben · SIP-Trunk CRUD
Konversationen	Chats listen, lesen, beantworten · KI pro Konversation ein/aus (Human Takeover)
WhatsApp	Sender und Templates · 24h-Fenster · Template- oder Freitext-Nachrichten
SMS	Versand über gekaufte Nummern
Mid-Call-Tools	Eigene HTTP-Integrationen während des Gesprächs
AI Replies	Kontextbezogene Antworten für externe Chat-Plattformen

Authentifizierung

Der Server nutzt MCP OAuth 2.1 (RFC 8414 Metadaten, RFC 7591 Dynamic Client Registration, PKCE S256):

Dein MCP-Client öffnet einen Browser-Tab.
Du fügst deinen Famulor API-Schlüssel ein.
Der Client erhält ein Access Token; der Server verschlüsselt es mit AES-256-GCM.

Dein API-Schlüssel landet in keiner Datenbank — nur im Token, den dein 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://app.famulor.de/mcp ist sofort nutzbar. Eigene Instanz:

Lokal via npm (stdio)

Der Server ist als npm-Paket famulor-mcp veröffentlicht. Starte ihn als lokalen stdio-MCP-Server — ohne Hosting, ohne OAuth:

npx -y famulor-mcp          # oder: npm i -g famulor-mcp && famulor-mcp

Verweise einen Client per stdio-Config darauf und übergib deinen API-Schlüssel als Umgebungsvariable:

{
  "mcpServers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "famulor-mcp"],
      "env": { "FAMULOR_API_KEY": "dein-api-key" }
    }
  }
}

Für die meisten Setups ist der gehostete Server (https://app.famulor.de/mcp mit OAuth-Anmeldung) einfacher — nutze das npm-Paket, wenn du einen lokalen, Offline- oder eingebetteten stdio-Server brauchst.

Deployment auf Vercel

git clone https://github.com/bekservice/Famulor-MCP.git
cd Famulor-MCP
vercel --prod

Umgebungsvariablen im Vercel-Projekt:

Variable	Pflicht	Wert
`MCP_SECRET`	ja	`openssl rand -hex 32` — verschlüsselt OAuth-Tokens
`MCP_ISSUER`	empfohlen	Ö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 deine Voice Agents verwalten können, nach OAuth-Anmeldung mit deinem API-Schlüssel.

Ressourcen

Lizenz

MIT — Details im GitHub-Repository.

Passende Seiten: Use Cases & Prompts, MCP Client, Famulor Skill.

​Famulor MCP Server

Client verbinden

Gehosteter Server

GitHub

​Übersicht

​Gehostete Endpunkte

​Was du steuern kannst

​Authentifizierung

​Unterstützte Clients

​Demo-Video

​Self-Hosting

​Lokal via npm (stdio)

​Deployment auf Vercel

​Lokale Entwicklung

​Über MCP

​Ressourcen

​Lizenz

Famulor MCP Server

Übersicht

Gehostete Endpunkte

Was du steuern kannst

Authentifizierung

Unterstützte Clients

Demo-Video

Self-Hosting

Lokal via npm (stdio)

Deployment auf Vercel

Lokale Entwicklung

Über MCP

Ressourcen

Lizenz