Быстрый старт
Семь шагов от регистрации до первой задачи, которую видно в облаке, с готовыми командами и проверкой после каждого шага.
Этот путь проходят сверху вниз: от регистрации до первой задачи в облаке. Каждая команда и фраза копируется целиком, после каждого шага указано, что должно получиться. Если результат не совпал, дальше не идите: сначала откройте раздел «Если не работает» ниже.
Из чего состоит Actari
- Облако
- Фичи, доска, приёмка и команда: здесь живёт план и видно, что сделано.
- MCP-сервер actari-mcp
- Журнал задач на машине разработчика: агент ведёт его инструментами и синкает в облако.
- Скилл actari
- Учит агента протоколу журнала: с чего начать и как вести задачу до приёмки.
- Политика
- Правила задач, отчётов и приёмки; задаются в облаке и действуют для всего журнала.
Что понадобится
- Node.js 22.5 или новее: MCP-сервер использует встроенный
node:sqlite. Проверка:node --version. - Claude Code или другой агент, который умеет подключать MCP-серверы и скиллы.
- Папка репозитория, над которым агент будет работать.
Семь шагов
- 01
Зарегистрируйтесь и создайте пространство
Пространство — рабочее место команды в облаке: в нём фичи, задачи и журнал.
Что должно получиться: Вы вошли в облако и видите своё пространство.
- 02
Выпустите MCP-токен
На странице MCP-токенов выпустите токен с правом записи: токен «только чтение» для подключения не подходит. Он показывается один раз, скопируйте сразу.
Что должно получиться: Токен вида act_… скопирован, а в списке MCP-токенов у него право записи.
- 03
Поставьте плагин
В Claude Code достаточно двух команд: они ставят MCP-сервер и скилл. Для других агентов скилл ставится отдельной командой, а MCP-сервер добавляется в их конфиг.
claude plugin marketplace add https://github.com/actari/actari-mcpclaude plugin install actari@actariДругие агенты: сначала скилл, затем конфиг MCP-сервера в настройках агента.
npx skills add actari/actari-mcpКонфиг MCP{ "mcpServers": { "actari": { "command": "npx", "args": ["-y", "actari-mcp"] } } }Что должно получиться: Обе команды завершились без ошибок: плагин actari установлен в Claude Code.
- 04
Скажите агенту «подключи actari»
Агент вызовет connect с адресом облака и вашим токеном. Токен попадёт в историю чата с агентом; если нужно, отзовите его на странице MCP-токенов.
Скажите агентуПодключи actari: адрес https://actari.dev, токен act_…Что должно получиться: Агент сообщает, что подключился к облаку (вызов connect выполнен).
- 05
Зарегистрируйте проект
В папке репозитория попросите агента зарегистрировать проект. Пока проект не зарегистрирован, журнал не принимает задачи.
Скажите агентуЗарегистрируй этот проект в actariЧто должно получиться: Агент подтверждает, что проект зарегистрирован: теперь журнал принимает задачи.
- 06
Дайте первую задачу
Два пути. Из облака: создайте фичу, разбейте её на задачи, нажмите «В работу» у задачи и скажите агенту фразу ниже. Из терминала: опишите работу своими словами, агент заведёт задачу и будет вести её через журнал.
Из облакаВозьми задачу из inbox actariИз терминалаСделай X и веди через журнал actariЧто должно получиться: Агент подтверждает, что взял задачу или завёл её в журнале.
- 07
Увидьте задачу в облаке
Задача появится в разделе «Журнал» пространства, а если она пришла из фичи, ещё и на доске фичи. Отчёт и приёмка видны там же.
Что должно получиться: Задача видна в разделе «Журнал» пространства; отчёт и приёмка отображаются рядом с ней.
Если не работает
Журнал не принимает задачу
Проект не зарегистрирован. Скажите агенту в папке репозитория: «Зарегистрируй этот проект в actari».
В облаке пусто, хотя агент отчитался
Если у вас несколько пространств, укажите, какой проект в какое уезжает: попросите агента вызвать sync_scope.
MCP-сервер не стартует
Нужен Node.js 22.5 или новее: сервер использует встроенный node:sqlite. Проверьте node --version.
Подключение отклоняется
Токен «только чтение» для подключения не подходит. Выпустите токен с правом записи на странице MCP-токенов.
Остальные вопросы разобраны в разделе Неполадки и FAQ. Что делают подключённые инструменты, описано в справочнике MCP, а как устроен сам журнал — в разделе Журнал и статусы.