Как подключить Kaiten к AI-помощнику через MCP

Подключите Kaiten к AI-помощнику через MCP, чтобы работать с данными в чате.

Для подключения понадобится MCP-клиент с поддержкой Streamable HTTP и OAuth. Каждый пользователь подключается сам: добавляет сервер в свой AI-клиент, входит в Kaiten и подтверждает доступ.

Ниже — инструкции для Codex Desktop, Codex CLI, Claude Code и OpenCode.

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

Перед подключением администратор с правом управления MCP должен разрешить MCP-подключения для компании. Для этого откройте «Администрирование» → «MCP-подключения» и включите настройку «Разрешить MCP-подключения». Если раздел недоступен, обратитесь к владельцу компании или в поддержку.

Подключение в Codex Desktop

Подключение настраивается в приложении Codex Desktop. Команды в терминале для него не используются.

Шаг 1. Добавьте MCP-сервер

1. Откройте настройки, перейдите в раздел «Плагины» и выберите вкладку MCP.

2. Нажмите «Добавить» и выберите «Добавить сервер MCP».

Добавление MCP-сервера в настройках Codex Desktop
  1. В открывшемся окне укажите имя mcp-kaiten

  2. Выберите «Потоковая передача HTTP»

  3. Вставьте адрес https://mcp.kaiten.ru/mcp.

  4. Нажмите «Сохранить».

Имя, тип подключения и адрес MCP Kaiten

Имя нужно только для удобства в списке подключений. Во всех примерах этой инструкции используется mcp-kaiten.

  1. Оставьте поля Bearer-токена и заголовков пустыми: доступ будет выдан через OAuth.

  2. В списке серверов включите mcp-kaiten и нажмите «Аутентифицировать».

Переключатель и кнопка «Аутентифицировать» для запуска входа в Кайтен

Шаг 2. Войдите в Kaiten

После запуска аутентификации откроется страница входа Kaiten. Вход и подтверждение доступа проходят через OAuth: клиент получает разрешение работать от имени пользователя.

  1. Укажите почту своего аккаунта Kaiten и пройдите вход. Если на почту придет код, введите его. При корпоративном входе следуйте подсказкам на странице.

  2. При доступе к нескольким компаниям выберите ту, в которой администратор разрешил MCP-подключения.

Страница входа в Kaiten с полем для почты

Если вход в Kaiten уже выполнен, часть шагов может быть пропущена.

Шаг 3. Выберите права и завершите вход

На экране подтверждения доступа доступны два режима:

  • «Только чтение»: помощник сможет просматривать доступные пользователю данные.

  • «Чтение и изменения»: помощник также сможет создавать, изменять, удалять данные и выполнять другие действия в пределах прав в компании.

Выбор режима доступа на примере компании sandbox; у вас будет ваша компания
  1. Проверьте название приложения и выбранную компанию, затем выберите подходящий режим. Для начала достаточно «Только чтение».

  2. Нажмите «Разрешить доступ».

  3. После успешной аутентификации закройте вкладку браузера и вернитесь в Codex Desktop.

Сообщение Codex об успешной аутентификации

Шаг 4. Проверьте подключение

  1. Откройте новый чат и отправьте запрос:

Через MCP Kaiten покажи мои доступные пространства и доски в первом пространстве. Ничего не изменяй.

  1. Если клиент попросит разрешение на вызов инструмента, проверьте действие и подтвердите его.

Помощник запросит данные через MCP Kaiten и покажет результат.

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

Терминал — это приложение, в котором команды вводят текстом. Например, для этого подойдут PowerShell в Windows или Terminal в macOS. Через него можно подключить MCP Kaiten в Codex CLI или Claude Code. Команды ниже предназначены для уже установленных клиентов.

Сначала сервер добавляется командой в терминале. Затем уже в браузере проходят вход в Kaiten и подтверждение доступа. После входа работа с помощником продолжается в терминале.

Codex CLI

Шаг 1. Добавьте сервер

Откройте терминал и выполните команду:

codex mcp add mcp-kaiten --url https://mcp.kaiten.ru/mcp

Если при добавлении сервера вход еще не завершен, запустите его отдельно:

codex mcp login mcp-kaiten

Если сервер mcp-kaiten уже добавлен, повторно добавлять его не нужно. Перейдите к команде входа.

