Gologin MCP Server

GoLogin MCP Server cho các tác nhân AI

Quản lý hồ sơ trình duyệt GoLogin, proxy, dấu vân tay, thư mục và phiên trình duyệt đám mây thông qua hội thoại AI. Máy chủ Model Context Protocol (MCP) này kết nối ứng dụng khách AI của bạn với API GoLogin.

Bắt đầu nhanh

Bạn cần Node.js 22 trở lên, một tài khoản GoLogin đang hoạt động và mã thông báo API GoLogin. Node.js 22 và 24 LTS đã được kiểm thử trên macOS Apple Silicon.

1. Đăng nhập vào tài khoản GoLogin, mở API & MCP, và tạo mã thông báo trong tab API.
2. Thêm cấu hình này vào ứng dụng khách MCP của bạn, thay thế chỗ giữ chỗ mã thông báo. Hợp nhất nó vào bất kỳ cấu hình mcpServers hiện có nào.

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

3. Khởi động lại hoặc tải lại kết nối MCP của ứng dụng khách, sau đó hỏi: "Hiển thị hồ sơ GoLogin của tôi."

Ứng dụng khách tự động khởi động máy chủ. -y cho phép npm cài đặt gói mà không cần xác nhận tương tác. Máy chủ này đọc API_TOKEN; biến GOLOGIN_TOKEN được sử dụng bởi các CLI GoLogin khác không phải là bí danh ở đây.

Để kiểm tra khởi động từ thiết bị đầu cuối, với API_TOKEN đã được đặt trong môi trường của bạn:

npx -y gologin-mcp

Máy chủ giao tiếp qua đầu vào/đầu ra tiêu chuẩn (stdio) và chờ ứng dụng khách MCP. Nó không mở trình duyệt hoặc cung cấp dấu nhắc lệnh tương tác.

Những gì bạn có thể làm

• Tạo, đọc, cập nhật, xóa và tổ chức hồ sơ trình duyệt.
• Cấu hình proxy hồ sơ và làm mới dấu vân tay trình duyệt.
• Quản lý thư mục và tư cách thành viên hồ sơ của chúng.
• Đọc thông tin tài khoản.
• Bắt đầu và dừng hồ sơ trình duyệt trong đám mây GoLogin.

Khởi động đám mây trả về URL kết nối. Máy chủ này không hiển thị điều hướng trang, nhấp chuột, điền biểu mẫu hoặc công cụ khởi chạy Orbita cục bộ. Để tự động hóa trang, hãy sử dụng ứng dụng khách tự động hóa trình duyệt riêng hoặc GoLogin Agent Browser CLI.

Quy trình MCP chạy cục bộ; các yêu cầu API GoLogin và phiên trình duyệt đám mây yêu cầu truy cập mạng. Tính khả dụng của đám mây và các hoạt động API phụ thuộc vào quyền và gói tài khoản của bạn.

Công cụ

Tên công cụ được tạo từ phương thức HTTP và đường dẫn trong đặc tả OpenAPI GoLogin, mà máy chủ tải khi khởi động. Sau đây là lựa chọn các công cụ có sẵn, không phải danh sách bí danh cố định. Truy vấn tools/list trong ứng dụng khách MCP của bạn để biết tên và lược đồ đầu vào hiện tại.

Công cụ	Mô tả
get_profile_v2	Liệt kê và tìm kiếm hồ sơ, với phân trang và bộ lọc thư mục
post_profile_custom	Tạo hồ sơ với cài đặt một phần như tên, hệ điều hành và proxy
get_profile_id	Đọc hồ sơ theo ID
put_profile_id_custom	Cập nhật cài đặt hồ sơ đã chọn
delete_profile	Xóa các hồ sơ được liệt kê trong profilesToDelete
patch_profile_proxy_many_v2	Cấu hình proxy cho một hoặc nhiều hồ sơ
patch_profile_fingerprints	Làm mới dấu vân tay cho các hồ sơ được liệt kê trong browsersIds
get_proxy_v2	Liệt kê proxy
get_folders	Liệt kê thư mục
post_folders_folder	Tạo thư mục theo tên
patch_folders_folder	Thêm hoặc xóa hồ sơ khỏi thư mục
delete_folders_folder	Xóa thư mục theo tên
post_profile_id_web	Bắt đầu hồ sơ trong đám mây và trả về URL kết nối
delete_profile_id_web	Dừng hồ sơ đám mây
get_user	Đọc thông tin tài khoản

Ví dụ: ứng dụng khách MCP có thể gửi yêu cầu tools/call này để đọc hồ sơ:

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

