Gologin MCP Server

GoLogin MCP Server สำหรับ AI Agents

จัดการโปรไฟล์เบราว์เซอร์ GoLogin, พร็อกซี, ฟิงเกอร์พริ้นท์, โฟลเดอร์ และเซสชันเบราว์เซอร์คลาวด์ผ่านการสนทนากับ AI เซิร์ฟเวอร์ Model Context Protocol (MCP) นี้เชื่อมต่อไคลเอนต์ AI ของคุณกับ GoLogin API

เริ่มต้นอย่างรวดเร็ว

คุณต้องมี Node.js เวอร์ชัน 22 หรือใหม่กว่า, บัญชี GoLogin ที่ใช้งานอยู่ และโทเค็น GoLogin API 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 ที่ใช้โดย GoLogin CLI อื่นๆ ไม่ใช่นามแฝงที่นี่

สำหรับการตรวจสอบการเริ่มต้นจากเทอร์มินัล โดยตั้งค่า API_TOKEN ไว้ในสภาพแวดล้อมของคุณแล้ว:

npx -y gologin-mcp

เซิร์ฟเวอร์สื่อสารผ่านมาตรฐานอินพุต/เอาต์พุต (stdio) และรอไคลเอนต์ MCP ไม่เปิดเบราว์เซอร์หรือให้พรอมต์คำสั่งแบบโต้ตอบด้วยตัวเอง

สิ่งที่คุณทำได้

• สร้าง อ่าน อัปเดต ลบ และจัดระเบียบโปรไฟล์เบราว์เซอร์
• กำหนดค่าพร็อกซีโปรไฟล์และรีเฟรชฟิงเกอร์พริ้นท์เบราว์เซอร์
• จัดการโฟลเดอร์และการเป็นสมาชิกโปรไฟล์ในโฟลเดอร์
• อ่านข้อมูลบัญชี
• เริ่มและหยุดโปรไฟล์เบราว์เซอร์ในคลาวด์ GoLogin

การเริ่มต้นคลาวด์จะส่งคืน URL การเชื่อมต่อ เซิร์ฟเวอร์นี้ไม่เปิดเผยเครื่องมือนำทางหน้าเว็บ คลิก กรอกฟอร์ม หรือเครื่องมือเปิดใช้งาน Orbita ในเครื่อง สำหรับการทำงานอัตโนมัติของหน้าเว็บ ให้ใช้ไคลเอนต์ระบบอัตโนมัติเบราว์เซอร์แยกต่างหากหรือ GoLogin Agent Browser CLI

กระบวนการ MCP ทำงานในเครื่อง; คำขอ GoLogin API และเซสชันเบราว์เซอร์คลาวด์ต้องเข้าถึงเครือข่าย ความพร้อมใช้งานของคลาวด์และการดำเนินการ API ขึ้นอยู่กับสิทธิ์และแผนของบัญชีคุณ

เครื่องมือ

ชื่อเครื่องมือถูกสร้างจากวิธี HTTP และเส้นทางใน ข้อกำหนด GoLogin OpenAPI ซึ่งเซิร์ฟเวอร์โหลดเมื่อเริ่มต้น ต่อไปนี้คือเครื่องมือที่มีให้เลือก ไม่ใช่รายการนามแฝงคงที่ ค้นหา tools/list ในไคลเอนต์ MCP ของคุณสำหรับชื่อและสคีมาอินพุตปัจจุบัน

เครื่องมือ	คำอธิบาย
get_profile_v2	แสดงรายการและค้นหาโปรไฟล์ พร้อมการแบ่งหน้าและตัวกรองโฟลเดอร์
post_profile_custom	สร้างโปรไฟล์ด้วยการตั้งค่าบางส่วน เช่น ชื่อ OS และพร็อกซี
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

เปิด Settings > Developer > Edit Config และเพิ่มการกำหนดค่า Quickstart ลงใน claude_desktop_config.json ออกจาก Claude Desktop โดยสมบูรณ์แล้วรีสตาร์ท จากนั้นตรวจสอบว่า gologin-mcp และเครื่องมือของมันพร้อมใช้งาน

ดู คู่มือการตั้งค่า MCP ในเครื่องอย่างเป็นทางการ สำหรับเส้นทางการกำหนดค่าและการแก้ไขปัญหา

Cursor

เพิ่มการกำหนดค่า Quickstart ลงใน ~/.cursor/mcp.json สำหรับบัญชีผู้ใช้ของคุณ หรือ .cursor/mcp.json สำหรับโปรเจกต์ โหลดการเชื่อมต่อ MCP ใหม่และเปิดใช้งานเครื่องมือของเซิร์ฟเวอร์ เก็บการกำหนดค่าที่มีโทเค็น API ไว้นอกระบบควบคุมเวอร์ชัน

ดู เอกสาร MCP ของ Cursor สำหรับการตั้งค่าไคลเอนต์ปัจจุบัน

ไคลเอนต์ MCP อื่นๆ

ใช้ไคลเอนต์ที่รองรับเซิร์ฟเวอร์ MCP stdio ในเครื่อง กำหนดค่า 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 Registry

server.json อธิบายเซิร์ฟเวอร์นี้สำหรับ MCP Registry อย่างเป็นทางการ ภายใต้ io.github.gologinapp/gologin-mcp แพ็คเกจ npm ประกาศตัวระบุเดียวกันใน mcpName

รักษาเวอร์ชันใน package.json, package-lock.json และ server.json ให้สอดคล้องกัน เผยแพร่แพ็คเกจ npm ที่ตรวจสอบแล้วก่อน จากนั้นรัน Publish to MCP Registry จากแท็บ Actions ของที่เก็บบน main เวิร์กโฟลว์ตรวจสอบว่าการเผยแพร่ npm มีตัวระบุ Registry ที่ถูกต้องและตรวจสอบสิทธิ์โดยใช้ GitHub OIDC โดยไม่ต้องใช้โทเค็น Registry แยกต่างหาก ไม่เผยแพร่ไปยัง npm

ลิงก์

• GoLogin
• เอกสาร GoLogin API
• แพ็คเกจ npm
• ไดเรกทอรี Glama

ใบอนุญาต

MIT, ลิขสิทธิ์ GoLogin