> ## Documentation Index
> Fetch the complete documentation index at: https://docs-legacy.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Client

> Famulor MCP mit ChatGPT, Claude, Cursor und anderen MCP-Clients verbinden

# MCP Client einrichten

Verbinde den gehosteten Famulor-MCP-Server mit deinem KI-Client in wenigen Schritten. Der vollständige Entwickler-Endpunkt unterstützt breite Plattform-Aktionen; das Endkundenprofil für ChatGPT und Claude ist auf Assistenten- und Verlauf-Lesezugriffe beschränkt.

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

Nach der Einrichtung meldest du dich im Browser bei Famulor an und bestätigst die angezeigten Berechtigungen. Für den gehosteten OAuth-Flow ist kein API-Schlüssel nötig.

<CardGroup cols={3}>
  <Card title="MCP Server" icon="plug" href="/de/mcp/server">
    Funktionen, Auth und Self-Hosting
  </Card>

  <Card title="Famulor öffnen" icon="arrow-up-right-from-square" href="https://app.famulor.io">
    Im Workspace anmelden
  </Card>

  <Card title="Claude & ChatGPT Connector" icon="comments" href="/de/automation/mcp-connector">
    Ausführliche Connector-Anleitung mit Screenshots
  </Card>
</CardGroup>

## Was der vollständige Entwickler-Endpunkt kann

<CardGroup cols={2}>
  <Card title="Assistenten erstellen & verfeinern" icon="robot" href="/de/ai-assistants/what-is-ai-assistant" color="#1FD5F9">
    Inbound und Outbound: System-Prompt, Stimme, Sprache, Modell und Anrufverhalten. Wissensdatenbanken
    (deine Dokumente) und Mid-Call-Tools (Live-API-Abfragen während eines Anrufs) anbinden.
  </Card>

  <Card title="Outbound-Kampagnen steuern" icon="bullhorn" href="/de/outbound-calls/campaigns" color="#1FD5F9">
    Kampagnen erstellen, Leads hinzufügen und verwalten sowie starten, pausieren oder fortsetzen.
  </Card>

  <Card title="Auswerten & verbessern" icon="magnifying-glass-chart" href="/de/outbound-calls/overview" color="#1FD5F9">
    Anrufe auflisten, vollständige Transkripte und Post-Call-Bewertungen lesen, dann Assistent oder
    Tools anpassen — ein kompletter Kreislauf aus Erstellen → Auswerten → Verbessern.
  </Card>

  <Card title="Account verwalten" icon="gear" href="/de/api-reference/introduction" color="#1FD5F9">
    Wissensdatenbanken & Dokumente, Telefonnummern & SIP-Trunks, WhatsApp-Sender & Templates,
    Konversationen, Ordner, Labels, API-Schlüssel und deine Blacklist.
  </Card>
</CardGroup>

Lese- und Schreibaktionen sind getrennte Tools. Der vollständige Endpunkt enthält Aktionen, die
Guthaben verbrauchen oder Daten löschen können; nutze ihn nur in einem vertrauenswürdigen
Entwickler-Client und prüfe jede Bestätigung. Integrations-Geheimnisse werden in Antworten maskiert.
Das Profil für Assistenten & Verlauf enthält keine solchen Aktionen.

## Server-URL

**Vollständiger Entwickler-Endpunkt:** `https://app.famulor.io/mcp`

**Profil für Assistenten & Verlauf:** `https://app.famulor.io/mcp?profile=assistant-history`

Für ChatGPT- und Claude-Verbindungen im Verzeichnis oder für Endkunden verwendest du das eingeschränkte Profil. Es bietet 11 nur lesende Tools für Assistenten-Konfiguration und Omnichannel-Verläufe aus Anrufen, Messaging und E-Mail. Den vollständigen Endpunkt nutzt du nur in Entwickler-Clients, wenn du bewusst den breiteren schreibfähigen Tool-Katalog brauchst.

## Voraussetzungen

