Zum Hauptinhalt springen

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

  1. Server im Client hinzufügen (siehe ChatGPT, Claude oder weitere Clients).
  2. Bei Aufforderung OAuth-Anmeldung im Browser abschließen und Ihren Famulor API-Schlüssel einfügen.
  3. 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

  1. ChatGPTEinstellungenApps (oder Connectors).
  2. App erstellen / Neue App wählen.
  3. Ausfüllen:
FeldWert
NameFamulor
BeschreibungFamulor Voice Agent (optional)
URL des MCP-Servershttps://mcp.famulor.io oder https://mcp.famulor.io/mcp
AuthentifizierungOAuth
  1. Sicherheitshinweis bestätigen und Erstellen klicken.
  2. OAuth-Anmeldung abschließen und Ihren API-Schlüssel einfügen.
Famulor als eigene MCP-App in ChatGPT mit OAuth hinzufügen

Famulor im Chat nutzen

  1. Neuen Chat starten und bei Bedarf Entwicklermodus aktivieren.
  2. Famulor im Tools-/Apps-Menü des Eingabefelds auswählen.
  3. Fragen zu Ihrem Konto stellen — z. B. „Was waren meine letzten Anrufe?“
ChatGPT listet mit Famulor MCP die letzten Anrufe auf

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

  1. ClaudeEinstellungenConnectors öffnen.
  2. Benutzerdefinierten Connector hinzufügen wählen.
  3. Ausfüllen:
FeldWert
NameFamulor
URLhttps://mcp.famulor.io/mcp
  1. Hinzufügen klicken und OAuth-Anmeldung im Browser abschließen.
Famulor als benutzerdefinierten MCP-Connector in Claude Desktop hinzufügen

Famulor in Claude nutzen

  1. Neuen Chat starten und den Connector Famulor für die Konversation aktivieren.
  2. In natürlicher Sprache fragen — z. B. „Nutze Famulor und zeige mir meine letzten Anrufe“.
Claude listet mit Famulor MCP die letzten Anrufe in einer Tabelle auf

Claude Code

claude mcp add --transport http famulor https://mcp.famulor.io/mcp
Server zuerst hinzufügen — bei Aufforderung mit Ihrem API-Schlüssel anmelden.

Weitere Clients

Global: Cursor Einstellungen → Tools & MCP → New MCP Server (öffnet ~/.cursor/mcp.json) Projekt: .cursor/mcp.json im Projektroot anlegen.
{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}
Nach dem Speichern MCP in den Einstellungen aktualisieren. Bei Aufforderung mit Ihrem API-Schlüssel anmelden.

Windsurf

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://mcp.famulor.io/mcp"
    }
  }
}

VS Code

.vscode/mcp.json
{
  "servers": {
    "famulor": {
      "type": "http",
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}

Cline

Cline-Erweiterung → MCP Servers → Configure
{
  "mcpServers": {
    "famulor": {
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}

Continue

~/.continue/config.yaml
mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://mcp.famulor.io/mcp"

Zed

~/.config/zed/settings.json
{
  "context_servers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.famulor.io/mcp"]
    }
  }
}

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 (oder https://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.
Passende Seiten: MCP Server, Famulor Skill.