MCP-серверы

Аккаунта ещё нет? Для подключения он не нужен. Дайте агенту главный адрес, без токена:

claude mcp add --transport http kaiku https://app.kaiku.tech/mcp

{
  "mcpServers": {
    "kaiku": { "type": "http", "url": "https://app.kaiku.tech/mcp" }
  }
}

И попросите вас зарегистрировать. В таком подключении у агента четыре инструмента и ничего больше, и он проведёт вас по шагам:

1. Расскажет, что такое Kaiku и сколько стоит, и покажет оферту и политику конфиденциальности. Спросит, согласны ли вы, — дальше он идёт только после вашего «да».
2. Спросит почту, имя и название компании и подберёт ей свободный адрес, например acme.kaiku.tech.
3. Мы пришлём на почту 6-значный код. Продиктуйте его агенту. Код живёт 15 минут, попыток пять.
4. Агент получит ваш аккаунт, компанию на пробном тарифе с первым проектом и MCP-токен к ней — он показывается один раз.
5. Агент запишет токен в свою MCP-конфигурацию и переподключится. Новое подключение — это вы, в своей компании, со всеми инструментами ниже.

Переподключаться нужно потому, что за первым подключением никого нет и стать вами оно не может. Пароля у аккаунта нет: в браузере входите через Google или Apple с тем же адресом или задайте пароль через Забыли пароль. Если вы не регистрировались через агента, а приветственное письмо пришло, отзовите токен в Настройки → Подключение по MCP.

Сервер отвечает на https://<workspace>.kaiku.tech/mcp (streamable HTTP) и принимает токен в заголовке Authorization: Bearer. Он встроен: ставить ничего не нужно.

Вкладка Подключение по MCP в Настройках показывает ваш точный адрес, выпускает токен (см. Подключение инструмента) и даёт строки для вставки — уже с токеном. Для Claude Code:

claude mcp add --transport http kaiku https://<workspace>.kaiku.tech/mcp \
  --header "Authorization: Bearer <token>"

Для клиента, который настраивается файлом, — Claude Desktop, Cursor и других:

