API & MCP: Einen KI-Assistenten verbinden
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.
Hinweis 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 #
- Drücken Sie Create token.
- 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“).
- 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.
- Drücken Sie Done, I saved it.
Verbinden Sie Ihren Assistenten #
- Erstellen Sie einen eigenen Zugriff für diesen Assistenten (ein Token pro verbundenem Tool).
- Fügen Sie die HTTP-MCP-Verbindung in Ihrem Assistenten hinzu, mit Endpunkt und Token (genaue Schritte unten).
- Fragen Sie ihn, was er sehen kann, um die Berechtigungen zu prüfen.
- 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:
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:
{
"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:
{
"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:
{
"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:
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.
Warnung 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:
{
"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 |
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 |
list_accounts, update_account | Liest Telegram-Konten, ändert Brain, Market oder Traffic | can_setup | GET /accounts, PATCH /accounts/{id} |
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 |
list_scripts, draft_script, update_script | Liest Skripte und entwirft neue: Schritte, Medien und Stars-Preise | can_setup | /scripts |
list_members, update_member | Liest und ändert Teammitglieder | can_setup | /members |
get_brain, update_brain_draft, test_brain | Liest ein Brain, bearbeitet den Entwurf, testet es im Playground | can_engine | /brains, /playground |
publish_brain | Veröffentlicht einen normalen Brain-Entwurf | can_publish | POST /brains/{id}/publish |
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 |
import_fan_history | Fügt vergangene Fans und Nachrichten zu den Aufzeichnungen hinzu; sendet niemals eine Nachricht | can_fan_import | POST /fans/import |
list_sales | Liest aufgezeichnete Verkäufe für Berichte | can_sales_read | GET /fans/{id}/sales, GET /stats |
Hinweis 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?"
Tipp 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 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.