gotoHuman MCP Server

ทางการ

แพลตฟอร์ม Human-in-the-loop - อนุญาตให้เอเจนต์ AI และระบบอัตโนมัติส่งคำขอเพื่อขออนุมัติไปยังกล่องจดหมาย gotoHuman ของคุณ

GitHub
53

เอกสาร

gotoHuman MCP Server

gotoHuman ทำให้การเพิ่ม การอนุมัติจากมนุษย์ ให้กับเอเจนต์ AI และเวิร์กโฟลว์แบบเอเจนต์เป็นเรื่องง่าย
มีเวิร์กโฟลว์ human-in-the-loop แบบ async ที่จัดการให้ครบวงจร พร้อม UI การอนุมัติที่ปรับแต่งได้
เพลิดเพลินกับระบบยืนยันตัวตนในตัว, เว็บฮุก, การแจ้งเตือน, ฟีเจอร์สำหรับทีม และชุดข้อมูลเทรนที่พัฒนาอย่างต่อเนื่อง

ใช้ MCP server ของเราเพื่อขอการอนุมัติจากมนุษย์จากเวิร์กโฟลว์ AI ของคุณผ่าน MCP หรือเพิ่มลงใน IDE ของคุณเพื่อช่วยในการผสานรวม

การติดตั้ง

npx @gotohuman/mcp-server

ใช้กับ Cursor / Claude / Windsurf

{
  "mcpServers": {
    "gotoHuman": {
      "command": "npx",
      "args": ["-y", "@gotohuman/mcp-server"],
      "env": {
        "GOTOHUMAN_API_KEY": "your-api-key"
      }
    }
  }
}

Install MCP Server

รับ API key ของคุณและตั้งค่าขั้นตอนการอนุมัติที่ app.gotohuman.com

การสาธิต

นี่คือ Cursor ทางด้านซ้าย แต่นี่อาจเป็นเอเจนต์เบื้องหลังที่ตอบสนองต่อเว็บฮุกการอนุมัติด้วย

https://github.com/user-attachments/assets/380a4223-ea77-4e24-90a5-52669b77f56f

เครื่องมือ

list-forms

แสดงรายการเทมเพลตรีวิวทั้งหมดที่มีอยู่

  • ส่งคืน รายการเทมเพลตรีวิวทั้งหมดที่มีในบัญชีของคุณ รวมถึงข้อมูลระดับสูงเกี่ยวกับฟิลด์ที่เพิ่มเข้ามา

get-form-schema

รับ schema ที่จะใช้เมื่อขอการรีวิวจากมนุษย์สำหรับเทมเพลตรีวิวที่กำหนด

  • พารามิเตอร์
    • formId: ID ของเทมเพลตรีวิวที่จะดึง schema
  • ส่งคืน schema โดยพิจารณาฟิลด์ที่รวมอยู่และการกำหนดค่าของฟิลด์เหล่านั้น

request-human-review-with-form

ขอการรีวิวจากมนุษย์ จะปรากฏในกล่องข้อความ gotoHuman ของคุณ

  • พารามิเตอร์
    • formId: ID ของเทมเพลตรีวิวที่จะใช้
    • fieldData: เนื้อหา (ผลลัพธ์ AI ที่จะรีวิว, บริบท,...) และการกำหนดค่าสำหรับฟิลด์ของเทมเพลตรีวิว
      schema สำหรับสิ่งนี้ต้องดึงด้วย get-form-schema
    • config: การกำหนดค่าสำหรับเทมเพลตรีวิว ไม่บังคับ schema สำหรับสิ่งนี้ต้องดึงด้วย get-form-schema
    • title: ชื่อเรื่องที่แสดงในกล่องข้อความและการแจ้งเตือน ไม่บังคับ
    • webhookUrl: URL เว็บฮุกสำหรับคำขอนี้ ไม่บังคับ (เมื่อเทมเพลตรีวิวไม่มีเว็บฮุกเริ่มต้น)
    • workflow: ออบเจ็กต์ที่เชื่อมโยงการรีวิวนี้กับเวิร์กโฟลว์เอเจนต์แบบหลายขั้นตอน ไม่บังคับ:
      • runId: ID เฉพาะสำหรับการรันเวิร์กโฟลว์ปัจจุบัน ใช้ runId เดียวกันในทุกการรีวิวในการรันเดียวกัน หากส่ง workflow โดยไม่มี runId (แม้แต่ {}) หรือสำหรับทริกเกอร์ด้วยตนเอง gotoHuman จะสร้าง runId และส่งคืนเป็น workflowRunId สำหรับคำขอถัดไป
      • runName: ชื่อที่แสดงสำหรับการรัน ไม่บังคับ (สามารถตั้งค่าหรืออัปเดตได้ในทุกขั้นตอน)
      • prevSteps: อาร์เรย์ของ reviewId จากขั้นตอนการรีวิว gotoHuman ก่อนหน้า (ละเว้นในขั้นตอนแรก)
    • metadata: ข้อมูลเพิ่มเติมที่จะรวมในการตอบกลับเว็บฮุกหลังจากการส่งเทมเพลตรีวิว ไม่บังคับ
    • assignToUsers: รายการอีเมลผู้ใช้ที่จะมอบหมายการรีวิวให้ ไม่บังคับ
  • ส่งคืน reviewId, reviewLink และ workflowRunId เมื่อ gotoHuman กำหนดการรันเวิร์กโฟลว์ใหม่ ไม่บังคับ

การพัฒนา

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

รันในเครื่องใน MCP Client (เช่น Cursor / Claude / Windsurf)

{
"mcpServers": {
  "gotoHuman": {
    "command": "node",
    "args": ["/<absolute-path>/build/index.js"],
    "env": {
      "GOTOHUMAN_API_KEY": "your-api-key",
      "GOTOHUMAN_AGENT_ID": "your-agent-id"
    }
  }
}
}

[!NOTE] สำหรับ Windows พาธ args ต้องเป็น C:\\<absolute-path>\\build\\index.js