Установка actari-mcp и плагина

Агент работает с журналом через MCP-сервер actari-mcp и скиллы, которые ставятся двумя командами. Эта страница — справка по установке и подключению во всех вариантах. Если вы начинаете с нуля, пройдите сначала Быстрый старт: там то же самое по шагам, с проверкой после каждого.

Что ставитсяКопировать ссылку на раздел

• MCP-сервер actari-mcp — журнал на вашей машине. Агент вызывает его инструменты, а сервер отправляет записи в облако. Нужен Node.js 22.5 или новее: сервер использует встроенный node:sqlite, внешних зависимостей у него нет. Данные лежат в ~/.actari/journal.db, при первом запуске сервер создаёт каталог и базу сам.
• Скиллы — тексты, которые учат агента порядку работы. В пакете их два: actari (протокол журнала: с чего начать, статусы, где искать правила) и feature (ведение одной фичи от намерения до записи выпуска). Подробнее — на странице Скиллы цикла.

Claude CodeКопировать ссылку на раздел

Две команды ставят и сервер, и скиллы:

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

Скилл feature вызывается в Claude Code как actari:feature. После установки перезапустите сессию, чтобы агент увидел новые инструменты.

Другие агентыКопировать ссылку на раздел

Для агента, который умеет подключать MCP-серверы и скиллы (например, Cursor), скилл ставится отдельной командой, а сервер добавляется в конфиг MCP:

npx skills add actari/actari-mcp

{ "mcpServers": { "actari": { "command": "npx", "args": ["-y", "actari-mcp"] } } }

Отдельный скилл можно выбрать флагом: npx skills add actari/actari-mcp --skill feature.

Подключение к облакуКопировать ссылку на раздел

Журнал работает и без облака, но тогда фичи и доска остаются пустыми. Чтобы подключиться, выпустите токен на странице «MCP-токены» и скажите агенту:

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

Агент вызовет connect с токеном. Инструмент проверяет связь и сам записывает настройки рядом с базой, вручную ничего настраивать не нужно. При ошибке связи существующие настройки не меняются.

Про токены стоит знать:

• Токен личный: один токен покрывает все пространства, в которых вы состоите.
• Токены бывают двух видов: с правом записи и «только чтение». Для connect и sync нужен токен с правом записи, токен «только чтение» получит отказ 403 read-only token. Для агентов, которым нужно только читать журнал облака, есть отдельный пакет actari-reader с токеном «только чтение».
• Токен попадает в историю чата. Если он больше не нужен, отзовите его на той же странице.

Токен можно не передавать через connect, а положить в конфиг MCP переменными окружения:

{
  "mcpServers": {
    "actari": {
      "command": "npx",
      "args": ["-y", "actari-mcp"],
      "env": {
        "ACTARI_SYNC_URL": "https://actari.dev",
        "ACTARI_SYNC_TOKEN": "act_…"
      }
    }
  }
}

Для облака на своём сервере укажите его адрес: connect { url: "https://actari.example.com", token: "act_…" } или переменную ACTARI_CLOUD_URL. Подробности — на странице Self-host.

Несколько пространствКопировать ссылку на раздел

Если вы состоите в нескольких пространствах, журнал нужно разложить по ним. Вызов sync_scope {} показывает, что и куда уедет, а sync_scope { workspace: "acme", projects: ["acme-web"] } привязывает проекты к пространству по его slug. Пока проекты не привязаны, а пространств несколько, ничего не отправляется: приватность важнее удобства. С одним пространством привязка не нужна.

Чтобы отправлять один журнал в несколько облаков (например, рабочее и своё), добавьте вторую цель: connect { alias: "lab", token: "act_…" }. Недоступная цель не мешает остальным.

Как понять, что агент на связиКопировать ссылку на раздел

В подвале боковой панели облака есть строка статуса агентов:

• «Подключить агента» — ни один журнал ещё не отправлял записи в это пространство;
• «Агенты на связи» — недавно был синк, рядом видно число журналов и время последнего;
• «Агенты давно не выходили» — связь была, но давно.

Во вкладке «Агенты» настроек пространства перечислены подключённые журналы: автор, проекты и время последнего синка, а ниже — политики пространства, см. Политика проекта.

ОбновлениеКопировать ссылку на раздел

npx -y actari-mcp берёт актуальную версию пакета. После обновления перезапустите сессии агента: старые копии сервера не знают новых возможностей. Плагин Claude Code обновляется его собственными командами.

Если не получилосьКопировать ссылку на раздел

Журнал не принимает задачу, в облаке пусто, сервер не стартует или токен отклоняется — все эти случаи разобраны в разделе Неполадки и FAQ.