Как подключить 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. Команды в терминале для него не используются.
1. Откройте настройки, перейдите в раздел «Плагины» и выберите вкладку MCP.
2. Нажмите «Добавить» и выберите «Добавить сервер MCP».

В открывшемся окне укажите имя
mcp-kaitenВыберите «Потоковая передача HTTP»
Вставьте адрес
https://mcp.kaiten.ru/mcp.Нажмите «Сохранить».

Имя нужно только для удобства в списке подключений. Во всех примерах этой инструкции используется mcp-kaiten.
Оставьте поля Bearer-токена и заголовков пустыми: доступ будет выдан через OAuth.
В списке серверов включите
mcp-kaitenи нажмите «Аутентифицировать».

После запуска аутентификации откроется страница входа Kaiten. Вход и подтверждение доступа проходят через OAuth: клиент получает разрешение работать от имени пользователя.
Укажите почту своего аккаунта Kaiten и пройдите вход. Если на почту придет код, введите его. При корпоративном входе следуйте подсказкам на странице.
При доступе к нескольким компаниям выберите ту, в которой администратор разрешил MCP-подключения.

Если вход в Kaiten уже выполнен, часть шагов может быть пропущена.
На экране подтверждения доступа доступны два режима:
«Только чтение»: помощник сможет просматривать доступные пользователю данные.
«Чтение и изменения»: помощник также сможет создавать, изменять, удалять данные и выполнять другие действия в пределах прав в компании.

Проверьте название приложения и выбранную компанию, затем выберите подходящий режим. Для начала достаточно «Только чтение».
Нажмите «Разрешить доступ».
После успешной аутентификации закройте вкладку браузера и вернитесь в Codex Desktop.

Откройте новый чат и отправьте запрос:
Через MCP Kaiten покажи мои доступные пространства и доски в первом пространстве. Ничего не изменяй.
Если клиент попросит разрешение на вызов инструмента, проверьте действие и подтвердите его.
Помощник запросит данные через MCP Kaiten и покажет результат.
Терминал — это приложение, в котором команды вводят текстом. Например, для этого подойдут PowerShell в Windows или Terminal в macOS. Через него можно подключить MCP Kaiten в Codex CLI или Claude Code. Команды ниже предназначены для уже установленных клиентов.
Сначала сервер добавляется командой в терминале. Затем уже в браузере проходят вход в Kaiten и подтверждение доступа. После входа работа с помощником продолжается в терминале.
Откройте терминал и выполните команду:
codex mcp add mcp-kaiten --url https://mcp.kaiten.ru/mcp
Если при добавлении сервера вход еще не завершен, запустите его отдельно:
codex mcp login mcp-kaiten
В открывшемся браузере укажите почту своего аккаунта Kaiten и пройдите вход. Если на почту придет код, введите его. При корпоративном входе следуйте подсказкам на странице.
При доступе к нескольким компаниям выберите компанию, в которой администратор разрешил MCP-подключения.
Проверьте название приложения и выбранную компанию на экране подтверждения доступа.
Выберите режим: «Только чтение» для просмотра данных или «Чтение и изменения» для их изменения. Действия ограничены правами пользователя в компании. Для первого подключения достаточно «Только чтение».
Нажмите «Разрешить доступ».
После успешного входа закройте вкладку браузера и вернитесь в терминал.
Если вход в Kaiten уже выполнен, часть шагов может быть пропущена.
Посмотрите список подключений:
codex mcp list
Запустите новый сеанс Codex:
codex
В запущенном Codex отправьте запрос:
Покажи список пространств Kaiten, к которым у меня есть доступ. Ничего не изменяй.
Если клиент попросит разрешение на вызов инструмента, проверьте действие и подтвердите его.
Помощник запросит данные через MCP Kaiten и покажет результат.
Откройте терминал и добавьте сервер для своего пользователя, чтобы он был доступен в разных проектах:
claude mcp add --transport http --scope user mcp-kaiten https://mcp.kaiten.ru/mcp
Запустите Claude Code:
claude
Внутри запущенного Claude Code введите
/mcp.Выберите
mcp-kaitenи запуститеAuthenticate.
Откроется браузер для входа в Kaiten.
Укажите почту своего аккаунта Kaiten и пройдите вход. Если на почту придет код, введите его. При корпоративном входе следуйте подсказкам на странице.
Выберите компанию, в которой администратор разрешил MCP-подключения.
На экране
Allow Claude Code to access Workspace?проверьте выбранную компанию.Выберите права приложения:
Read only— только чтение. Помощник сможет просматривать доступные пространства, доски, карточки и другие данные через инструменты MCP.Read and modify— чтение и изменения. Помощник также сможет создавать, изменять, удалять и архивировать данные через доступные инструменты. Действия ограничены правами пользователя.
Нажмите
Allow access(«Разрешить доступ»).
Для знакомства с MCP подойдет Read only. Для поручений с изменением данных — Read and modify.

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

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

