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

# MCP Server

> Famulor Model Context Protocol Server — Voice Agents, Anrufe, Kampagnen und mehr aus jedem MCP-Client steuern

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

<img src="https://mintcdn.com/famulor/okk2swZ06pjxl-p5/images/provisioning/sip-ai/famulor-mcp-server.png?fit=max&auto=format&n=okk2swZ06pjxl-p5&q=85&s=5a17b0beaacc6a5022fcabee921b3703" alt="Famulor MCP Server" width="1024" height="535" data-path="images/provisioning/sip-ai/famulor-mcp-server.png" />

<CardGroup cols={3}>
  <Card title="Client verbinden" icon="desktop" href="/de/mcp/client">
    Einrichtung für ChatGPT, Claude, Cursor u. a.
  </Card>

  <Card title="Gehosteter Server" icon="globe" href="https://app.famulor.de/mcp">
    app.famulor.de/mcp — ohne Installation
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/bekservice/Famulor-MCP">
    Quellcode und Deployment
  </Card>
</CardGroup>

## Ü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](/de/mcp/use-cases) — gruppierte Anwendungsfälle mit fertigen Prompts und Best Practices.

<Note>
  Neu bei MCP? Starte mit [MCP Client einrichten](/de/mcp/client) — Server-URL hinzufügen, dann per OAuth und API-Schlüssel im Browser anmelden.
</Note>

## Gehostete Endpunkte

| Endpunkt            | URL                                                             |
| ------------------- | --------------------------------------------------------------- |
| **MCP (kanonisch)** | `https://app.famulor.de/mcp`                                    |
| **Basis-URL**       | `https://app.famulor.de/mcp`                                    |
| **Health**          | [https://app.famulor.de/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):

1. Dein MCP-Client öffnet einen Browser-Tab.
2. Du fügst deinen [Famulor API-Schlüssel](https://app.famulor.de/api-keys) ein.
3. 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.

<Warning>
  API-Schlüssel nicht in `mcp.json`, geteilte Umgebungsvariablen oder Versionskontrolle legen. Anmeldung immer über OAuth im Client.
</Warning>

## Unterstützte Clients

* **ChatGPT** — eigene App mit OAuth ([Anleitung](/de/mcp/client#chatgpt))
* **Claude** — Desktop-Connector und Claude Code CLI ([Anleitung](/de/mcp/client#claude))
* **Cursor**, **Windsurf**, **VS Code**, **Cline**, **Continue**, **Zed**

Schritt-für-Schritt: [MCP Client](/de/mcp/client).

## Demo-Video

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/OMQeTiBNW3Q" title="Famulor MCP Server Demo" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## 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`](https://www.npmjs.com/package/famulor-mcp) veröffentlicht. Starte ihn als lokalen **stdio**-MCP-Server — ohne Hosting, ohne OAuth:

```bash theme={null}
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](https://app.famulor.de/api-keys) als Umgebungsvariable:

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

<Note>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.</Note>

### Deployment auf Vercel

```bash theme={null}
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](https://github.com/bekservice/Famulor-MCP/blob/main/DEPLOYMENT.md) im Repository (inkl. stdio-Modus).

### Lokale Entwicklung

```bash theme={null}
npm install
echo "MCP_SECRET=$(openssl rand -hex 32)" > .env
npm run dev:http
# Server unter http://localhost:8787
```

```bash theme={null}
curl http://localhost:8787/health
curl http://localhost:8787/.well-known/oauth-authorization-server
```

## Über MCP

Das [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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

* [Use Cases & Prompts](/de/mcp/use-cases)
* [MCP Client einrichten](/de/mcp/client)
* [Famulor API-Referenz](/de/api-reference/)
* [API-Schlüssel erstellen](https://app.famulor.de/api-keys)
* [GitHub — Famulor-MCP](https://github.com/bekservice/Famulor-MCP)
* [Famulor Plattform](https://app.famulor.de)

## Lizenz

[MIT](https://github.com/bekservice/Famulor-MCP/blob/main/LICENSE) — Details im GitHub-Repository.

<Tip>
  Passende Seiten: [Use Cases & Prompts](/de/mcp/use-cases), [MCP Client](/de/mcp/client), [Famulor Skill](/de/mcp/famulor-skill).
</Tip>