LanaChat

API & MCP: Einen KI-Assistenten verbinden

7 Min. LesezeitAktualisiert Markdown

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.

API und MCP: die REST API, Webhooks und der MCP-Server für KI-Assistenten

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 #

  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.
Das neue Token-Panel mit Copy token und Copy client configuration

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:

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 #

MethodPathBeschreibungBerechtigungStatus
POSThttps://app.lanachat.ai/mcpDer MCP-Server (Streamable HTTP): jeder Tool-Aufruf geht hierhinjedes TokenPlanned
GEThttps://app.lanachat.ai/mcpÖffnet den Event-Stream der Sitzungjedes TokenPlanned
POSThttps://app.lanachat.ai/api/media/uploadsMedien-Uploads von einem Assistenten, mit demselben Tokencan_setupPlanned

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.

ToolWas es machtBerechtigungEntspricht API
list_creators, get_creatorLiest Creatorinnen, deren Identität und Setup-Fortschrittcan_setupGET /creators
update_creator, update_personaÄndert die Identität oder Persona-Seiten einer Creatorincan_setup, can_engine für die PersonaPUT …/identity, PATCH …/persona
list_accounts, update_accountLiest Telegram-Konten, ändert Brain, Market oder Trafficcan_setupGET /accounts, PATCH /accounts/{id}
list_media, upload_media, update_media, create_media_folderFü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_scriptLiest Skripte und entwirft neue: Schritte, Medien und Stars-Preisecan_setup/scripts
list_members, update_memberLiest und ändert Teammitgliedercan_setup/members
get_brain, update_brain_draft, test_brainLiest ein Brain, bearbeitet den Entwurf, testet es im Playgroundcan_engine/brains, /playground
publish_brainVeröffentlicht einen normalen Brain-Entwurfcan_publishPOST /brains/{id}/publish
test_advanced_ai, tune_advanced_ai, publish_advanced_aiFortgeschrittene KI-Entwürfe, Einstellungen und Profile (nur Arbeitsbereichsinhaber)can_ai_test, can_ai_tune, can_ai_publishKeine
list_experiment_reportsLiest kommerzielle Experimentberichte (nur Arbeitsbereichsinhaber)can_commercial_reportsKeine
list_fans, get_conversationLiest Fans und Gesprächsverlaufcan_fan_readGET /fans, GET /conversations/{id}/messages
import_fan_historyFügt vergangene Fans und Nachrichten zu den Aufzeichnungen hinzu; sendet niemals eine Nachrichtcan_fan_importPOST /fans/import
list_salesLiest aufgezeichnete Verkäufe für Berichtecan_sales_readGET /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).

MethodPathBeschreibungBerechtigungStatus
GET/api/mcp/tokensListet Tokens, deren Berechtigungen, Ablauf und StatusownerPlanned
POST/api/mcp/tokensErstellt ein Token (einmal angezeigt)ownerPlanned
PUT/api/mcp/tokens/{id}Bearbeitet Name oder BerechtigungenownerPlanned
POST/api/mcp/tokens/{id}/rotateDreht das Geheimnis (Token) neuownerPlanned
DELETE/api/mcp/tokens/{id}Widerruft esownerPlanned

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.

Die neuesten Nachrichten zu Lana auf Telegram

Neue Releases und Beta-Einladungen, zuerst im Kanal.