APIПодключение ИИ-агента к Dolphin {anty} через Dolphin MCP

Подключение ИИ-агента к Dolphin {anty} через Dolphin MCP

Общие сведения 📜

Dolphin MCP позволяет подключить к Dolphin{anty} своего ИИ-агента: Claude Code, Cursor, Codex, Claude Desktop или любого другого, который умеет работать с MCP-серверами.

После подключения агенту достаточно написать, что нужно сделать, и он сделает это сам. Например:

  • "Создай 10 профилей в папке Тест и поставь им тег new"
  • "Покажи, какие профили сейчас запущены"
  • "Проверь все мои прокси"
ru msp5
ru msp5


Агент работает с профилями, прокси, папками, тегами, статусами, заметками, командой, передачей профилей, расширениями, закладками и стартовыми страницами. Подробнее - в разделе Что умеет агент ниже.

🔵 Dolphin MCP или chrome-devtools-mcp?

  • Dolphin MCP управляет аккаунтом: создаёт, настраивает и запускает профили, работает с прокси, папками и тегами
  • chrome-devtools-mcp работает внутри открытого профиля: открывает страницы, кликает, заполняет формы. Как его подключить - в статье Подключение ИИ-агента к профилю Dolphin {anty} через chrome-devtools-mcp

Профиль для chrome-devtools-mcp не нужно запускать через Dolphin MCP: Dolphin MCP запускает профиль в обычном режиме, и chrome-devtools-mcp к нему не подключится. Скрипт из той статьи запускает профиль сам.

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

  1. Тариф Starter или выше
  2. Dolphin{anty}, который уже хотя бы раз запускали
  3. ИИ-агент, который умеет подключать MCP-серверы на компьютере: Claude Code, Cursor, Codex, Claude Desktop (на Linux его нет) или другой

Устанавливать Node.js не нужно. А вот чат ChatGPT подключить не получится: он принимает только серверы по ссылке из интернета, а Dolphin MCP работает прямо на компьютере.

⚠️ На macOS приложение должно лежать в папке "Программы"

Если запустить его из DMG-образа или из "Загрузок", агент сможет подключиться только по HTTP. Приложение об этом предупредит.

Шаг 1. Включение MCP ⚙️

  1. Открыть настройки Dolphin{anty}. Вверху, среди интеграций, есть раздел Dolphin{anty} MCP
  2. Включить переключатель справа от заголовка раздела. В строке Локальный сервер MCP появится Включён и порт 28771
ru msp3
ru msp3

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

  1. Нажать Подключить агента и выбрать вкладку своего агента
  2. Скопировать готовые настройки и добавить их агенту:
ru msp1
ru msp1

Выполнить скопированную команду в терминале и открыть новую сессию Claude Code. Команда сама добавит сервер dolphin, править файлы вручную не нужно.

Если сервер dolphin уже добавляли раньше, сначала нужно удалить его:

claude mcp remove dolphin

ℹ️ Токенов в настройках нет, зато есть пути к Dolphin{anty} на этом компьютере. Поэтому копировать их нужно из своего приложения, а не с чужого компьютера или из инструкций.

Шаг 3. Проверка подключения 🔍

  1. Перезапустить агента
  2. Нажать Проверить подключение. Если всё в порядке, появится Приложение готово принимать агента и число действий, которые доступны агенту
  1. Написать агенту, например: "Покажи список моих профилей Dolphin"
  2. Нажать Обновить статус: в строке Последний вызов агента появятся время, агент и действие
ru msp4
ru msp4

✅ Готово! Теперь агент работает с аккаунтом, пока открыт Dolphin{anty}. Чтобы он работал и при закрытом приложении, нужно войти в аккаунт, об этом ниже 👇

Другие способы подключения 🔀

Вход в аккаунт и уровни доступа 🔑

Сразу после подключения агент работает через открытое приложение. Он может смотреть и менять данные, запускать профили и выгружать cookies, но не может ничего удалять, передавать профили, менять доступы и загружать cookies.

Войти в аккаунт стоит, если нужно:

  • чтобы агент работал, даже когда Dolphin{anty} закрыт
  • самому выбрать, что агенту можно, а что нельзя

Как войти:

  1. В строке Аккаунт нажать Войти. В браузере откроется личный кабинет
  2. Проверить аккаунт и команду, выбрать уровень доступа и подтвердить. На это есть 5 минут. Если вкладку случайно закрыли, нажать Войти заново
  3. В строке Аккаунт появятся email и уровень доступа. Теперь приложение можно закрывать
ru msp2
ru msp2

Уровни доступа:

  • Только чтение - агент только смотрит: профили, прокси, папки, теги, статусы, заметки, участников команды, расширения, закладки и стартовые страницы. Ничего не меняет, не запускает профили и не выгружает cookies, даже если приложение открыто
  • Чтение и изменение (выбран по умолчанию) - агент ещё создаёт и меняет профили, папки, статусы и заметки, создаёт прокси, ставит и снимает теги, добавляет расширения, закладки и стартовые страницы. Может отменить свою передачу профиля, но ничего не удаляет
  • Полный контроль - агенту можно всё: удалять, передавать профили, принимать и отклонять передачи, менять доступы к профилям, загружать cookies и local storage

Как сменить уровень:

  1. В личном кабинете на странице MCP-подключения отозвать подключение
  2. В приложении нажать Обновить статус
  3. Снова нажать Войти и выбрать другой уровень

