Kaiku

← Вся документация

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

Адрес воркспейса, токен, с которым входит инструмент, и что значит каждый отказ.

Адрес воркспейса

У каждого воркспейса свой адрес: https://<workspace>.kaiku.tech, где <workspace> — имя, которое компания выбрала при регистрации. Тот же адрес отдаёт и приложение в браузере, и API трекера, и API вики, и MCP-сервер: инструменту всегда дают этот один адрес и ничего больше.

Давайте инструменту голый адрес, без пути. /rest/api/2, /rest/agile/1.0 или /rest/api/content он допишет сам — так же, как для трекера, под который написан.

На адрес, за которым нет воркспейса, приходит 404 с объяснением — и никогда не чужой воркспейс. Увидели такой ответ — проверьте имя перед .kaiku.tech.

Как выпустить токен

Инструмент входит с персональным токеном доступа. Токен действует от вашего имени: видит ровно то, что видите вы, и может менять ровно то, что можете менять вы.

  1. Откройте Настройки из меню аккаунта и выберите вкладку Подключение по MCP. Она есть у всех, и, несмотря на название, выпущенный там токен годится и для API трекера и вики.
  2. В разделе 1. Создайте токен дайте токену название, по которому узнаете его потом (например, «Ноутбук CLI»).
  3. В поле Область оставьте Все проекты или выберите один проект, чтобы ограничить токен им.
  4. Нажмите Создать токен. Если у аккаунта включён второй фактор, попросят код.
  5. Сразу скопируйте токен. Он показывается один раз: мы храним только его отпечаток и показать его снова не можем.

Ниже, в списке Ваши токены, видно, где действует каждый токен и когда им пользовались в последний раз. Раскройте строку, чтобы включить Только чтение, поменять область или Отозвать этот токен — отозванный токен перестаёт работать сразу. Потеряли устройство? Выйти на всех остальных отзывает все токены и сессии, кроме той, в которой вы сейчас.

  • Срока у токена нет: он действует, пока вы его не отзовёте.
  • Токен работает только на адресе того воркспейса, в котором выпущен.
  • Токен только на чтение читает всё, что позволяет его область, и может искать. Любой запрос, который что-то меняет, получает 403.

Как инструмент входит

Принимаются две формы, и обе ведут в один и тот же аккаунт:

ЗаголовокЧто в нём
Authorization: Bearer <token>Токен. Лучший вариант.
Authorization: Basic …Ваша почта (или имя пользователя) и токен вместо пароля — так входят инструменты, написанные под облачную версию трекера.

Basic с настоящим паролем тоже работает, но не у аккаунта со вторым фактором и не пока не сменён временный пароль, выданный администратором. Используйте токен.

Почта в заголовке Basic сравнивается ровно так, как записана в аккаунте, с учётом заглавных букв.

Что значит отказ

КодЧто это
401Токен неизвестен, отозван или выпущен в другом воркспейсе; или пароль использован там, где его не принимают. Где причина неочевидна, она названа в теле ответа.
402Воркспейс только для чтения, потому что подписка кончилась. Чтение и экспорт работают — см. Оплата и режим чтения.
403Вы вошли, но это вам нельзя: токен только на чтение, роль без права записи здесь или аккаунт не состоит в этом воркспейсе.
404Не найдено — или не видно вам. Проект или страница, которые вам не видны, отвечают так, будто их нет.
503Воркспейс переезжает на другой сервер. Чтение работает; запись повторите через интервал из Retry-After.

Чего-то не хватает или всё не так, как здесь написано? Напишите на hello@kaiku.tech