Các đối số tuân theo lược đồ đầu vào của từng công cụ. Tham số đường dẫn và truy vấn, cũng như các trường nội dung yêu cầu, được truyền dưới dạng đối số cấp cao nhất.

Ví dụ về lời nhắc

• "Hiển thị hồ sơ GoLogin của tôi."
• "Tạo hồ sơ Linux có tên 'Research'."
• "Đổi tên hồ sơ PROFILE_ID thành 'Research US'."
• "Cập nhật hồ sơ PROFILE_ID để sử dụng các cài đặt proxy này."
• "Làm mới dấu vân tay cho hồ sơ PROFILE_ID."
• "Tạo thư mục có tên 'Research' và thêm hồ sơ PROFILE_ID vào đó."
• "Bắt đầu hồ sơ PROFILE_ID trong đám mây và cung cấp cho tôi URL kết nối."
• "Dừng phiên đám mây cho hồ sơ PROFILE_ID."
• "Hiển thị thông tin tài khoản GoLogin của tôi."

Thiết lập cho ứng dụng khách MCP

Claude Desktop

Mở Cài đặt > Nhà phát triển > Chỉnh sửa cấu hình và thêm cấu hình Bắt đầu nhanh vào claude_desktop_config.json. Thoát hoàn toàn và khởi động lại Claude Desktop, sau đó kiểm tra rằng gologin-mcp và các công cụ của nó có sẵn.

Xem hướng dẫn thiết lập MCP cục bộ chính thức để biết đường dẫn cấu hình và khắc phục sự cố.

Cursor

Thêm cấu hình Bắt đầu nhanh vào ~/.cursor/mcp.json cho tài khoản người dùng của bạn hoặc .cursor/mcp.json cho một dự án. Tải lại kết nối MCP và bật các công cụ của máy chủ. Giữ các cấu hình chứa mã thông báo API ngoài kiểm soát phiên bản.

Xem tài liệu MCP của Cursor để biết cài đặt ứng dụng khách hiện tại.

Các ứng dụng khách MCP khác

Sử dụng ứng dụng khách hỗ trợ máy chủ MCP stdio cục bộ. Cấu hình npx làm lệnh, -y và gologin-mcp làm đối số của nó và API_TOKEN trong môi trường máy chủ. Định dạng và vị trí cấu hình phụ thuộc vào ứng dụng khách.

Khắc phục sự cố

• Máy chủ không kết nối: kiểm tra rằng Node.js và npx có sẵn cho ứng dụng khách, sau đó khởi động lại kết nối MCP của nó. Máy chủ cũng cần quyền truy cập vào docs-download.gologin.com để tải định nghĩa công cụ của nó.
• API trả về 401 Unauthorized: kiểm tra API_TOKEN được truyền cho máy chủ và tính hợp lệ của mã thông báo trong GoLogin. Khởi động lại kết nối sau khi thay đổi nó.
• Không tìm thấy tên công cụ: làm mới danh sách công cụ và sử dụng các tên được trả về bởi tools/list; các tên như list_profiles và start_browser không phải là bí danh tích hợp.
• Khởi động đám mây thất bại: kiểm tra phản hồi API và quyền truy cập đám mây của tài khoản bạn. Khởi động MCP cục bộ không tự khởi động Orbita trên máy tính của bạn.

Phát triển

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

Để chạy bản dựng cục bộ của bạn với API_TOKEN đã được cấu hình:

node dist/index.js

Trước khi xuất bản, hãy chạy:

npm run release:check

Gói chỉ bao gồm máy chủ đã xây dựng, siêu dữ liệu gói, README và giấy phép. Kiểm tra phát hành xác minh danh sách cho phép này để trạng thái cục bộ, cơ sở dữ liệu, thông tin xác thực và tệp phát triển không thể được bao gồm dưới dạng tệp bổ sung. npm publish chạy cùng một kiểm tra tự động.

Phát hành MCP Registry

server.json mô tả máy chủ này cho MCP Registry chính thức dưới io.github.gologinapp/gologin-mcp. Gói npm khai báo cùng một định danh trong mcpName.

Giữ các phiên bản trong package.json, package-lock.json và server.json được căn chỉnh. Xuất bản gói npm đã kiểm tra trước, sau đó chạy Publish to MCP Registry từ tab Actions của kho lưu trữ trên main. Quy trình làm việc xác minh rằng bản phát hành npm chứa định danh Registry chính xác và xác thực bằng GitHub OIDC, không cần mã thông báo Registry riêng. Nó không xuất bản lên npm.

Liên kết

• GoLogin
• Tài liệu API GoLogin
• Gói npm
• Thư mục Glama

Giấy phép

MIT, bản quyền GoLogin.