Skip to content
  1. Главная
  2. Справочный центр
  3. Аккаунт и оплата
  4. Подключение ИИ-клиента

Подключение ИИ-клиента

Обновлено:

KO отдаёт данные ваших проектов ИИ-ассистенту: он читает отчёты, инсайты, журналы и диагностику и отвечает на вопросы словами, не открывая интерфейс. Для этого нужен ключ — вы выпускаете его сами, и экран сразу кладёт его в готовый промпт для вашего агента.

Выпустите ключ

  1. В личных настройках откройте Подключение ИИ.
  2. Нажмите Добавить ключ…
  3. В поле Название уже стоит «Ключ от» и сегодняшняя дата. Лучше написать, где ключ будет жить: «ноутбук», «ассистент отдела». По имени вы потом поймёте, какой ключ отзывать.
  4. В поле Срок выберите 30 дней, 90 дней, Год или Бессрочно — так стоит, если ничего не менять.
  5. Не обязательно: в блоке Проекты отметьте те, которыми ключ ограничен. Ничего не отмечено — ключ увидит все проекты, куда пущены вы. Проектов много — ищите строкой Найти проект, Снять все сбрасывает отметки.
  6. Нажмите Выпустить.

Над списком появится плашка Ключ выпущен и уже вставлен в промпт с кнопкой Скопировать промпт. Отдельной строкой сам ключ не показывается — он уже внутри промпта и внутри готовых кусков в блоке Как подключиться.

Заберите его сразу: ключ показан один раз. В базе KO хранит только его отпечаток, и повторить показ невозможно. Если ключ не сохранился, выпустите новый и отзовите старый.

Подключите агента промптом

Это главный способ, и подходит он любому агенту, у которого есть доступ к файлам: Claude Code, Cursor, Copilot в режиме агента.

  1. Нажмите Скопировать промпт на плашке — или Скопировать на карточке Любой ИИ-агент, она первой стоит в блоке Как подключиться.
  2. Вставьте промпт в чат агента.

Конфиг агент пропишет сам и сам же проверит подключение.

Claude Desktop и claude.ai статический ключ не принимают: их коннектор умеет только вход по логину. Подключение входом мы делаем — пока этим двум клиентам ключ не поможет.

Настройте вручную: Claude Code

Ручные способы свёрнуты под промптом. Раскройте Настроить вручную: Claude Code, VS Code и возьмите карточку Claude Code: это одна команда, ключ в неё уже подставлен.

  1. Нажмите Скопировать.
  2. Вставьте строку в терминал и выполните.

Команда прописывает сервер на уровне пользователя, поэтому он встанет во все ваши проекты сразу, а не в тот каталог, где вы находитесь.

Настройте вручную: VS Code

Карточка VS Code стоит там же, под Настроить вручную: Claude Code, VS Code, и даёт файл .vscode/mcp.json. Ключ в него не подставлен намеренно: файл лежит в репозитории и уехал бы в git первым же коммитом, поэтому ключ спрашивает сам редактор и держит его в своём хранилище секретов.

  1. Нажмите Скопировать и положите файл в .vscode/mcp.json своего репозитория.
  2. Откройте файл и нажмите Start над блоком ko.
  3. Когда редактор спросит ключ, вставьте его. Сразу после выпуска ключ стоит на карточке под файлом, строкой «Ваш ключ — вставьте, когда редактор спросит», со своей кнопкой Скопировать. Это единственное место, где ключ виден отдельно от промпта.

Сервер нужен во всех проектах, а не в одном репозитории — выполните в палитре команд MCP: Open User Configuration и вставьте туда тот же блок servers.

Адрес сервера, если он понадобится руками, написан внизу блока Как подключиться строкой Адрес сервера.

Проверка

Попросите ассистента показать список ваших проектов — он вызовет инструмент ko_list_projects. Вернулся список проектов, а не отказ, — подключение работает.

Со стороны KO это видно в таблице Выпущенные ключи: в колонке Последний вызов вместо Ни разу встанет дата. Отметка пишется не чаще раза в минуту, поэтому обновите страницу через минуту, а не сразу.

Что ассистент сможет прочитать

Ключ открывает восемь инструментов, и все они только читают: список проектов, отчёт, инсайты, каталог метрик, описание отчёта и проекта, журнал и диагностику. Записи через API нет — ни ассистент, ни программа не изменят ни настройку, ни данные.

Ключ не добавляет прав, а только сужает их. Он ходит от вашего имени и видит ровно то, что видите в KO вы: проект, куда вас не пустили, через ключ не откроется. Колонка Что можно показывает, что ключу разрешено; в подсказке — полные ключи разрешений.

Отзовите ключ, когда он больше не нужен

В таблице Выпущенные ключи нажмите ··· в строке ключа:

  • Переименовать — если непонятно, чей это ключ и где он стоит.
  • Отозвать — ключ перестаёт работать сразу, и всё, что им подключено, перестаёт получать данные. Отзыв не отменяется: подключить обратно можно только новым ключом.

Отозванный или просроченный ключ из таблицы пропадает: по умолчанию в ней только живые. Чтобы увидеть остальные, откройте в панели блока фильтр Состояние и включите Отозван или Истёк — рядом с каждым состоянием стоит число ключей в нём. Живых ключей не осталось — экран покажет Живых ключей нет, а кнопка Показать все вернёт в таблицу все ключи сразу.

Если не сходится

  • Ассистент отвечает, что доступа нет. Ключа нет в таблице — значит, он уже не живой. Включите в фильтре Состояние отозванные и истёкшие: у ключа в колонке Состояние будет Отозван или Истёк, и работать он больше не будет — выпустите новый.
  • В конфиге оказалось YOUR_KO_API_KEY. Это не ключ, а место для него: так выглядят примеры, когда показывать ключ уже нельзя, — плашка над карточками об этом и говорит. Подставьте свой или выпустите новый.
  • Ассистент видит меньше проектов, чем вы ожидали. Ключ ограничен списком проектов — колонка Проекты показывает, сколько их, а подсказка — какие именно.
  • Инструментов KO у агента не появилось. Конфиг прописан, но сервер не запущен: в VS Code его запускает Start над блоком ko, в остальных клиентах — перезапуск сессии после правки конфига.
  • Claude Desktop или claude.ai не подключаются. Это не поломка: статический ключ они не принимают, и обойти это со стороны KO нельзя.

Что рядом