Gologin MCP Server

MCP-сервер GoLogin для ИИ-агентов

Управляйте браузерными профилями GoLogin, прокси, отпечатками, папками и облачными браузерными сессиями через диалоги с ИИ. Этот сервер Model Context Protocol (MCP) подключает ваш ИИ-клиент к API GoLogin.

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

Вам понадобится Node.js 22 или новее, активная учетная запись GoLogin и токен API GoLogin. Node.js 22 и 24 LTS протестированы на macOS Apple Silicon.

1. Войдите в свою учетную запись GoLogin, откройте API и MCP и создайте токен на вкладке API.
2. Добавьте эту конфигурацию в ваш MCP-клиент, заменив заполнитель токена. Объедините её с любой существующей конфигурацией mcpServers.

{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}

3. Перезапустите или перезагрузите MCP-подключение клиента, затем спросите: «Покажи мои профили GoLogin».

Клиент запускает сервер автоматически. -y позволяет npm установить пакет без интерактивного подтверждения. Этот сервер читает API_TOKEN; переменная GOLOGIN_TOKEN, используемая другими CLI GoLogin, здесь не является псевдонимом.

Для проверки запуска в терминале, если API_TOKEN уже задан в вашем окружении:

npx -y gologin-mcp

Сервер взаимодействует через стандартный ввод/вывод (stdio) и ожидает MCP-клиента. Он не открывает браузер и не предоставляет интерактивную командную строку самостоятельно.

Что вы можете делать

• Создавать, читать, обновлять, удалять и организовывать браузерные профили.
• Настраивать прокси профилей и обновлять отпечатки браузера.
• Управлять папками и их составом профилей.
• Читать информацию об учетной записи.
• Запускать и останавливать браузерные профили в облаке GoLogin.

Облачный запуск возвращает URL подключения. Этот сервер не предоставляет инструментов для навигации по страницам, кликов, заполнения форм или локального запуска Orbita. Для автоматизации страниц используйте отдельный клиент автоматизации браузера или CLI агентного браузера GoLogin.

Процесс MCP выполняется локально; запросы к API GoLogin и облачные браузерные сессии требуют доступа к сети. Доступность облака и операции API зависят от разрешений вашей учетной записи и тарифного плана.

Инструменты

Имена инструментов формируются из HTTP-метода и пути в спецификации OpenAPI GoLogin, которую сервер загружает при запуске. Ниже приведен выбор доступных инструментов, а не фиксированный список псевдонимов. Запросите tools/list в вашем MCP-клиенте для получения актуальных имен и схем входных данных.

Инструмент	Описание
get_profile_v2	Список и поиск профилей с пагинацией и фильтрами по папкам
post_profile_custom	Создание профиля с частичными настройками, такими как имя, ОС и прокси
get_profile_id	Чтение профиля по ID
put_profile_id_custom	Обновление выбранных настроек профиля
delete_profile	Удаление профилей, перечисленных в profilesToDelete
patch_profile_proxy_many_v2	Настройка прокси для одного или нескольких профилей
patch_profile_fingerprints	Обновление отпечатков для профилей, перечисленных в browsersIds
get_proxy_v2	Список прокси
get_folders	Список папок
post_folders_folder	Создание папки по имени
patch_folders_folder	Добавление или удаление профилей из папки
delete_folders_folder	Удаление папки по имени
post_profile_id_web	Запуск профиля в облаке и возврат URL подключения
delete_profile_id_web	Остановка облачного профиля
get_user	Чтение информации об учетной записи

Например, MCP-клиент может отправить этот запрос tools/call для чтения профиля:

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

Аргументы следуют схеме входных данных каждого инструмента. Параметры пути и запроса, а также поля тела запроса передаются как аргументы верхнего уровня.

Примеры запросов

• «Покажи мои профили GoLogin».
• «Создай профиль Linux с именем "Research"».
• «Переименуй профиль PROFILE_ID в "Research US"».
• «Обнови профиль PROFILE_ID, чтобы использовать эти настройки прокси».
• «Обнови отпечаток для профиля PROFILE_ID».
• «Создай папку с именем "Research" и добавь в неё профиль PROFILE_ID».
• «Запусти профиль PROFILE_ID в облаке и дай мне URL подключения».
• «Останови облачную сессию для профиля PROFILE_ID».
• «Покажи информацию о моей учетной записи GoLogin».

Настройка для MCP-клиентов

Claude Desktop

Откройте Настройки > Разработчик > Изменить конфигурацию и добавьте конфигурацию из раздела «Быстрый старт» в claude_desktop_config.json. Полностью завершите и перезапустите Claude Desktop, затем проверьте, что gologin-mcp и его инструменты доступны.

См. официальное руководство по локальной настройке MCP для путей конфигурации и устранения неполадок.

Cursor

Добавьте конфигурацию из раздела «Быстрый старт» в ~/.cursor/mcp.json для вашей учетной записи пользователя или в .cursor/mcp.json для проекта. Перезагрузите MCP-подключение и включите инструменты сервера. Не храните конфигурации, содержащие токены API, в системе контроля версий.

См. документацию Cursor по MCP для актуальных настроек клиента.

Другие MCP-клиенты

Используйте клиент, поддерживающий локальные stdio MCP-серверы. Настройте npx как команду, -y и gologin-mcp как её аргументы, а API_TOKEN в окружении сервера. Формат и расположение конфигурации зависят от клиента.

Устранение неполадок

• Сервер не подключается: проверьте, что Node.js и npx доступны клиенту, затем перезапустите его MCP-подключение. Серверу также нужен доступ к docs-download.gologin.com для загрузки определений инструментов.
• API возвращает 401 Unauthorized: проверьте API_TOKEN, переданный серверу, и действительность токена в GoLogin. Перезапустите подключение после изменения.
• Имя инструмента не найдено: обновите список инструментов и используйте имена, возвращаемые tools/list; такие имена, как list_profiles и start_browser, не являются встроенными псевдонимами.
• Облачный запуск не работает: проверьте ответ API и доступ вашей учетной записи к облаку. Локальный запуск MCP сам по себе не запускает Orbita на вашем компьютере.

Разработка

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

Чтобы запустить локальную сборку с уже настроенным API_TOKEN:

node dist/index.js

Перед публикацией выполните:

npm run release:check

Пакет включает только собранный сервер, метаданные пакета, README и лицензию. Проверка релиза подтверждает этот список разрешенных файлов, чтобы локальное состояние, базы данных, учетные данные и файлы разработки не могли быть включены как дополнительные файлы. npm publish автоматически выполняет ту же проверку.

Релизы в реестре MCP

server.json описывает этот сервер для официального реестра MCP под io.github.gologinapp/gologin-mcp. Пакет npm объявляет тот же идентификатор в mcpName.

Поддерживайте согласованность версий в package.json, package-lock.json и server.json. Сначала опубликуйте проверенный пакет npm, затем запустите Publish to MCP Registry на вкладке Actions репозитория на main. Рабочий процесс проверяет, что релиз npm содержит правильный идентификатор реестра, и выполняет аутентификацию через GitHub OIDC, без отдельного токена реестра. Он не публикует в npm.

Ссылки

• GoLogin
• Документация API GoLogin
• Пакет npm
• Каталог Glama

Лицензия

MIT, авторские права GoLogin.