К содержимому
Компо VIIIСправка
На главную
Вернуться к результатам

Подключение AI-клиента через MCP

Создайте персональный токен для чтения и изменения доступных вам досок.

Обновлено 26 октября 2026 г.

Токен создаётся в профиле пользователя досок и ограничен его правами.

Создайте подключение

Можно иметь до 20 действующих токенов. Токен чтения не меняет доски; токен записи также требует ваших прав редактирования конкретной доски. Учётная запись администратора не используется для MCP и не выдаёт ему административных полномочий.

  1. В меню профиля на главной или доске выберите «Подключить MCP». Убедитесь, что тариф включает MCP.
  2. Задайте понятное название клиента, права «Только чтение» или «Чтение и запись» и срок 30, 90 либо 365 дней.
  3. Создайте и скопируйте токен до закрытия окна: секрет показывается один раз. Скопируйте адрес MCP-сервера из того же окна.

Настройте HTTP-клиент

Клиент должен поддерживать Streamable HTTP, произвольный Bearer-заголовок и иметь сетевой доступ к серверу. Используйте адрес своего сервиса с путём /mcp. Пример ниже показывает параметры подключения; названия ключей в настройках конкретного клиента могут отличаться.

{
  "url": "https://your-service.example/mcp",
  "headers": {
    "Authorization": "Bearer <YOUR_PERSONAL_TOKEN>"
  }
}

Локальный stdio-адаптер

Если клиент запускает MCP-процессы, используйте Node.js и поставляемый с проектом scripts/mcp-stdio.mjs. Укажите абсолютный путь к адаптеру своей установки и переменные HOLST_MCP_URL и HOLST_MCP_TOKEN. Адаптер обращается к работающему серверу, поэтому не заменяет его запуск.

{
  "mcpServers": {
    "holst": {
      "command": "node",
      "args": ["<ABSOLUTE_APP_PATH>/scripts/mcp-stdio.mjs"],
      "env": {
        "HOLST_MCP_URL": "https://your-service.example/mcp",
        "HOLST_MCP_TOKEN": "<YOUR_PERSONAL_TOKEN>"
      }
    }
  }
}

Команды, ограничения и отзыв

Попросите клиент начать с ресурса holst://guide и инструмента item_types. Доступны поиск пространств и досок, чтение объектов, создание досок, изменение названия и фона, пакетные изменения до 100 объектов, удаление и небольшой JSON-экспорт. Загрузка новых файлов через MCP не предоставляется. Ссылочную доску сначала откройте в приложении.

Для изменения нужен уникальный operationId. После потери ответа повторяют те же аргументы с тем же идентификатором, чтобы не дублировать действие. Для списков используйте nextOffset; сервер ограничивает размер страниц и экспорта. При отказе проверьте срок токена, роль, тариф и соединение. Ненужный токен отзовите в окне MCP: обычный выход из браузера его не отзывает.

Читайте также