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

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

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

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

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

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

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

## Семь шагов

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

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

Зарегистрироваться: https://actari.dev/sign-up

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

### Шаг 2. Выпустите MCP-токен

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

Выпустить токен: https://actari.dev/account/tokens

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

### Шаг 3. Поставьте плагин

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

```bash
claude plugin marketplace add https://github.com/actari/actari-mcp
```

```bash
claude plugin install actari@actari
```

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

```bash
npx skills add actari/actari-mcp
```

Конфиг MCP:

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

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

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

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

Скажите агенту:

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

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

### Шаг 5. Зарегистрируйте проект

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

Скажите агенту:

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

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

### Шаг 6. Дайте первую задачу

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

Из облака:

```
Возьми задачу из inbox actari
```

Из терминала:

```
Сделай X и веди через журнал actari
```

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

### Шаг 7. Увидьте задачу в облаке

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

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

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

- **Журнал не принимает задачу.** Проект не зарегистрирован. Скажите агенту в папке репозитория: «Зарегистрируй этот проект в actari».
- **В облаке пусто, хотя агент отчитался.** Если у вас несколько пространств, укажите, какой проект в какое уезжает: попросите агента вызвать sync_scope.
- **MCP-сервер не стартует.** Нужен Node.js 22.5 или новее: сервер использует встроенный node:sqlite. Проверьте node --version.
- **Подключение отклоняется.** Токен «только чтение» для подключения не подходит. Выпустите токен с правом записи на странице MCP-токенов.

Остальные вопросы разобраны в разделе [Неполадки и FAQ](/docs/faq). Что делают подключённые инструменты, описано в [справочнике MCP](/docs/reference/mcp-tools), а как устроен сам журнал — в разделе [Журнал и статусы](/docs/concepts/journal).