Подключение инструмента
Адрес воркспейса, токен, с которым входит инструмент, и что значит каждый отказ.
Адрес воркспейса
У каждого воркспейса свой адрес: https://<workspace>.kaiku.tech, где <workspace> — имя, которое компания выбрала при регистрации. Тот же адрес отдаёт и приложение в браузере, и API трекера, и API вики, и MCP-сервер: инструменту всегда дают этот один адрес и ничего больше.
Давайте инструменту голый адрес, без пути. /rest/api/2, /rest/agile/1.0 или /rest/api/content он допишет сам — так же, как для трекера, под который написан.
На адрес, за которым нет воркспейса, приходит 404 с объяснением — и никогда не чужой воркспейс. Увидели такой ответ — проверьте имя перед .kaiku.tech.
Как выпустить токен
Инструмент входит с персональным токеном доступа. Токен действует от вашего имени: видит ровно то, что видите вы, и может менять ровно то, что можете менять вы.
- Откройте Настройки из меню аккаунта и выберите вкладку Подключение по MCP. Она есть у всех, и, несмотря на название, выпущенный там токен годится и для API трекера и вики.
- В разделе 1. Создайте токен дайте токену название, по которому узнаете его потом (например, «Ноутбук CLI»).
- В поле Область оставьте Все проекты или выберите один проект, чтобы ограничить токен им.
- Нажмите Создать токен. Если у аккаунта включён второй фактор, попросят код.
- Сразу скопируйте токен. Он показывается один раз: мы храним только его отпечаток и показать его снова не можем.
Ниже, в списке Ваши токены, видно, где действует каждый токен и когда им пользовались в последний раз. Раскройте строку, чтобы включить Только чтение, поменять область или Отозвать этот токен — отозванный токен перестаёт работать сразу. Потеряли устройство? Выйти на всех остальных отзывает все токены и сессии, кроме той, в которой вы сейчас.
- Срока у токена нет: он действует, пока вы его не отзовёте.
- Токен работает только на адресе того воркспейса, в котором выпущен.
- Токен только на чтение читает всё, что позволяет его область, и может искать. Любой запрос, который что-то меняет, получает 403.
Как инструмент входит
Принимаются две формы, и обе ведут в один и тот же аккаунт:
| Заголовок | Что в нём |
|---|---|
Authorization: Bearer <token> | Токен. Лучший вариант. |
Authorization: Basic … | Ваша почта (или имя пользователя) и токен вместо пароля — так входят инструменты, написанные под облачную версию трекера. |
Basic с настоящим паролем тоже работает, но не у аккаунта со вторым фактором и не пока не сменён временный пароль, выданный администратором. Используйте токен.
Почта в заголовке Basic сравнивается ровно так, как записана в аккаунте, с учётом заглавных букв.
Что значит отказ
| Код | Что это |
|---|---|
| 401 | Токен неизвестен, отозван или выпущен в другом воркспейсе; или пароль использован там, где его не принимают. Где причина неочевидна, она названа в теле ответа. |
| 402 | Воркспейс только для чтения, потому что подписка кончилась. Чтение и экспорт работают — см. Оплата и режим чтения. |
| 403 | Вы вошли, но это вам нельзя: токен только на чтение, роль без права записи здесь или аккаунт не состоит в этом воркспейсе. |
| 404 | Не найдено — или не видно вам. Проект или страница, которые вам не видны, отвечают так, будто их нет. |
| 503 | Воркспейс переезжает на другой сервер. Чтение работает; запись повторите через интервал из Retry-After. |
Чего-то не хватает или всё не так, как здесь написано? Напишите на hello@kaiku.tech