API та MCP: підключення AI-асистента

API та MCP (у розділі Users, внизу бокової панелі) дозволяють підключити AI-асистента, наприклад Claude або іншого клієнта MCP, щоб налаштувати та керувати вашим робочим простором. MCP, це відкритий стандарт, який дає асистенту змогу використовувати інструменти в додатку від вашого імені. Ті самі токени доступу відкривають REST API.

Що потрібно #

• MCP endpoint, показаний у верхній частині сторінки. Натисніть Copy URL.
• токен доступу, який визначає, що асистент може робити.

Створення токена доступу #

1. Натисніть Create token.
2. Дайте йому ім’я та оберіть доступ: Workspace setup або Custom permissions, щоб позначити їх по одному (наприклад, "Read fans and conversations" або "Read sales").
3. Збережіть. Токен показується один раз: натисніть Copy token або Copy client configuration, щоб отримати готову конфігурацію для вашого асистента.
4. Натисніть Done, I saved it.

Скріншот

Підключення асистента #

1. Створіть окремий доступ для цього асистента (по одному токену на кожен інструмент).
2. Додайте HTTP MCP-з’єднання в асистенті, вказавши endpoint і токен (точні кроки нижче).
3. Запитайте, що він бачить, щоб перевірити правильність дозволів.
4. Працюйте у чернетках: нехай готує зміни, тестує їх, а потім публікує.

Ті самі кроки з endpoint, заголовком і готовою до копіювання конфігурацією є в розділі Connect your assistant внизу сторінки API & MCP. У кожному прикладі нижче замініть URL на ваш робочий простір (Copy URL) і YOUR_MCP_TOKEN на ваш токен.

Claude Code #

Одна команда у вашому терміналі:

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

Потім введіть /mcp у Claude Code: lanachat відобразиться як підключений з його інструментами.

Cursor #

Додайте це у ~/.cursor/mcp.json (для всіх проєктів) або .cursor/mcp.json (для одного проєкту), потім увімкніть lanachat у Settings › MCP:

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

VS Code (GitHub Copilot) #

Додайте це у .vscode/mcp.json у вашому проєкті:

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

Claude Desktop #

Claude Desktop запускає локальні сервери з файлу конфігурації, тому він звертається до LanaChat через невеликий міст mcp-remote (Node.js 18 або новіший). Відкрийте Settings › Developer › Edit Config і додайте:

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

Перезапустіть Claude Desktop; інструменти LanaChat з’являться в меню інструментів нового чату.

ChatGPT та інші асистенти #

Будь-який клієнт MCP, що може надсилати заголовок у HTTP-з’єднанні, працює з наведеними вище налаштуваннями. Веб-коннектори, які пропонують лише OAuth-авторизацію (коннектори ChatGPT, кастомні коннектори на claude.ai), не можуть надіслати токен доступу, тому поки що не можуть підключитися.

Перевірка з’єднання #

MCP Inspector показує інструменти, які відкриває ваш токен, без асистента:

npx @modelcontextprotocol/inspector

Оберіть Streamable HTTP, вставте endpoint, додайте заголовок Authorization: Bearer YOUR_MCP_TOKEN, потім Connect і List tools.

Керування токенами #

Таблиця Access tokens показує дозволи, термін дії та статус кожного токена. Використовуйте Edit, Rotate (або Renew) та Revoke. Show revoked tokens показує старі токени.

MCP endpoint #

Точний URL вашого робочого простору показано у верхній частині сторінки API & MCP (Copy URL). Токен передається в заголовку Authorization, як і для API. Конфігурація клієнта виглядає так:

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

Інструменти, які отримує асистент #

Асистент бачить лише ті інструменти, які дозволяє його токен. Інструмент, який він не може використовувати, взагалі не відображається. Під час підключення сервер надсилає асистенту точні аргументи кожного інструмента (назва, тип, обов’язковість), тож вам не потрібно вводити їх вручну. Останній стовпець, це API endpoint, який робить те саме, де описані параметри.

Що запитувати у асистента #

Спілкуйтеся з ним як із колегою, який знає Console. Ось кілька ефективних запитів:

• "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?"

Точки доступу токенів #

Вищезазначена сторінка викликає ці маршрути; team guide містить ті самі дії у публічному API (/v1/tokens).

Ці маршрути Console приймають і повертають дозволи як окремі булеві поля (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). Створення токена повертає { "token": "…", "grant": { … } }: token, секрет, показується один раз; grant, доступ з його id, name, scope, enabled, created та expires (Unix-секунди). Ротація відкликає старий доступ і повертає новий token і grant. Відсутність імені повертає 400, невідомий id, 404, відкликаний доступ, 409.

Детальніше на сторінці функції API та MCP.