Подключение AI-агента

1. Включите API

Убедитесь, что Accovod лежит в папке Программы. Приложение, запущенное из «Загрузок» или образа диска, не даст скопировать конфиг: такой путь перестанет работать после перезапуска.
В строке меню откройте Automation → Enable API / MCP access.

В меню появится адрес API, например Local API: 127.0.0.1:25252.

2. Подключите клиента

Accovod сам готовит настройки: в меню Automation есть пункты, которые кладут нужный текст в буфер обмена.

Automation → Copy Claude Code command и вставьте команду в Терминал:

claude mcp add --scope user accovod -- '/Applications/Accovod.app/Contents/MacOS/accovod-mcp'

--scope user важен: без него Accovod будет доступен только в той папке, где вы запустили команду.

Automation → Copy Codex config (TOML) и добавьте текст в ~/.codex/config.toml (если файла нет — создайте):

[mcp_servers.accovod]
command = "/Applications/Accovod.app/Contents/MacOS/accovod-mcp"
args = []

Или одной командой в Терминале:

codex mcp add accovod -- '/Applications/Accovod.app/Contents/MacOS/accovod-mcp'

Перезапустите Codex.

Automation → Copy MCP config (JSON). В Claude Desktop откройте Settings → Developer → Edit Config и добавьте блок в claude_desktop_config.json:

{
  "mcpServers": {
    "accovod": {
      "command": "/Applications/Accovod.app/Contents/MacOS/accovod-mcp",
      "args": []
    }
  }
}

Если в файле уже есть mcpServers, добавьте только accovod внутрь. Перезапустите Claude Desktop.

Automation → Copy MCP config (JSON) и добавьте его в файл:

Cursor — ~/.cursor/mcp.json
Windsurf — ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "accovod": {
      "command": "/Applications/Accovod.app/Contents/MacOS/accovod-mcp",
      "args": []
    }
  }
}

Порт и токен в конфиг не записываются: accovod-mcp каждый раз читает их из файла control.json. Поэтому после перезапуска Accovod ничего править не нужно.

3. Проверьте связь

Попросите агента: «Проверь статус Accovod и покажи мои профили». Агент вызовет app_status и profiles_list.

Проверить без агента можно в Терминале:

/Applications/Accovod.app/Contents/MacOS/accovod-mcp --health

Меню Automation: включение API, готовые конфиги и токен.

Меню Automation

Пункт	Что делает
Enable API / MCP access	Включает и выключает API. По умолчанию выключен.
Copy Claude Code command / Copy Codex config / Copy MCP config	Готовые настройки для клиентов.
Copy API address / Copy API token	Адрес и токен для своих скриптов.
Show control.json in Finder	Файл с текущим портом и токеном.
Always use port 25252	Включено по умолчанию: API работает на порту 25252, а если он занят другой программой — на любом свободном. Если выключить, Accovod будет брать случайный свободный порт при каждом запуске.
Regenerate token	Выпустить новый токен. Старый сразу перестанет работать.
Stop Agent `⇧⌘.`	Остановить агента. Появляется, пока агент работает.

Если не подключается

«Accovod is not running» / нет ответа — откройте Accovod и проверьте, что Enable API / MCP access включён.
Команда копирования отказывается работать — переместите Accovod.app в Программы и запустите оттуда.
Агент не видит инструменты — перезапустите клиента после правки конфига. В Claude Code проверьте список серверов командой claude mcp list.
UNAUTHORIZED — токен сменили через Regenerate token. MCP подхватит новый сам, а в свои скрипты его нужно вставить заново.