# Работа с инструментом (/ru/docs/notion/usage)

Здесь объясняется, как устроена команда и как агент работает с инструментом. Прочитайте это перед первой командой.

## Сначала профиль [#сначала-профиль]

Профилем называется имя, которое вы выбираете для одного аккаунта. Оно стоит первым словом в каждой команде, которой
нужен аккаунт:

```sh
notion personal config show
```

`WCNOTION_PROFILE=personal` делает то же самое для одного сеанса оболочки. Профиль никогда не подставляется сам, даже
если он единственный: команда без профиля останавливается с кодом выхода 2 и показывает профили на этом компьютере.

## Вывод для скриптов [#вывод-для-скриптов]

Каждая команда, кроме `mcp serve` на stdin и stdout, принимает `--json` и печатает одно значение JSON в stdout.
Ошибки выводятся в stderr тоже в JSON, с кодом, по которому можно ветвиться. [Справочник команд](/llms.mdx/docs/ru/notion/commands/content.md)
перечисляет коды.

## Агенты [#агенты]

`notion skill install` кладет навык инструмента туда, где его ищут Claude Code, Codex, Gemini CLI и OpenClaw.
`notion skill install --for hermes` еще и добавляет эту папку в собственные настройки Hermes Agent, так что простой
`skill install` обходится без Hermes. `notion personal mcp serve` отдает команды профиля по MCP, через stdin и stdout:

```sh
claude mcp add notion -- notion personal mcp serve
```

Сервер предлагает все команды, в том числе те, что пишут. Что запускается, решают разрешения профиля, см.
[настройки](/llms.mdx/docs/ru/notion/configuration/content.md#permissions).

Для ChatGPT и Claude в браузере
`notion personal mcp serve --http --public-url https://laptop.example.ts.net` слушает на `127.0.0.1` (порт 8765 или
`--port`) за вашим собственным туннелем. Браузерное приложение входит по одноразовому коду, который печатает команда.
`notion personal mcp revoke` завершает все входы. `notion personal mcp server start` запускает тот же сервер в фоне,
`mcp server status` показывает его порт, код входа и вошедшие приложения, а `mcp server stop` останавливает его.