* Ein **Famulor-Account** unter [app.famulor.io](https://app.famulor.io).
* 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](#chatgpt), [Claude](#claude) oder [weitere Clients](#weitere-clients)).
2. Bei Aufforderung im Browser bei Famulor anmelden und die angeforderten Berechtigungen bestätigen.
3. In natürlicher Sprache fragen, z. B. *„Zeige meine letzten 10 Anrufe“* oder *„Liste meine Assistenten“*.

<Note>
  Die Authentifizierung nutzt MCP OAuth 2.1 (PKCE). Der gehostete Flow verwendet deine normale Famulor-Anmeldung und fordert keinen API-Schlüssel an. Access Tokens laufen nach 30 Tagen ab; der Client fordert dich zur erneuten Anmeldung auf.
</Note>

## ChatGPT

Famulor ist in **ChatGPT** (Web) als **eigene App** verfügbar. Du benötigst einen ChatGPT-Plan mit Apps/Connectors und aktivierten **Entwicklermodus**.

<iframe src="https://www.tella.tv/video/vid_cmqjbbm1g03lj04jlgou5ee77/embed" title="Famulor mit ChatGPT verbinden" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px" }} allowFullScreen />

### Famulor-App hinzufügen

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

| Feld                    | Wert                                                   |
| ----------------------- | ------------------------------------------------------ |
| **Name**                | `Famulor`                                              |
| **Beschreibung**        | `Famulor-Assistenten und Verläufe prüfen` (optional)   |
| **URL des MCP-Servers** | `https://app.famulor.io/mcp?profile=assistant-history` |
| **Authentifizierung**   | **OAuth**                                              |

4. Sicherheitshinweis bestätigen und **Erstellen** klicken.
5. Bei Famulor anmelden und die angeforderten Leserechte bestätigen.

<img src="https://mintcdn.com/famulor/DoAMVVtY4WbMt5xY/images/mcp/chatgpt-add-app.png?fit=max&auto=format&n=DoAMVVtY4WbMt5xY&q=85&s=fe550d26bd2944dce44c8c36f71e2237" alt="Famulor als eigene MCP-App in ChatGPT mit OAuth hinzufügen" width="1024" height="574" data-path="images/mcp/chatgpt-add-app.png" />

### 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?“*

<img src="https://mintcdn.com/famulor/TTfv30PS71QZUUoa/images/mcp/chatgpt-famulor-calls.png?fit=max&auto=format&n=TTfv30PS71QZUUoa&q=85&s=8872b4506ceea923900487274b1bd641" alt="ChatGPT listet mit Famulor MCP die letzten Anrufe auf" width="3160" height="1786" data-path="images/mcp/chatgpt-famulor-calls.png" />

### Schritt-für-Schritt mit Screenshots

<Steps>
  <Step title="Einstellungen öffnen">
    Klicke in ChatGPT unten links auf deinen Namen, dann auf **Settings**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/chatgpt-1.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=e229ca3958de9d35e827fa9c1a62fe7f" alt="Einstellungen in ChatGPT öffnen" width="320" height="428" data-path="images/mcp/connector/chatgpt-1.png" />
    </Frame>
  </Step>

  <Step title="Apps → Advanced settings">
    Öffne den Tab **Apps** (Connectors liegen jetzt unter „Apps“), dann **Advanced settings**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/chatgpt-2.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=3b34075f4e31eb365a3f3d8e1d8753c0" alt="Apps und Advanced settings in ChatGPT öffnen" width="928" height="721" data-path="images/mcp/connector/chatgpt-2.png" />
    </Frame>
  </Step>

  <Step title="Developer mode aktivieren, dann App erstellen">
    Schalte **Developer mode** ein (damit kannst du einen Custom Connector hinzufügen), dann klicke
    oben auf **Create app**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/chatgpt-3.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=8b6cf64de0eacd4347fc1e23da410722" alt="Developer mode aktivieren und App in ChatGPT erstellen" width="945" height="716" data-path="images/mcp/connector/chatgpt-3.png" />
    </Frame>
  </Step>

  <Step title="Link einfügen und erstellen">
    Gib einen Namen ein, füge `https://app.famulor.io/mcp?profile=assistant-history` in **Server URL** ein, setze
    **Authentication** auf **OAuth**, aktiviere *„I understand and want to continue“*, dann
    **Create**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/chatgpt-4.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=0cad0ffad0411e14632dbde13822d708" alt="Famulor-MCP-URL in ChatGPT einfügen und App erstellen" width="470" height="811" data-path="images/mcp/connector/chatgpt-4.png" />
    </Frame>
  </Step>

  <Step title="Anmelden und bestätigen">
    Im Browser öffnet sich der Famulor-OAuth-Consent-Screen. Melde dich an, prüfe die Leserechte
    und klicke auf **Connect**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/oauth-consent.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=1f2d386553cd7c87dc5529597fad975a" alt="Famulor OAuth-Consent-Screen beim Verbinden mit ChatGPT" width="1024" height="914" data-path="images/mcp/connector/oauth-consent.png" />
    </Frame>
  </Step>
</Steps>

## Claude

Famulor funktioniert in **Claude Desktop** (eigener Connector) und **Claude Code** (CLI). Beide nutzen OAuth über deinen normalen Famulor-Account.

<iframe src="https://www.tella.tv/video/vid_cmqjb4jdz00so04jl8z5tgfq3/embed" title="Famulor mit Claude verbinden" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px" }} allowFullScreen />

### Claude Desktop

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

| Feld     | Wert                                                   |
| -------- | ------------------------------------------------------ |
| **Name** | `Famulor`                                              |
| **URL**  | `https://app.famulor.io/mcp?profile=assistant-history` |

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

<img src="https://mintcdn.com/famulor/NbBsxDBhViHPr77O/images/mcp/claude-add-connector.png?fit=max&auto=format&n=NbBsxDBhViHPr77O&q=85&s=540b057f395ac636ef72e6a30ac7f47b" alt="Famulor als benutzerdefinierten MCP-Connector in Claude Desktop hinzufügen" width="1024" height="653" data-path="images/mcp/claude-add-connector.png" />

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

<img src="https://mintcdn.com/famulor/NbBsxDBhViHPr77O/images/mcp/claude-famulor-calls.png?fit=max&auto=format&n=NbBsxDBhViHPr77O&q=85&s=fd6887a283a7140c102fed709feaf69d" alt="Claude listet mit Famulor MCP die letzten Anrufe in einer Tabelle auf" width="1024" height="657" data-path="images/mcp/claude-famulor-calls.png" />

### Schritt-für-Schritt mit Screenshots

<Steps>
  <Step title="Customize öffnen">
    Öffne in Claude die linke Seitenleiste und klicke auf **Customize**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/claude-1.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=bfcbd045238301453feb293d245d2b46" alt="Customize-Bereich in Claude öffnen" width="354" height="248" data-path="images/mcp/connector/claude-1.png" />
    </Frame>
  </Step>

  <Step title="Connectors öffnen">
    Klicke im Customize-Bereich auf **Connectors**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/claude-2.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=4179a60a72a5f9a9693e5548d23682d3" alt="Connectors im Claude-Customize-Bereich öffnen" width="288" height="269" data-path="images/mcp/connector/claude-2.png" />
    </Frame>
  </Step>

  <Step title="Custom Connector hinzufügen">
    Klicke oben rechts im Connectors-Bereich auf **+**, dann auf **Add custom connector**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/claude-3.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=55d3d6d008a881e40b6fac0c2f1a5dd7" alt="Custom Connector in Claude hinzufügen" width="654" height="455" data-path="images/mcp/connector/claude-3.png" />
    </Frame>
  </Step>

  <Step title="Benennen und Link einfügen">
    Gib einen Namen ein (z. B. *Famulor*), füge `https://app.famulor.io/mcp?profile=assistant-history` in **Remote MCP server URL**
    ein, lasse die OAuth-Felder leer und klicke auf **Add**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/claude-4.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=d93be2daeff503ca76c5d866de8b4f8f" alt="Famulor-MCP-URL in Claude einfügen" width="1132" height="1088" data-path="images/mcp/connector/claude-4.png" />
    </Frame>
  </Step>

  <Step title="Anmelden und bestätigen">
    Nach **Add** öffnet sich im Browser der Famulor-OAuth-Consent-Screen. Melde dich an, prüfe die
    Leserechte und klicke auf **Connect**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/oauth-consent.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=1f2d386553cd7c87dc5529597fad975a" alt="Famulor OAuth-Consent-Screen beim Verbinden mit Claude" width="1024" height="914" data-path="images/mcp/connector/oauth-consent.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Sobald der Connector in den Verzeichnissen von Claude und ChatGPT gelistet ist, kannst du ihn auch
  per Klick hinzufügen — suche unter Settings → Connectors nach **Famulor**, ohne die URL manuell
  einzufügen.
</Tip>

## CLI-Clients — Claude Code, Codex, Gemini CLI

Füge den vollständigen gehosteten Server in einem CLI-Agenten hinzu und melde dich bei Aufforderung im Browser bei Famulor an:

```bash theme={null}
# Claude Code
claude mcp add --transport http famulor https://app.famulor.io/mcp

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

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

<Tip>Lieber ein komplettes Onboarding statt einzelner Tools? Installiere den **Famulor Skill** (funktioniert mit Claude Code, Cursor, Codex, OpenClaw, Hermes u. v. m.): `npx skills add bekservice/Famulor-Skill` — siehe [Famulor Skill](/de/mcp/famulor-skill).</Tip>

## Weitere Clients

**Ein-Klick-Installation:** [Zu Cursor hinzufügen](cursor://anysphere.cursor-deeplink/mcp/install?name=famulor\&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBwLmZhbXVsb3IuaW8vbWNwIn0%3D) · [Zu VS Code hinzufügen](https://vscode.dev/redirect/mcp/install?name=famulor\&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.famulor.io%2Fmcp%22%7D)

**Global:** Cursor **Einstellungen → Tools & MCP → New MCP Server** (öffnet `~/.cursor/mcp.json`)

**Projekt:** `.cursor/mcp.json` im Projektroot anlegen.

```json theme={null}
{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}
```

Nach dem Speichern MCP in den Einstellungen aktualisieren. Bei Aufforderung im Browser bei Famulor anmelden.

### Windsurf

`~/.codeium/windsurf/mcp_config.json`

```json theme={null}
{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://app.famulor.io/mcp"
    }
  }
}
```

### VS Code

`.vscode/mcp.json`

```json theme={null}
{
  "servers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}
```

### Cline

**Cline-Erweiterung → MCP Servers → Configure**

```json theme={null}
{
  "mcpServers": {
    "famulor": {
      "url": "https://app.famulor.io/mcp"
    }
  }
}
```

### Continue

`~/.continue/config.yaml`

```yaml theme={null}
mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://app.famulor.io/mcp"
```

### Zed

`~/.config/zed/settings.json`

```json theme={null}
{
  "context_servers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://app.famulor.io/mcp"]
    }
  }
}
```

## Ausprobieren

Starte einen neuen Chat mit dem Profil für Assistenten & Verlauf und frag zum Beispiel:

<CardGroup cols={2}>
  <Card title="Assistenten" icon="robot" color="#1FD5F9">
    „Liste meine Assistenten auf und fasse ihre Konfiguration zusammen.“
  </Card>

  <Card title="Verbessern" icon="arrow-trend-up" color="#1FD5F9">
    „Lies meine letzten 5 Anrufe und sag mir, was mein Assistent falsch gemacht hat.“
  </Card>

  <Card title="Nachrichten" icon="messages" color="#1FD5F9">
    „Zeig die neuesten WhatsApp- und Instagram-Chats, die Aufmerksamkeit brauchen.“
  </Card>

  <Card title="E-Mail" icon="envelope" color="#1FD5F9">
    „Fasse den neuesten E-Mail-Verlauf mit diesem Kunden zusammen.“
  </Card>
</CardGroup>

Mit dem **vollständigen Entwickler-Endpunkt** in einem vertrauenswürdigen Entwickler-Client kannst du zusätzlich solche Prompts nutzen:

* *„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.1** mit gebrandetem Consent-Screen — der gehostete Flow benötigt keinen API-Schlüssel.
* **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](https://www.famulor.io/privacy).

## Self-Hosting

Eigenen Server statt des gehosteten betreiben: [MCP Server — Self-Hosting](/de/mcp/server#self-hosting).

## FAQ

<AccordionGroup>
  <Accordion title="Mit welchen KI-Apps funktioniert das?">
    Diese Seite behandelt **ChatGPT**, **Claude**, CLI-Agenten und weitere MCP-Clients wie Cursor oder
    VS Code. Für eine ausführliche Connector-Anleitung mit Screenshots siehe
    [Claude & ChatGPT Connector](/de/automation/mcp-connector).
  </Accordion>

  <Accordion title="Brauche ich einen API-Schlüssel?">
    Nein. Der gehostete MCP-Server nutzt deinen normalen Famulor-Account per OAuth. API-Schlüssel
    bleiben für Server-zu-Server-REST-Integrationen verfügbar, gehören aber nicht in diesen Connector-Flow.
  </Accordion>

  <Accordion title="Ist die Verbindung sicher?">
    Das Profil für Assistenten & Verlauf ist auf deinen authentifizierten Workspace beschränkt und
    enthält keine Schreib-, Kauf-, Sende-, Anruf-, Kampagnen-, Lösch-, Telefonie-, Einstellungs- oder
    Billing-Tools. Nutze den vollständigen Entwickler-Endpunkt nur mit aktivierten Bestätigungen.
  </Accordion>

  <Accordion title="Verbraucht das mein Guthaben?">
    Nein. Das Profil für Assistenten & Verlauf kann keine Anrufe tätigen, Nachrichten senden,
    Kampagnen starten, Nummern kaufen oder andere Guthaben-Aktionen ausführen. Der vollständige
    Entwickler-Endpunkt kann solche Aktionen enthalten.
  </Accordion>
</AccordionGroup>

## Fehlerbehebung

### OAuth / Anmeldung schlägt fehl

* Im Browser bei Famulor abmelden und die Connector-Autorisierung erneut starten.
* Erneut anmelden — Tokens laufen nach 30 Tagen ab.
* Bei ChatGPT: **Entwicklermodus** aktivieren und **OAuth** wählen.

### Server verbindet nicht

* Für ChatGPT/Claude `https://app.famulor.io/mcp?profile=assistant-history` verwenden; für Entwickler-Clients ist der vollständige Endpunkt `https://app.famulor.io/mcp` verfügbar.
* Health-Check: [https://app.famulor.io/health](https://app.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.

<Tip>
  Passende Seiten: [MCP Server](/de/mcp/server), [Claude & ChatGPT Connector](/de/automation/mcp-connector), [Famulor Skill](/de/mcp/famulor-skill).
</Tip>