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.io/mcp — ohne Installation

GitHub

Quellcode und Deployment

Übersicht

Der vollständige Famulor-MCP-Endpunkt stellt Entwickler-Clients einen breiten Plattform-Toolkatalog bereit. Frag in natürlicher Sprache — das Modell wählt die passenden Tools. Alle Tools liefern strukturierte Ausgaben 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 und dann per OAuth bei Famulor anmelden.

Gehostete Endpunkte

Endpunkt	URL
MCP (kanonisch)	`https://app.famulor.io/mcp`
Assistenten & Verlauf (nur lesend)	`https://app.famulor.io/mcp?profile=assistant-history`
Basis-URL	`https://app.famulor.io/mcp`
Health	https://app.famulor.io/health
OAuth-Metadaten	`https://app.famulor.io/.well-known/oauth-authorization-server`

Für ChatGPT- und Claude-Verbindungen im Verzeichnis oder für Endkunden verwendest du die eingeschränkte Assistenten-&-Verlauf-URL. Den kanonischen Endpunkt nutzt du in Entwickler-Clients, die bewusst den vollständigen Katalog brauchen.

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	Anruf-, WhatsApp- & SMS-Kampagnen · Zeitfenster · get/list/create · starten, stoppen, löschen · Call→Text-Fallback
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 meldest dich bei deinem normalen Famulor-Account an und prüfst die angeforderten Berechtigungen.
Nach der Bestätigung erhält der Client ein begrenztes Access Token.

Der gehostete OAuth-Flow fordert keinen API-Schlüssel an. Das Profil für Assistenten & Verlauf verlangt nur assistants:read und calls:read.

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.io/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.io/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, nachdem du dich per OAuth mit deinem Famulor-Account angemeldet hast.

Ressourcen

Lizenz

Die aktuellen Bedingungen für das selbst gehostete Paket stehen in der Repository-Lizenz.

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