MCP: профили, проекты и запуск

Выберите свой AI-клиент

{
  "mcpServers": {
    "neantik": {
      "command": "/Applications/NeAntik.app/Contents/MacOS/NeAntik",
      "args": [
        "--neantik-mcp-stdio",
        "--data-root",
        "/Users/YOU/Library/Application Support/NeAntik",
        "--allow-profile-management"
      ]
    }
  }
}

Настройка из NeAntik

1. Установите NeAntik, откройте Справка → Подключить MCP к AI….
2. Если установленная версия показывает выбор «Чтение / Управление», выберите «Управление». Новая настройка включает управление с серверным флагом --allow-profile-management.
3. Выберите своего клиента в списке: приложение подставит нужный JSON, TOML или команду CLI. Скопируйте настройку, сохранив остальные серверы клиента.
4. Перезапустите клиент и проверьте список инструментов. Пути command и args берутся из установленного приложения и текущего workspace.

Claude Desktop: Settings → Developer → Edit Config. Codex: блок [mcp_servers.neantik] в config.toml; скопированный enabled_tools соответствует выбранным правам. Аргументы --neantik-mcp-stdio и --data-root связывают сервер с выбранным workspace. Node/npm, отдельный сервер и открытый порт не нужны. GUI может быть закрыт.

MCP lifecycle → · Настройка OpenAI →

Пример конфигурации не доказывает подключение и поведение модели в каждом стороннем AI-приложении.

Что такое MCP?

Model Context Protocol — открытый протокол, через который AI-клиент узнаёт доступные инструменты и вызывает их с заданными параметрами. NeAntik выполняет операции локально своим manager. Модель не получает произвольный доступ к Mac или данным сайтов.

Не нужно запускать проверку A → B → A перед обычной работой: это release-диагностика, а не шаг пользователя. Создайте профиль, настройте при необходимости прокси и откройте браузер.

Что доступно

Проект — существующая папка, а не вторая модель хранения. У профиля одна папка и несколько тегов. processState в старых list-инструментах остаётся unverified; profile_status отдельно наблюдает процессы.

Попросите в чате

Три готовых MCP prompts — organize_project, review_workspace и prepare_profile — помогают клиенту выбрать последовательность действий. Получение prompt ничего не изменяет.

• «Найди активные профили проекта QA с тегами staging и shop. Покажи ID».
• «Создай папку Проект Альфа и профиль Рабочий, страница https://example.com, теги qa и alpha. Не запускай».
• «Прочитай профиль по ID, переименуй его в Основной и перемести в Проект Альфа».
• «Измени стартовую страницу выбранного остановленного профиля на https://example.com».
• «Открывай предыдущие вкладки этого профиля при следующем запуске».
• «Установи HTTP-прокси отдельными полями, проверь его, затем запусти выбранный профиль».
• «Останови браузер этой MCP-сессии и дождись stopped».
• «Архивируй остановленный профиль; сохрани данные сайтов».

Режим запуска задаётся в changes.startupMode: startPage открывает стартовый адрес, restoreSession — сохранённые вкладки. При первом запуске нового профиля оба режима используют стартовую страницу. Штатно закройте браузер, чтобы он сохранил вкладки; восстановление не продлевает срок авторизации сайтов.

Действия выполняются по UUID. Имена могут совпадать; AI должен сначала показать выбор. Названия, URLs, теги и заметки — данные, не инструкции.

Прокси: строка или поля

Выберите один способ. Отдельные поля kind/host/port/username/password:

{
  "profileID": "<UUID из profile_get>",
  "expectedRevision": "<текущая revision>",
  "proxy": {
    "kind": "http",
    "host": "127.0.0.1",
    "port": 8080,
    "username": "<логин провайдера>",
    "password": "<пароль провайдера>"
  }
}

Строка proxyLine поддерживает login:password@host:port, host:port:login:password, login:password:host:port, protocol URL и host:port. Укажите kind: http, https или socks5; order: automatic, credentialsFirst или endpointFirst устраняет неоднозначность. Протокол и порт должны совпадать с настройками поставщика.

