​

MCP Client einrichten

• „Erstelle einen Inbound-Empfang, der Termine bucht.“
• „Zeig mir, warum mein letzter Kampagnenanruf fehlgeschlagen ist.“
• „Füge drei Leads zu meiner Follow-up-Kampagne hinzu und starte sie.“

​

Was du damit machen kannst

​

Server-URL

​

Voraussetzungen

• Ein Famulor-Account unter app.famulor.de.
• Ein aktiver Tarif für die Features, die du nutzt (manche Aktionen verbrauchen Anrufminuten oder Chat-Credits).

​

Schnellstart

1. Server im Client hinzufügen (siehe ChatGPT, Claude oder weitere Clients).
2. Bei Aufforderung OAuth-Anmeldung im Browser abschließen und deinen Famulor API-Schlüssel einfügen.
3. In natürlicher Sprache fragen, z. B. „Zeige meine letzten 10 Anrufe“ oder „Liste meine Assistenten“.

​

ChatGPT

​

Famulor-App hinzufügen

1. ChatGPT → Einstellungen → Apps (oder Connectors).
2. App erstellen / Neue App wählen.
3. Ausfüllen:

4. Sicherheitshinweis bestätigen und Erstellen klicken.
5. OAuth-Anmeldung abschließen und deinen API-Schlüssel einfü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 deinem Konto stellen — z. B. „Was waren meine letzten Anrufe?“

​

Schritt-für-Schritt mit Screenshots

1

Einstellungen öffnen

Klicke in ChatGPT unten links auf deinen Namen, dann auf Settings.

2

Apps → Advanced settings

Öffne den Tab Apps (Connectors liegen jetzt unter „Apps“), dann Advanced settings.

3

Developer mode aktivieren, dann App erstellen

Schalte Developer mode ein (damit kannst du einen Custom Connector hinzufügen), dann klicke oben auf Create app.

4

Link einfügen und erstellen

Gib einen Namen ein, füge https://app.famulor.de/mcp in Server URL ein, setze Authentication auf OAuth, aktiviere „I understand and want to continue“, dann Create.

5

Anmelden und bestätigen

Im Browser öffnet sich der Famulor-OAuth-Consent-Screen. Prüfe die Berechtigungen, füge deinen API-Schlüssel ein und klicke auf Connect.

​

Claude

​

Claude Desktop

1. Claude → Einstellungen → Connectors öffnen.
2. Benutzerdefinierten Connector hinzufügen wählen.
3. Ausfüllen:

4. Hinzufügen klicken und OAuth-Anmeldung im Browser abschließen.

​

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“.

​

Schritt-für-Schritt mit Screenshots

1

Customize öffnen

Öffne in Claude die linke Seitenleiste und klicke auf Customize.

2

Connectors öffnen

Klicke im Customize-Bereich auf Connectors.

3

Custom Connector hinzufügen

Klicke oben rechts im Connectors-Bereich auf +, dann auf Add custom connector.

4

Benennen und Link einfügen

Gib einen Namen ein (z. B. Famulor), füge https://app.famulor.de/mcp in Remote MCP server URL ein, lasse die OAuth-Felder leer und klicke auf Add.

5

Anmelden und bestätigen

Nach Add öffnet sich im Browser der Famulor-OAuth-Consent-Screen. Prüfe die Berechtigungen, füge deinen API-Schlüssel ein und klicke auf Connect.

​

CLI-Clients — Claude Code, Codex, Gemini CLI

# Claude Code
claude mcp add --transport http famulor https://app.famulor.de/mcp

# OpenAI Codex
codex mcp add famulor --url https://app.famulor.de/mcp && codex mcp login famulor

# Gemini CLI
gemini mcp add --transport http famulor https://app.famulor.de/mcp

​

Weitere Clients

{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.de/mcp"
    }
  }
}

​

Windsurf

{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://app.famulor.de/mcp"
    }
  }
}

​

VS Code

{
  "servers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.de/mcp"
    }
  }
}

​

Cline

{
  "mcpServers": {
    "famulor": {
      "url": "https://app.famulor.de/mcp"
    }
  }
}

​

Continue

mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://app.famulor.de/mcp"

​

Zed

{
  "context_servers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://app.famulor.de/mcp"]
    }
  }
}

​

Ausprobieren

• „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?“

​

Sicherheit & Datenschutz

• OAuth 2.0 mit gebrandetem Consent-Screen — kein API-Schlüssel wird in Konfigurationsdateien gespeichert.
• Auf deinen Account beschränkt — der Connector kann nur deine eigenen Daten sehen und ändern.
• Geheimnisse maskiert — Auth-Tokens in deinen Tools werden nie im Klartext zurückgegeben.
• Kein Auslesen des Chat-Verlaufs — der Connector wirkt nur auf deine Famulor-Ressourcen.
• Datenschutzerklärung: famulor.io/privacy.

​

Self-Hosting

​

FAQ

​

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://app.famulor.de/mcp verwenden.
• Health-Check: https://app.famulor.de/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.