gotoHuman MCP Server

gotoHuman MCP 伺服器

gotoHuman 讓您可以輕鬆地為 AI 代理和代理工作流程加入人工審核。
一個全託管的非同步人機迴圈工作流程，搭配可自訂的審核介面。
內建驗證、Webhook、通知、團隊功能，以及持續演進的訓練資料集。

使用我們的 MCP 伺服器，透過 MCP 從您的 AI 工作流程請求人工審核，或將其加入您的 IDE 以協助整合。

安裝

npx @gotohuman/mcp-server

與 Cursor / Claude / Windsurf 搭配使用

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

在 app.gotohuman.com 取得您的 API 金鑰並設定審核步驟

展示

左側是 Cursor，但這也可以是背景代理，同時對審核 Webhook 做出反應。

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

工具

list-forms

列出所有可用的審核範本。

• 回傳 您帳戶中所有可用審核範本的清單，包含已新增欄位的高階資訊

get-form-schema

取得為特定審核範本請求人工審核時應使用的結構描述。

• 參數
  • formId：要取得結構描述的審核範本 ID
• 回傳 結構描述，考量包含的欄位及其設定

request-human-review-with-form

請求人工審核。將會出現在您的 gotoHuman 收件匣中。

• 參數
  • formId：要使用的審核範本 ID
  • fieldData：審核範本欄位的內容（待審核的 AI 輸出、上下文等）與設定。
    此項目的結構描述需透過 get-form-schema 取得
  • config：審核範本的設定。選用。此項目的結構描述需透過 get-form-schema 取得
  • title：選用的標題，顯示於收件匣和通知中
  • webhookUrl：此請求的選用 Webhook URL（當審核範本沒有預設 Webhook 時）
  • workflow：選用物件，將此審核連結至多步驟代理工作流程：
    • runId：目前工作流程執行的唯一 ID。在同一次執行的每個審核中使用相同的 runId。如果傳送 workflow 時未附帶 runId（即使是 {}），或用於手動觸發，gotoHuman 會建立一個 runId 並將其作為 workflowRunId 回傳，供後續請求使用。
    • runName：選用的執行顯示名稱（可在任何步驟設定或更新）
    • prevSteps：來自先前 gotoHuman 審核步驟的 reviewId 陣列（第一步時省略）
  • metadata：選用的額外資料，將在審核範本提交後包含於 Webhook 回應中
  • assignToUsers：選用的使用者電子郵件清單，用於指派審核
• 回傳 reviewId、reviewLink，以及當 gotoHuman 指派新的工作流程執行時，選用的 workflowRunId

開發

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

在 MCP 客戶端（例如 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