# API & MCP: Einen KI-Assistenten verbinden

_API · 7 Min. Lesezeit · Aktualisiert 2026-10-22 · https://lanachat.ai/guides/de/api-mcp/_

**API & MCP** (unter Users, ganz unten in der Seitenleiste) ermöglicht es Ihnen, einen KI-Assistenten wie Claude oder einen anderen MCP-Client zu verbinden, um Ihren Arbeitsbereich einzurichten und zu verwalten. MCP ist ein offener Standard, der einem Assistenten erlaubt, Werkzeuge in einer App in Ihrem Auftrag zu nutzen. Dieselben Zugriffstoken öffnen auch die [REST API](https://lanachat.ai/guides/de/api-overview/).

> Note: Nur der Arbeitsbereichsinhaber und Agenturinhaber können diese Seite öffnen. Alle anderen sehen „Owner access required“.

## Was Sie brauchen

- Den **MCP-Endpunkt**, der oben auf der Seite angezeigt wird. Drücken Sie **Copy URL**.
- Ein **Access Token**, das festlegt, was der Assistent darf.

## Erstellen eines Access Tokens

1. Drücken Sie **Create token**.
2. Geben Sie einen Namen ein und wählen Sie den Zugriff: **Workspace setup** oder **Custom permissions**, um die Berechtigungen einzeln anzuhaken (zum Beispiel „Read fans and conversations“ oder „Read sales“).
3. Speichern. Das Token wird einmal angezeigt: Drücken Sie **Copy token** oder **Copy client configuration**, um eine fertige Konfiguration für Ihren Assistenten zu erhalten.
4. Drücken Sie **Done, I saved it**.

## Verbinden Sie Ihren Assistenten

1. Erstellen Sie einen eigenen Zugriff für diesen Assistenten (ein Token pro verbundenem Tool).
2. Fügen Sie die HTTP-MCP-Verbindung in Ihrem Assistenten hinzu, mit Endpunkt und Token (genaue Schritte unten).
3. Fragen Sie ihn, was er sehen kann, um die Berechtigungen zu prüfen.
4. Arbeiten Sie mit Entwürfen: Lassen Sie ihn Änderungen vorbereiten, testen Sie sie und veröffentlichen Sie dann.

Die gleichen Schritte mit Endpunkt, Header und fertiger Konfiguration zum Kopieren finden Sie unten auf der API & MCP-Seite unter **Connect your assistant**. Ersetzen Sie in jedem Beispiel die URL durch die Ihres Arbeitsbereichs (**Copy URL**) und `YOUR_MCP_TOKEN` durch Ihr Token.

### Claude Code

Ein Befehl im Terminal:

```bash
claude mcp add --transport http lanachat https://app.lanachat.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"
```

Dann tippen Sie `/mcp` in Claude Code: `lanachat` wird als verbunden angezeigt, mit seinen Tools.

### Cursor

Fügen Sie dies in `~/.cursor/mcp.json` (für alle Projekte) oder `.cursor/mcp.json` (für ein Projekt) ein, und schalten Sie `lanachat` in **Settings › MCP** ein:

```json
{
  "mcpServers": {
    "lanachat": {
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### VS Code (GitHub Copilot)

Fügen Sie dies in `.vscode/mcp.json` in Ihrem Projekt ein:

```json
{
  "servers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### Claude Desktop

Claude Desktop startet lokale Server aus seiner Konfigurationsdatei, sodass es LanaChat über die kleine `mcp-remote`-Brücke (Node.js 18 oder höher) erreicht. Öffnen Sie **Settings › Developer › Edit Config** und fügen Sie hinzu:

```json
{
  "mcpServers": {
    "lanachat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lanachat.ai/mcp", "--header", "Authorization:${LANACHAT_AUTH}"],
      "env": { "LANACHAT_AUTH": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

Starten Sie Claude Desktop neu; LanaChats Tools erscheinen im Werkzeugmenü eines neuen Chats.

### ChatGPT und andere Assistenten

Jeder MCP-Client, der einen Header über eine HTTP-Verbindung senden kann, funktioniert mit der obigen Konfiguration. Web-Connectoren, die nur eine OAuth-Anmeldung anbieten (ChatGPT-Connectoren, benutzerdefinierte Connectoren auf claude.ai), können kein Access Token senden und können daher noch nicht verbunden werden.

### Verbindung prüfen

Der MCP Inspector listet die Tools auf, die Ihr Token öffnet, ohne einen Assistenten:

```bash
npx @modelcontextprotocol/inspector
```

Wählen Sie **Streamable HTTP**, fügen Sie den Endpunkt ein, fügen Sie den Header `Authorization: Bearer YOUR_MCP_TOKEN` hinzu, dann **Connect** und **List tools**.

## Tokens verwalten

Die Tabelle **Access tokens** zeigt die Berechtigungen, das Ablaufdatum und den Status jedes Tokens. Verwenden Sie **Edit**, **Rotate** (oder **Renew**) und **Revoke**. **Show revoked tokens** listet die alten Tokens.

> Warning: Ein Token funktioniert wie ein Passwort. Widerrufen Sie es sofort, wenn Sie den Assistenten nicht mehr nutzen oder einen Leak vermuten.

## Der MCP-Endpunkt

| Method | Path | Beschreibung | Berechtigung | Status |
|---|---|---|---|---|
| POST | `https://app.lanachat.ai/mcp` | Der MCP-Server (Streamable HTTP): jeder Tool-Aufruf geht hierhin | jedes Token | Planned |
| GET | `https://app.lanachat.ai/mcp` | Öffnet den Event-Stream der Sitzung | jedes Token | Planned |
| POST | `https://app.lanachat.ai/api/media/uploads` | Medien-Uploads von einem Assistenten, mit demselben Token | `can_setup` | Planned |

Die genaue URL Ihres Arbeitsbereichs wird oben auf der API & MCP-Seite angezeigt (**Copy URL**). Das Token kommt in den `Authorization`-Header, wie bei der API. Eine Client-Konfiguration sieht so aus:

```json
{
  "mcpServers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

## Tools, die der Assistent erhält

Der Assistent sieht nur die Tools, die sein Token erlaubt. Ein Tool, das er nicht nutzen darf, wird gar nicht angezeigt. Beim Verbinden sendet der Server dem Assistenten die genauen Argumente jedes Tools (Name, Typ, erforderlich), sodass Sie sie nie selbst eingeben müssen. Die letzte Spalte zeigt den API-Endpunkt, der dasselbe macht, mit dokumentierten Parametern.

| Tool | Was es macht | Berechtigung | Entspricht API |
|---|---|---|---|
| `list_creators`, `get_creator` | Liest Creatorinnen, deren Identität und Setup-Fortschritt | `can_setup` | [`GET /creators`](https://lanachat.ai/guides/de/api-creators/) |
| `update_creator`, `update_persona` | Ändert die Identität oder Persona-Seiten einer Creatorin | `can_setup`, `can_engine` für die Persona | [`PUT …/identity`, `PATCH …/persona`](https://lanachat.ai/guides/de/api-creators/) |
| `list_accounts`, `update_account` | Liest Telegram-Konten, ändert Brain, Market oder Traffic | `can_setup` | [`GET /accounts`, `PATCH /accounts/{id}`](https://lanachat.ai/guides/de/api-telegram-accounts/) |
| `list_media`, `upload_media`, `update_media`, `create_media_folder` | Fügt Medien zu einem Vault hinzu, sortiert sie, schlägt Beschreibungen vor (zur Überprüfung vor dem Speichern) | `can_setup` | [`/media`](https://lanachat.ai/guides/de/api-vault/) |
| `list_scripts`, `draft_script`, `update_script` | Liest Skripte und entwirft neue: Schritte, Medien und Stars-Preise | `can_setup` | [`/scripts`](https://lanachat.ai/guides/de/api-scripts/) |
| `list_members`, `update_member` | Liest und ändert Teammitglieder | `can_setup` | [`/members`](https://lanachat.ai/guides/de/api-team/) |
| `get_brain`, `update_brain_draft`, `test_brain` | Liest ein Brain, bearbeitet den Entwurf, testet es im Playground | `can_engine` | [`/brains`, `/playground`](https://lanachat.ai/guides/de/api-ai-brains/) |
| `publish_brain` | Veröffentlicht einen normalen Brain-Entwurf | `can_publish` | [`POST /brains/{id}/publish`](https://lanachat.ai/guides/de/api-ai-brains/) |
| `test_advanced_ai`, `tune_advanced_ai`, `publish_advanced_ai` | Fortgeschrittene KI-Entwürfe, Einstellungen und Profile (nur Arbeitsbereichsinhaber) | `can_ai_test`, `can_ai_tune`, `can_ai_publish` | Keine |
| `list_experiment_reports` | Liest kommerzielle Experimentberichte (nur Arbeitsbereichsinhaber) | `can_commercial_reports` | Keine |
| `list_fans`, `get_conversation` | Liest Fans und Gesprächsverlauf | `can_fan_read` | [`GET /fans`, `GET /conversations/{id}/messages`](https://lanachat.ai/guides/de/api-conversations/) |
| `import_fan_history` | Fügt vergangene Fans und Nachrichten zu den Aufzeichnungen hinzu; sendet niemals eine Nachricht | `can_fan_import` | [`POST /fans/import`](https://lanachat.ai/guides/de/api-conversations/) |
| `list_sales` | Liest aufgezeichnete Verkäufe für Berichte | `can_sales_read` | [`GET /fans/{id}/sales`](https://lanachat.ai/guides/de/api-conversations/), [`GET /stats`](https://lanachat.ai/guides/de/api-tracking/) |

> Note: Wenn Sie **Access AI configuration** ausschalten, werden auch die Berechtigungen für Publishing, Advanced AI und Experimentberichte entfernt. Workspace setup sowie die Fan- und Verkaufsberechtigungen bleiben unabhängig. Kein Tool sendet eine Nachricht an einen Fan.

## Was Sie fragen können

Sprechen Sie mit ihm wie mit einem Kollegen, der die Console kennt. Einige hilfreiche Eingaben:

- „List my creators and tell me which ones have an unfinished setup."
- „Read Lea's persona and suggest three phrase bank answers for fans who ask if she is real. Do not save anything."
- „Draft a win-back script for Lea: three steps over two days, the last one a paid set at 250 Stars. Leave it inactive."
- „Upload the photos in this folder to Lea's Vault, in a folder called Beach, and suggest a description for each."
- „Change the draft of Lea's brain so the first offer comes after 6 messages, test it in the Playground with a new English-speaking fan, and show me the replies before you publish."
- „How much did each creator sell yesterday, and which tracking link brought the most buyers this week?"

> Tip: Bitten Sie ihn, mit Entwürfen zu arbeiten und Ihnen das Ergebnis vor der Veröffentlichung zu zeigen. Veröffentlichen erfordert ein Token mit **Publish AI Brain drafts**: Lassen Sie es aus, wenn Sie das letzte Wort behalten wollen.

## Token-Endpunkte

Die oben genannte Seite ruft diese Routen auf; der [Team-Guide](https://lanachat.ai/guides/de/api-team/) listet dieselben Aktionen in der öffentlichen API (`/v1/tokens`).

| Method | Path | Beschreibung | Berechtigung | Status |
|---|---|---|---|---|
| GET | `/api/mcp/tokens` | Listet Tokens, deren Berechtigungen, Ablauf und Status | `owner` | Planned |
| POST | `/api/mcp/tokens` | Erstellt ein Token (einmal angezeigt) | `owner` | Planned |
| PUT | `/api/mcp/tokens/{id}` | Bearbeitet Name oder Berechtigungen | `owner` | Planned |
| POST | `/api/mcp/tokens/{id}/rotate` | Dreht das Geheimnis (Token) neu | `owner` | Planned |
| DELETE | `/api/mcp/tokens/{id}` | Widerruft es | `owner` | Planned |

Diese Console-Routen nehmen und geben die Berechtigungen als einzelne true- oder false-Felder zurück (`can_setup`, `can_engine`, `can_publish`, `can_ai_test`, `can_ai_tune`, `can_ai_publish`, `can_commercial_reports`, `can_fan_read`, `can_fan_import`, `can_sales_read`). Das Erstellen eines Tokens antwortet mit `{ "token": "…", "grant": { … } }`: `token` ist das Geheimnis, einmal angezeigt; `grant` ist der Zugriff mit `id`, `name`, `scope`, `enabled`, `created` und `expires` (Unix-Sekunden). Das Drehen widerruft den alten Zugriff und antwortet mit neuem `token` und `grant`. Ein fehlender Name antwortet mit `400`, eine unbekannte ID mit `404`, ein widerrufener Zugriff mit `409`.

Mehr auf der [API und MCP Feature-Seite](https://lanachat.ai/landing/features/api-and-mcp/).

## Verwandte Artikel

- [LanaChat API: Schnellstart, Authentifizierung und Fehler](https://lanachat.ai/guides/de/api-overview/)
- [API Schnellrezepte: kopieren, einfügen, ausführen](https://lanachat.ai/guides/de/api-recipes/)
- [Was ein AI Brain ist](https://lanachat.ai/guides/de/what-is-an-ai-brain/)