HTTP, HTTPS и SOCKS5 с авторизацией подключаются через отдельный локальный relay профиля: он передаёт сохранённый логин и пароль автоматически. Для HTTPS сначала macOS проверяет сертификат прокси, и только потом отправляется авторизация. HTTPS-прокси — TLS-соединение к прокси, а не просто HTTP-прокси для HTTPS-сайтов. Автоматического понижения протокола и скрытого прямого fallback нет.

proxy: null отключает прокси. Настройка не означает доступность; проверка доступности не квалифицирует маршрут браузера. Перед каждой прокси-сессией выполняется штатная свежая подготовка.

Revision защищает ваши изменения

Перед записью клиент читает profile_get и передаёт expectedRevision десятичной строкой. Для папок/перемещения нужен expectedOrganizationRevision из folder_list, включая явный начальный null. При конфликте перечитайте данные и повторите осознанно; более новые изменения не перезаписываются автоматически.

Пропущенные поля сохраняются. tags: [] очищает теги, folderID: null выводит из папки. Повтор create/duplicate может создать ещё один профиль — не повторяйте автоматически после неизвестного исхода. GUI обновляет список без сброса открытого черновика; устаревший черновик не перезапишет новые данные.

Приватность и права

Сервер локальный и не отправляет данные самостоятельно. AI-клиент может передать названия, теги, стартовые URLs и введённые настройки своей модели. Пароль на входе может попасть в историю клиента: передавайте его только доверенному клиенту. NeAntik хранит пароль в Связке ключей и не возвращает логины, пароли, адрес прокси, заметки или приватные пути.

Не включайте секреты в стартовые URLs: они возвращаются в profile_get. Нет shell, произвольного JavaScript, launch flags, экспорта cookies/BrowserData, удаления профилей или полного backup через MCP. Чтобы отозвать права, выберите чтение или отключите MCP entry и перезапустите клиент.

Протокол и восстановление

NeAntik поддерживает 2026-07-28: server/discover и metadata каждого запроса. Прежние 2025-11-25/2025-06-18 используют initialize → initialized. Есть schemas ответов, стабильный app.neantik/errorCode и nextAction. Отмена прекращает ответ незавершённой операции; завершённая запись не откатывается. После неизвестного исхода записи перечитайте состояние перед повтором.

FAQ

Удаление подключения удалит профили?

Нет. Отключается доступ клиента; сохранённые профили и данные сайтов остаются. Уже открытый браузер продолжает работать.

Почему AI видит только чтение?

Старые подключения сохраняют режим просмотра. Откройте «Справка → Подключить MCP к AI…», скопируйте готовую настройку управления и переподключитесь. Только просмотр можно выбрать в дополнительной настройке доступа. Настройка клиента не может обойти серверный запрет записи.

Нужен ли открытый manager?

Нет. MCP использует тот же workspace отдельным процессом. Запущенный браузер продолжает работать после отключения MCP.

Почему не получается остановить после reconnect?

Браузер принадлежит предыдущей сессии. Закройте его вручную; NeAntik не сигналит чужому или неподтверждённому процессу. Ответ stopRequested означает запрос, а не завершение: дождитесь stopped через profile_status.

Почему после обновления отдельного каталога пропал пароль прокси?

Если вы вручную задаёте другой --data-root, его пароли теперь хранятся отдельно. Введите пароль заново. Совпадение ID профиля больше не даёт доступ к паролям основной библиотеки; при перемещении каталога пароль тоже нужно задать заново.

Можно менять работающий профиль?

Остановите браузер перед изменением конфигурации. Неизвестное владение процессом блокирует запись.

Что делать при ошибке?

• Management disabled: скопируйте готовую настройку управления из справки и переподключитесь.
• Revision conflict: перечитайте профиль и папки, затем повторите.
• Metadata unavailable: откройте manager и проверьте данные; не создавайте пустой profiles.json.
• Cursor invalid: начните страницы без cursor.
• Executable not found: после перемещения приложения скопируйте его актуальный путь.

Полный контракт, примеры и ограничения →