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 на 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"

Затем в Claude Code введите /mcp: 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. Несколько рабочих подсказок:

• «Покажи моих авторов и скажи, у кого незавершённая настройка.»
• «Прочитай персонажа Lea и предложи три ответа из фразы банка для фанатов, которые спрашивают, настоящая ли она. Ничего не сохраняй.»
• «Составь черновик скрипта возвращения для Lea: три шага за два дня, последний, платный набор за 250 Stars. Оставь его неактивным.»
• «Загрузи фото из этой папки в Vault Lea в папку Beach и предложи описание для каждого.»
• «Измени черновик brain Lea так, чтобы первое предложение появлялось после 6 сообщений, протестируй в Playground с новым англоговорящим фаном и покажи ответы перед публикацией.»
• «Сколько каждый автор продал вчера и какая ссылка отслеживания привела больше всего покупателей на этой неделе?»

Эндпоинты токенов #

Страница выше вызывает эти маршруты; руководство команды содержит те же действия в публичном API (/v1/tokens).

Эти маршруты Console принимают и возвращают права как отдельные поля true или false (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.