Шаг 2. Войдите в Kaiten и выберите права

  1. В открывшемся браузере укажите почту своего аккаунта Kaiten и пройдите вход. Если на почту придет код, введите его. При корпоративном входе следуйте подсказкам на странице.

  2. При доступе к нескольким компаниям выберите компанию, в которой администратор разрешил MCP-подключения.

  3. Проверьте название приложения и выбранную компанию на экране подтверждения доступа.

  4. Выберите режим: «Только чтение» для просмотра данных или «Чтение и изменения» для их изменения. Действия ограничены правами пользователя в компании. Для первого подключения достаточно «Только чтение».

  5. Нажмите «Разрешить доступ».

  6. После успешного входа закройте вкладку браузера и вернитесь в терминал.

Если вход в Kaiten уже выполнен, часть шагов может быть пропущена.

Шаг 3. Проверьте подключение

  1. Посмотрите список подключений:

codex mcp list

  1. Запустите новый сеанс Codex:

codex

  1. В запущенном Codex отправьте запрос:

Покажи список пространств Kaiten, к которым у меня есть доступ. Ничего не изменяй.

  1. Если клиент попросит разрешение на вызов инструмента, проверьте действие и подтвердите его.

Помощник запросит данные через MCP Kaiten и покажет результат.

Claude Code

Шаг 1. Добавьте сервер и запустите вход

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

claude mcp add --transport http --scope user mcp-kaiten https://mcp.kaiten.ru/mcp

  1. Запустите Claude Code:

claude

  1. Внутри запущенного Claude Code введите /mcp.

  2. Выберите mcp-kaiten и запустите Authenticate.

Откроется браузер для входа в Kaiten.

Если сервер mcp-kaiten уже добавлен, повторно добавлять его не нужно. Запустите Claude Code и перейдите к /mcp.

Шаг 2. Войдите в Kaiten и выберите права

  1. Укажите почту своего аккаунта Kaiten и пройдите вход. Если на почту придет код, введите его. При корпоративном входе следуйте подсказкам на странице.

  2. Выберите компанию, в которой администратор разрешил MCP-подключения.

  3. На экране Allow Claude Code to access Workspace? проверьте выбранную компанию.

  4. Выберите права приложения:

    • Read only — только чтение. Помощник сможет просматривать доступные пространства, доски, карточки и другие данные через инструменты MCP.

    • Read and modify — чтение и изменения. Помощник также сможет создавать, изменять, удалять и архивировать данные через доступные инструменты. Действия ограничены правами пользователя.

  5. Нажмите Allow access («Разрешить доступ»).

Для знакомства с MCP подойдет Read only. Для поручений с изменением данных — Read and modify.

Экран подтверждения доступа для Claude Code. Выбран режим Read only, sandbox — компания для примера

Если вход в Kaiten уже выполнен, часть шагов может быть пропущена. Приложение получит выбранные разрешения.

Шаг 3. Завершите вход и проверьте подключение

  1. Дождитесь сообщения Authentication successful в браузере.

Сообщение об успешном входе в браузере
  1. Закройте вкладку и вернитесь в терминал с Claude Code.

  2. В терминале появится сообщение: Authentication successful. Connected to mcp-kaiten. Подключение готово к работе.

Claude Code подтверждает подключение к mcp-kaiten
  1. Отправьте запрос в запущенном Claude Code:

Покажи список пространств Kaiten, к которым у меня есть доступ. Ничего не изменяй.

  1. Если клиент попросит разрешение на вызов инструмента, проверьте действие и подтвердите его.

Помощник запросит данные через MCP Kaiten и покажет результат.

О командах Codex для работы с MCP читайте в справке Codex.

OpenCode

Инструкция рассчитана на OpenCode V2. Подключение настраивается через терминал, а вход и выбор прав проходят в браузере.

Что понадобится

  • OpenCode V2 с официального сайта.

  • Настроенный провайдер модели — сервис, через который помощник получает ответы ИИ.

  • Аккаунт Kaiten и компания, в которой администратор разрешил MCP-подключения.

Шаг 1. Добавьте сервер и запустите вход

  1. Откройте терминал в папке проекта и проверьте версию:

    opencode --version

  1. Добавьте MCP-сервер Kaiten:

    opencode mcp add kaiten-prod --url https://mcp.kaiten.ru/mcp

Сервер сохранится в настройках этого проекта. Во всех командах ниже используется имя kaiten-prod.

  1. Запустите вход:

    opencode mcp auth kaiten-prod

Откроется браузер. Оставьте терминал работающим до завершения входа.

Если сервер kaiten-prod уже добавлен, перейдите сразу к команде входа. В запущенном OpenCode можно ввести /mcps, выбрать подключение и начать авторизацию.