{
  "mcpServers": {
    "kaiku": {
      "type": "http",
      "url": "https://<workspace>.kaiku.tech/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Grok подключается к Kaiku как свой коннектор (custom connector). Ничего ставить не нужно и токен копировать не нужно: вы один раз входите в Kaiku в окне, которое откроет Grok.

1. Откройте grok.com/connectors и нажмите New Connector, затем Custom.
2. Дайте ему имя — Kaiku — и адрес https://app.kaiku.tech/mcp.
3. Grok откроет вход в Kaiku. Войдите, выберите компанию, если их несколько, и разрешите подключение.
4. В чате включите коннектор Kaiku и спросите, например: «Что ждёт меня в Kaiku?» или «Создай задачу в проекте ABC: проверить сентябрьские счета».

В Grok Business и Enterprise коннектор сначала добавляет администратор команды в консоли xAI; после этого каждый участник входит в Kaiku сам. Grok работает с вашими правами в Kaiku — читает и меняет только то, что можно вам. Чтобы отключить, удалите коннектор в Grok.

Полный список, где у каждого инструмента помечено, читает он или пишет, — в разделе Доступные инструменты на той же вкладке. Коротко:

• Задачи: найти, прочитать, создать, изменить, перенести в другой проект, заполнить собственные столбцы проекта; комментарии; связи между задачами.
• Вопросы: задать человеку вопрос с вариантами ответа и прочитать ответ.
• Вики: найти, прочитать, создать, изменить и удалить страницу; комментарии; привязать страницу к задаче.
• Файлы: приложить к задаче или странице (через MCP — до 20 МБ), прочитать, удалить. Со своего диска, по пути, — через pm-files.
• Проекты: список, а ведущему проекта или администратору — его собственные столбцы и автоматические правила.
• Прогоны агентов: записать, во что агенту обошлась задача, — токены по видам и машинное время — и прочитать это.
• Секреты, приложенные к задаче или странице: список и раскрытие одного.

• Сервер действует с вашими правами, и токен, ограниченный одним проектом, ограничивает им каждый инструмент.
• Токен только на чтение может вызывать только читающие инструменты. Раскрытие секрета к ним не относится.
• Его поиск отвергает запрос, который не смог прочитать целиком, вместо того чтобы расширить его, — см. Поиск (JQL).
• Ответы и отказы у него на английском, на каком бы языке ни говорил воркспейс.

Сервер выше работает в Kaiku и поэтому не видит файлы на вашем диске. Ассистенту остаётся перепечатать файл в разговор: для скриншота это медленно, а прочитать обратно файл больше 512 КБ так нельзя. pm-files — небольшой сервер-спутник, который работает на вашем компьютере. Он прикладывает файлы к задачам и страницам вики по пути и сохраняет вложения в папку, и файл не проходит через разговор.

• attach_to_issue, attach_to_wiki_page — приложить файлы по пути, до 100 МБ каждый. Для страницы ответ даёт строку, которая показывает файл в тексте страницы.
• save_issue_attachment, save_wiki_attachment — сохранить вложение в папку, чтобы скопировать страницу вместе с картинками.
• readable_roots — какие папки ему доступны и с каким воркспейсом он говорит.

Как подключить

1. Установите Node.js 18 или новее, если его нет.
2. В Настройки → Подключение по MCP нажмите Создать токен, затем Копировать. Никуда его не вставляйте.
3. Откройте терминал в папке проекта и выполните строку для своего клиента. На той же вкладке, в блоке Файлы с этого компьютера, эти строки уже стоят с адресом вашего воркспейса.
4. Перезапустите клиент и попросите ассистента вызвать readable_roots.

# Claude Code
curl -fsSL https://<workspace>.kaiku.tech/api/mcp/local-files/install.sh | bash

# Claude Desktop
curl -fsSL https://<workspace>.kaiku.tech/api/mcp/local-files/install.sh | bash -s -- --client claude-desktop

# Cursor
curl -fsSL https://<workspace>.kaiku.tech/api/mcp/local-files/install.sh | bash -s -- --client cursor

Скрипт берёт токен из буфера обмена, проверяет его на вашем воркспейсе и только потом записывает в настройки клиента. Если проверка не прошла, ничего не записывается. Сам токен скрипт не печатает. Ассистенту он тоже не нужен: если ассистент просит токен, чтобы всё настроить, не давайте.

Собственный MCP-сервер Kaiku знает про pm-files. Попросите ассистента приложить файл с вашего компьютера: если pm-files не подключён, он покажет команду для вашего воркспейса (инструмент local_files_setup).

Какие папки ему доступны

pm-files читает файлы только из своих корней и сохраняет только в них. Именно это ограничение не даёт ему стать способом отправить любой файл с компьютера, поэтому по умолчанию корни узкие: папка, из которой вы запустили команду, временная папка системы (туда кладут файлы браузеры и программы для скриншотов) и, для Claude Code, его рабочая папка. Домашняя папка корнем по умолчанию не бывает никогда: запускайте команду из папки проекта, а не из ~.

Чтобы выбрать папки самому, перечислите их через двоеточие перед bash. Повторный запуск заменяет прежнюю настройку:

curl -fsSL https://<workspace>.kaiku.tech/api/mcp/local-files/install.sh | PM_FILES_ROOTS="$HOME/screenshots:$HOME/work" bash

Вручную и на Windows

Скрипт — для macOS и Linux. В остальных случаях скачайте сервер со своего воркспейса — https://<workspace>.kaiku.tech/api/mcp/local-files/server.mjs — и добавьте его в MCP-настройки клиента. Токен тогда вписывается прямо в файл настроек, который остаётся на вашем компьютере:

{
  "mcpServers": {
    "pm-files": {
      "command": "node",
      "args": ["C:\\Users\\you\\pm-files\\server.mjs"],
      "env": {
        "PM_API_URL": "https://<workspace>.kaiku.tech",
        "PM_TOKEN": "<токен>",
        "PM_FILES_ROOTS": "C:\\Users\\you\\work"
      }
    }
  }
}

На Windows несколько корней разделяются ;, а не :.

Распространённый открытый MCP-сервер для привычных трекера и вики работает с Kaiku без правок, обе половины — с одним токеном. Названия ниже принадлежат тому проекту и приведены только потому, что их нужно набрать как есть; Kaiku не связан ни с тем поставщиком, ни с тем проектом.

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

{
  "mcpServers": {
    "tracker": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
        "-e", "JIRA_URL", "-e", "JIRA_PERSONAL_TOKEN",
        "-e", "CONFLUENCE_URL", "-e", "CONFLUENCE_PERSONAL_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"],
      "env": {
        "JIRA_URL": "https://<workspace>.kaiku.tech",
        "JIRA_PERSONAL_TOKEN": "<token>",
        "CONFLUENCE_URL": "https://<workspace>.kaiku.tech",
        "CONFLUENCE_PERSONAL_TOKEN": "<token>"
      }
    }
  }
}

• Без Docker: uvx mcp-atlassian с теми же четырьмя настройками в окружении.
• Только для вики — уберите две настройки JIRA_.
• Если клиент настаивает на облачной раскладке вики, дайте ему адресом вики …kaiku.tech/wiki.
• Инструмента для создания проекта у того сервера нет; у собственного сервера Kaiku он есть — для администраторов.
• Что он может и чего не может через Kaiku, следует из страниц API трекера и API вики.