ℹ️ Полезно знать:

  • Если агент месяц ничего не делал через аккаунт, войти нужно заново
  • Если вход отозвали или он закончился, ограничения уровня тоже пропадают: при открытом приложении агент снова работает как без входа
  • У агента те же права в команде, что и у пользователя. Больше, чем может сам пользователь, агент не сделает
  • На одном компьютере MCP работает только для 1 аккаунта приложения. Если зайти в приложение под другим аккаунтом, вход агента сбросится, а у нового аккаунта MCP будет выключен. После возврата в свой аккаунт нужно снова включить MCP, нажать Войти, а старое подключение отозвать в личном кабинете

Что умеет агент 🤖

Агент работает почти со всем, что есть в аккаунте:

  • Профили: найти, создать (по одному или до 100 за раз), переименовать, поставить теги, стартовые страницы и заметки, удалить, запустить и остановить
  • Прокси: создать, проверить, сменить IP
  • Папки, теги и статусы
  • Команда: доступы к профилям и передача профилей
  • Расширения, закладки и стартовые страницы
  • Cookies и local storage: выгрузить и загрузить

А ещё агент может просто рассказать, что происходит: показать списки, статусы, запущенные профили и у кого есть доступ.

ℹ️ Запуск и остановка профилей, cookies и local storage, изменение и проверка прокси и смена IP работают только при открытом приложении.

Чего агент не делает:

  • Не работает внутри профиля: не открывает страницы, не кликает, не заполняет формы. Для этого есть chrome-devtools-mcp
  • Не меняет отпечаток и прокси уже созданного профиля, это делается в приложении
  • Видит профили с паролем, но не меняет их, не запускает и не выгружает их cookies
  • Не трогает оплату и тарифы, не приглашает и не удаляет участников команды, не меняет пароли профилей
  • Не работает с синхронизатором и сценариями, не восстанавливает профили из корзины
  • Не видит логин, пароль и ссылку смены IP прокси, только знает, что они есть
  • Пока не умеет запускать профиль в режиме автоматизации и создавать прокси NodeMaven

ℹ️ В Cursor есть ограничение на число активных инструментов. Если инструменты Dolphin не помещаются, лишние можно отключить в настройках Cursor.

Безопасность 🛡️

Агент действует от имени пользователя и с его правами в команде. Поэтому стоит помнить о нескольких вещах:

⚠️ Важно

  • Агент читает названия профилей, заметки, теги, имена папок и прокси. Текст, написанный там, он может принять за команду
  • Удалять, передавать профили, менять доступы и загружать cookies агент может только с уровнем Полный контроль
  • При передаче профиля с прокси получатель увидит логин и пароль прокси. Если ты в белом списке у получателя, передача пройдёт сразу, и отменить её будет нельзя
  • Токен из личного кабинета и токен для HTTP хранятся в настройках агента открытым текстом
  • Выгруженные файлы cookies и local storage лежат в папке приложения до 24 часов. Если выключить MCP, они удалятся сразу

Как отозвать доступ 🚫

Чтобы полностью отключить агента:

  1. Выключить переключатель Dolphin{anty} MCP в приложении на каждом компьютере, где он включён
  2. В личном кабинете на странице MCP-подключения нажать Отозвать все

Если сделать только что-то одно:

  • Отозвать в личном кабинете - в течение минуты агент перестанет работать без приложения. Но пока приложение открыто и MCP в нём включён, агент продолжит работать
  • Выключить MCP - агент перестанет работать на этом компьютере, а на других продолжит
  • Отзыв не удаляет уже выгруженные файлы cookies, а выключение MCP удаляет их сразу

Также все подключения отзываются при смене или сбросе пароля аккаунта. На тарифе Free и после окончания подписки агент не работает, а после оплаты снова работает без нового входа.

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

  • Порт 28771 уже занят

    Раскрыть Дополнительно внизу раздела, нажать Сменить порт, ввести свободный порт от 1024 до 65535 и нажать Применить. Агента, подключённого командой, перенастраивать не нужно, а у подключённого по HTTP нужно поменять порт в адресе

  • MCP выключен

    Включить переключатель в разделе Dolphin{anty} MCP

  • Агент пишет, что нужно запущенное приложение

    Открыть Dolphin{anty}: запуск профилей, cookies, проверка и смена IP прокси работают только с ним

  • "Приложение не принимает агента"

    Войти в приложение или дождаться загрузки аккаунта

  • "Вход без приложения выполнен в другой аккаунт"

    Нажать Войти заново под своим аккаунтом

  • "В браузере выполнен вход в другой аккаунт"

    Войти в личный кабинет под аккаунтом приложения и снова нажать Войти

  • "Приложение запущено из временной папки" (macOS)

    Перенести приложение в папку "Программы"

  • "Настройки MCP недоступны в этой оболочке приложения" или раздела MCP нет

    Обновить приложение. Если раздела нет и после обновления, написать в поддержку

  • Агент не видит инструменты Dolphin

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

  • Агент не может создать профиль сразу с прокси

    Создать профиль без прокси и назначить прокси в приложении

  • Кнопка "Войти" не открывает браузер

    Подключить агента через токен из личного кабинета, см. Другие способы подключения выше

  • Проверка подключения не прошла

    Нажать Скопировать отчёт и отправить его в поддержку