API-токен, client_id и client_secret вводить не надо.

Шаг 2. Войдите в Kaiten и выберите права

  1. В открывшемся браузере войдите в свой аккаунт Kaiten.

  2. Если появится список организаций, укажите ту, с которой будете работать.

  3. На экране подтверждения доступа проверьте название приложения opencode и выбранную компанию.

  4. Выберите права:

  • «Только чтение» — помощник сможет просматривать то, к чему у вас есть доступ.

  • «Чтение и изменения» — он также может создавать, изменять и удалять данные в пределах ваших прав.

  1. Нажмите «Разрешить доступ». Чтобы отказаться от подключения, выберите «Запретить».

Адрес возврата обычно содержит 127.0.0.1 или localhost и номер порта. Это адрес на вашем компьютере, куда вы вернетесь после входа. Менять его вручную не надо.

Выбор прав для OpenCode. Демонстрационный экран с тестовой компанией

Шаг 3. Завершите вход и проверьте связь

  1. Дождитесь сообщения Authorization successful в браузере.

  2. Закройте вкладку и вернитесь в терминал.

  3. Посмотрите список подключений:

    opencode mcp list

У сервера kaiten-prod появится статус connected. Если снова запрашивается вход, выполните opencode mcp auth kaiten-prod.

Успешный вход в локальной проверке OpenCode. В этой инструкции сервер называется kaiten-prod

Шаг 4. Проверьте доступ к данным

  1. В той же папке проекта запустите OpenCode:

    opencode

  1. Отправьте запрос:

Через сервер kaiten-prod вызови инструмент kaiten_get_current_user. Покажи только имя и ID пользователя. Ничего не изменяй.

  1. Если клиент попросит разрешение на вызов инструмента, проверьте действие и подтвердите его.

  2. Найдите в ответе свое имя и ID пользователя.

  3. Для дополнительной проверки попросите прочитать знакомую вам тестовую карточку по ID. Сравните ответ с ее содержимым в Kaiten.

Сообщение в браузере подтверждает авторизацию. Для проверки работы MCP важен успешный вызов инструмента: одного текстового ответа модели недостаточно.

Если не получается подключиться

Появилось сообщение «Приложение временно недоступно»

Ошибка «Приложение временно недоступно» в OpenCode

Запустите вход командой opencode mcp auth kaiten-prod. Если ошибка повторяется, напишите в поддержку на support@kaiten.ru. Укажите время с часовым поясом, версию OpenCode и приложите скриншот. Если на странице есть request_id — идентификатор запроса, добавьте его в обращение.

Сервер не отображается в списке

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

Вход выполнен, но данные не загружаются

Проверьте выбранную компанию, разрешение MCP-подключений и свои права на нужную карточку.

Надо сменить аккаунт

Удалите сохраненные локальные данные входа для этого сервера и запустите авторизацию заново:

Bash
opencode mcp logout kaiten-prod opencode mcp auth kaiten-prod

Не отправляйте в поддержку полную ссылку возврата после входа, значения code и state, cookies или токены.

Если вы настраиваете подключение вручную

В папке проекта откройте или создайте файл opencode.jsonc. Для OpenCode V2 добавьте сервер внутрь блока mcp.servers. Сохраните остальные настройки, если они уже есть:

JSON
{ "$schema": "https://opencode.ai/config.json", "mcp": { "servers": { "kaiten-prod": { "type": "remote", "url": "https://mcp.kaiten.ru/mcp" } } } }

В OpenCode V1 имя сервера находится прямо внутри mcp, без блока servers:

JSON
{ "$schema": "https://opencode.ai/config.json", "mcp": { "kaiten-prod": { "type": "remote", "url": "https://mcp.kaiten.ru/mcp", "enabled": true } } }

После сохранения выполните opencode mcp auth kaiten-prod и проверьте доступ к данным по инструкции выше. При обновлении до V2 перенесите сервер в mcp.servers и уберите enabled.

Подробнее о настройках читайте в справке OpenCode по MCP.

Если не получается подключиться

Если подключение завершается отказом в доступе, например access_denied, проверьте, разрешил ли администратор MCP-подключения и та ли компания выбрана при входе.

Если после входа не загружаются данные, напишите в поддержку на support@kaiten.ru. Укажите клиент, время ошибки и текст сообщения. Мы обязательно поможем 💜

Полезные ссылки


Не нашли ответ на свой вопрос?

Создайте заявку — поможем разобраться

Создать заявку