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

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

Обновлено:

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

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

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

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

Если ключ не сохранился, выпустите новый и отзовите старый. Вернуть показанную один раз строку нельзя.

Подключите Claude Code

В блоке Как подключиться возьмите карточку Claude Code: это одна команда, ключ в неё уже подставлен.

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

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

Подключите VS Code

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

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

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

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

Карточка Любой ИИ-агент — это готовый промпт. Скопируйте его и вставьте в чат агента, у которого есть доступ к файлам: Claude Code, Cursor, Copilot в режиме агента. Конфиг он пропишет сам и сам же проверит подключение.

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

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

Проверка

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

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

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

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

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

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

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

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

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

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

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

Что рядом