Отправьте запрос в запущенном Claude Code:
Покажи список пространств Kaiten, к которым у меня есть доступ. Ничего не изменяй.
Если клиент попросит разрешение на вызов инструмента, проверьте действие и подтвердите его.
Помощник запросит данные через MCP Kaiten и покажет результат.
Инструкция рассчитана на OpenCode V2. Подключение настраивается через терминал, а вход и выбор прав проходят в браузере.
OpenCode V2 с официального сайта.
Настроенный провайдер модели — сервис, через который помощник получает ответы ИИ.
Аккаунт Kaiten и компания, в которой администратор разрешил MCP-подключения.
Откройте терминал в папке проекта и проверьте версию:
opencode --version
Добавьте MCP-сервер Kaiten:
opencode mcp add kaiten-prod --url https://mcp.kaiten.ru/mcp
Сервер сохранится в настройках этого проекта. Во всех командах ниже используется имя kaiten-prod.
Запустите вход:
opencode mcp auth kaiten-prod
Откроется браузер. Оставьте терминал работающим до завершения входа.
Если сервер
kaiten-prodуже добавлен, перейдите сразу к команде входа. В запущенном OpenCode можно ввести/mcps, выбрать подключение и начать авторизацию.
API-токен, client_id и client_secret вводить не надо.
В открывшемся браузере войдите в свой аккаунт Kaiten.
Если появится список организаций, укажите ту, с которой будете работать.
На экране подтверждения доступа проверьте название приложения
opencodeи выбранную компанию.Выберите права:
«Только чтение» — помощник сможет просматривать то, к чему у вас есть доступ.
«Чтение и изменения» — он также может создавать, изменять и удалять данные в пределах ваших прав.
Нажмите «Разрешить доступ». Чтобы отказаться от подключения, выберите «Запретить».
Адрес возврата обычно содержит 127.0.0.1 или localhost и номер порта. Это адрес на вашем компьютере, куда вы вернетесь после входа. Менять его вручную не надо.

Дождитесь сообщения
Authorization successfulв браузере.Закройте вкладку и вернитесь в терминал.
Посмотрите список подключений:
opencode mcp list
У сервера kaiten-prod появится статус connected. Если снова запрашивается вход, выполните opencode mcp auth kaiten-prod.

В той же папке проекта запустите OpenCode:
opencode
Отправьте запрос:
Через сервер kaiten-prod вызови инструмент kaiten_get_current_user. Покажи только имя и ID пользователя. Ничего не изменяй.
Если клиент попросит разрешение на вызов инструмента, проверьте действие и подтвердите его.
Найдите в ответе свое имя и ID пользователя.
Для дополнительной проверки попросите прочитать знакомую вам тестовую карточку по ID. Сравните ответ с ее содержимым в Kaiten.
Сообщение в браузере подтверждает авторизацию. Для проверки работы MCP важен успешный вызов инструмента: одного текстового ответа модели недостаточно.
Появилось сообщение «Приложение временно недоступно»

Запустите вход командой opencode mcp auth kaiten-prod. Если ошибка повторяется, напишите в поддержку на support@kaiten.ru. Укажите время с часовым поясом, версию OpenCode и приложите скриншот. Если на странице есть request_id — идентификатор запроса, добавьте его в обращение.
Сервер не отображается в списке
Проверьте, что терминал открыт в той же папке проекта, где вы добавили подключение. Если вы настраивали файл вручную, сверьте имя сервера в нем и в командах.
Вход выполнен, но данные не загружаются
Проверьте выбранную компанию, разрешение MCP-подключений и свои права на нужную карточку.
Надо сменить аккаунт
Удалите сохраненные локальные данные входа для этого сервера и запустите авторизацию заново:
opencode mcp logout kaiten-prod
opencode mcp auth kaiten-prodНе отправляйте в поддержку полную ссылку возврата после входа, значения
codeиstate, cookies или токены.
В папке проекта откройте или создайте файл opencode.jsonc. Для OpenCode V2 добавьте сервер внутрь блока mcp.servers. Сохраните остальные настройки, если они уже есть:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"kaiten-prod": {
"type": "remote",
"url": "https://mcp.kaiten.ru/mcp"
}
}
}
}В OpenCode V1 имя сервера находится прямо внутри mcp, без блока servers:
{
"$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.
Если подключение завершается отказом в доступе, например access_denied, проверьте, разрешил ли администратор MCP-подключения и та ли компания выбрана при входе.
Если после входа не загружаются данные, напишите в поддержку на support@kaiten.ru. Укажите клиент, время ошибки и текст сообщения. Мы обязательно поможем 💜
Не нашли ответ на свой вопрос?
Создайте заявку — поможем разобраться