Быстрый старт

Семь шагов от регистрации до первой задачи, которую видно в облаке, с готовыми командами и проверкой после каждого шага.

Этот путь проходят сверху вниз: от регистрации до первой задачи в облаке. Каждая команда и фраза копируется целиком, после каждого шага указано, что должно получиться. Если результат не совпал, дальше не идите: сначала откройте раздел «Если не работает» ниже.

Из чего состоит Actari

Облако
Фичи, доска, приёмка и команда: здесь живёт план и видно, что сделано.
MCP-сервер actari-mcp
Журнал задач на машине разработчика: агент ведёт его инструментами и синкает в облако.
Скилл actari
Учит агента протоколу журнала: с чего начать и как вести задачу до приёмки.
Политика
Правила задач, отчётов и приёмки; задаются в облаке и действуют для всего журнала.

Что понадобится

  • Node.js 22.5 или новее: MCP-сервер использует встроенный node:sqlite. Проверка: node --version.
  • Claude Code или другой агент, который умеет подключать MCP-серверы и скиллы.
  • Папка репозитория, над которым агент будет работать.

Семь шагов

  1. 01

    Зарегистрируйтесь и создайте пространство

    Пространство — рабочее место команды в облаке: в нём фичи, задачи и журнал.

    Что должно получиться: Вы вошли в облако и видите своё пространство.

  2. 02

    Выпустите MCP-токен

    На странице MCP-токенов выпустите токен с правом записи: токен «только чтение» для подключения не подходит. Он показывается один раз, скопируйте сразу.

    Что должно получиться: Токен вида act_… скопирован, а в списке MCP-токенов у него право записи.

  3. 03

    Поставьте плагин

    В Claude Code достаточно двух команд: они ставят MCP-сервер и скилл. Для других агентов скилл ставится отдельной командой, а MCP-сервер добавляется в их конфиг.

    claude plugin marketplace add https://github.com/actari/actari-mcp
    claude plugin install actari@actari

    Другие агенты: сначала скилл, затем конфиг MCP-сервера в настройках агента.

    npx skills add actari/actari-mcp
    Конфиг MCP
    { "mcpServers": { "actari": { "command": "npx", "args": ["-y", "actari-mcp"] } } }

    Что должно получиться: Обе команды завершились без ошибок: плагин actari установлен в Claude Code.

  4. 04

    Скажите агенту «подключи actari»

    Агент вызовет connect с адресом облака и вашим токеном. Токен попадёт в историю чата с агентом; если нужно, отзовите его на странице MCP-токенов.

    Скажите агенту
    Подключи actari: адрес https://actari.dev, токен act_…

    Что должно получиться: Агент сообщает, что подключился к облаку (вызов connect выполнен).

  5. 05

    Зарегистрируйте проект

    В папке репозитория попросите агента зарегистрировать проект. Пока проект не зарегистрирован, журнал не принимает задачи.

    Скажите агенту
    Зарегистрируй этот проект в actari

    Что должно получиться: Агент подтверждает, что проект зарегистрирован: теперь журнал принимает задачи.

  6. 06

    Дайте первую задачу

    Два пути. Из облака: создайте фичу, разбейте её на задачи, нажмите «В работу» у задачи и скажите агенту фразу ниже. Из терминала: опишите работу своими словами, агент заведёт задачу и будет вести её через журнал.

    Из облака
    Возьми задачу из inbox actari
    Из терминала
    Сделай X и веди через журнал actari

    Что должно получиться: Агент подтверждает, что взял задачу или завёл её в журнале.

  7. 07

    Увидьте задачу в облаке

    Задача появится в разделе «Журнал» пространства, а если она пришла из фичи, ещё и на доске фичи. Отчёт и приёмка видны там же.

    Что должно получиться: Задача видна в разделе «Журнал» пространства; отчёт и приёмка отображаются рядом с ней.

Если не работает

  • Журнал не принимает задачу

    Проект не зарегистрирован. Скажите агенту в папке репозитория: «Зарегистрируй этот проект в actari».

  • В облаке пусто, хотя агент отчитался

    Если у вас несколько пространств, укажите, какой проект в какое уезжает: попросите агента вызвать sync_scope.

  • MCP-сервер не стартует

    Нужен Node.js 22.5 или новее: сервер использует встроенный node:sqlite. Проверьте node --version.

  • Подключение отклоняется

    Токен «только чтение» для подключения не подходит. Выпустите токен с правом записи на странице MCP-токенов.

Остальные вопросы разобраны в разделе Неполадки и FAQ. Что делают подключённые инструменты, описано в справочнике MCP, а как устроен сам журнал — в разделе Журнал и статусы.

На этой странице

Для агентов: текстовая версия · llms.txt