gotoHuman MCP Server

gotoHuman MCP Server

gotoHuman giúp bạn dễ dàng thêm phê duyệt từ con người vào các tác nhân AI và quy trình làm việc tự động.
Một quy trình làm việc bất đồng bộ có con người trong vòng lặp được quản lý đầy đủ, với giao diện phê duyệt có thể tùy chỉnh.
Tận hưởng xác thực tích hợp, webhooks, thông báo, tính năng nhóm và tập dữ liệu huấn luyện không ngừng phát triển.

Sử dụng máy chủ MCP của chúng tôi để yêu cầu phê duyệt từ con người trong các quy trình làm việc AI thông qua MCP hoặc thêm nó vào IDE của bạn để hỗ trợ tích hợp.

Cài đặt

npx @gotohuman/mcp-server

Sử dụng với Cursor / Claude / Windsurf

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

Lấy khóa API của bạn và thiết lập bước phê duyệt tại app.gotohuman.com

Demo

Đây là Cursor ở bên trái, nhưng cũng có thể là một tác nhân nền phản ứng với webhook phê duyệt.

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

Công cụ

list-forms

Liệt kê tất cả các mẫu đánh giá có sẵn.

• Trả về danh sách tất cả các mẫu đánh giá có sẵn trong tài khoản của bạn, bao gồm thông tin cấp cao về các trường đã thêm

get-form-schema

Lấy lược đồ để sử dụng khi yêu cầu đánh giá từ con người cho một mẫu đánh giá nhất định.

• Tham số
  • formId: ID của mẫu đánh giá cần lấy lược đồ
• Trả về lược đồ, xem xét các trường bao gồm và cấu hình của chúng

request-human-review-with-form

Yêu cầu đánh giá từ con người. Sẽ xuất hiện trong hộp thư đến gotoHuman của bạn.

• Tham số
  • formId: ID của mẫu đánh giá sẽ sử dụng
  • fieldData: Nội dung (đầu ra AI cần đánh giá, ngữ cảnh,...) và cấu hình cho các trường của mẫu đánh giá.
    Lược đồ cho việc này cần được lấy bằng get-form-schema
  • config: Cấu hình cho mẫu đánh giá. Tùy chọn. Lược đồ cho việc này cần được lấy bằng get-form-schema
  • title: Tiêu đề tùy chọn hiển thị trong hộp thư đến và thông báo
  • webhookUrl: URL webhook tùy chọn cho yêu cầu này (khi mẫu đánh giá không có webhook mặc định)
  • workflow: Đối tượng tùy chọn liên kết đánh giá này với một quy trình làm việc tự động nhiều bước:
    • runId: ID duy nhất cho lần chạy quy trình làm việc hiện tại. Sử dụng cùng một runId trên mọi đánh giá trong cùng một lần chạy. Nếu workflow được gửi mà không có runId (kể cả {}), hoặc cho các kích hoạt thủ công, gotoHuman sẽ tạo một runId và trả về dưới dạng workflowRunId cho các yêu cầu tiếp theo.
    • runName: Tên hiển thị tùy chọn cho lần chạy (có thể đặt hoặc cập nhật ở bất kỳ bước nào)
    • prevSteps: Mảng các reviewId từ các bước đánh giá gotoHuman trước đó (bỏ qua ở bước đầu tiên)
  • metadata: Dữ liệu bổ sung tùy chọn sẽ được bao gồm trong phản hồi webhook sau khi gửi mẫu đánh giá
  • assignToUsers: Danh sách email người dùng tùy chọn để giao việc đánh giá
• Trả về reviewId, reviewLink, và tùy chọn workflowRunId khi gotoHuman đã gán một lần chạy quy trình làm việc mới

Phát triển

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

Chạy cục bộ trong MCP Client (ví dụ: 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] Đối với Windows, đường dẫn args cần phải là C:\\<absolute-path>\\build\\index.js