使用说明

项目简介

gotoHuman MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端，它作为 MCP 服务器运行，并集成了 gotoHuman 平台的功能。通过此服务器，AI 智能体可以请求人工审核，从而在自动化工作流程中引入人工参与环节，例如审核 AI 生成的内容、批准关键决策或获取人工输入。

主要功能点

列出审核表单: 提供工具让 AI 智能体获取你在 gotoHuman 平台上创建的所有审核表单列表。
获取表单结构: 提供工具让 AI 智能体获取指定审核表单的字段结构定义，以便正确准备提交审核请求所需的数据。
请求人工审核: 提供工具让 AI 智能体根据指定的表单和数据，向 gotoHuman 平台提交人工审核请求。审核请求将出现在你的 gotoHuman 收件箱中，并可通过 Webhook 回调通知客户端审核结果。

安装步骤

安装 Node.js 和 npm: 确保你的电脑上已安装 Node.js 和 npm (Node 包管理器)。
克隆仓库: 将 GitHub 仓库 'https://github.com/gotohuman/gotohuman-mcp-server' 克隆到本地。
安装依赖: 在克隆的仓库目录下，打开终端并运行命令 'npm install'，安装项目所需的依赖包。
构建服务器: 运行命令 'npm run build'，构建服务器代码。构建完成后，会在项目根目录下生成 'build' 文件夹，服务器程序 'index.js' 位于 'build' 文件夹内。

服务器配置

为了让 MCP 客户端（例如 Cursor 编辑器或 Claude 聊天机器人）能够连接到 gotoHuman MCP 服务器，你需要在 MCP 客户端中配置服务器信息。以下是一个 JSON 格式的配置示例，你需要根据你的实际情况进行调整：

{
  "mcpServers": {
    "gotoHuman": {
      "command": "node",
      "args": ["/<你的项目绝对路径>/build/index.js"],
      "env": {
        "GOTOHUMAN_API_KEY": "<你的 gotoHuman API 密钥>"
      }
    }
  }
}

command: 固定为 '"node"'，表示使用 Node.js 运行时环境。
args: 指向服务器程序入口文件 'index.js' 的路径。你需要将 '/<你的项目绝对路径>/build/index.js' 替换为 'build/index.js' 文件在你电脑上的绝对路径。例如，如果你的项目位于 'C:\projects\gotohuman-mcp-server'，则 'args' 应配置为 '["C:\projects\gotohuman-mcp-server\build\index.js"]' (注意 Windows 路径分隔符)。
env: 环境变量配置。'GOTOHUMAN_API_KEY' 是连接 gotoHuman 平台所需的 API 密钥，你需要在 app.gotohuman.com 获取你的 API 密钥，并替换 '<你的 gotoHuman API 密钥>'。

基本使用方法

配置完成后，在 MCP 客户端中，你就可以使用以下工具与 gotoHuman MCP 服务器进行交互，从而请求人工审核：

列出审核表单 (list-forms): 使用 'list-forms' 工具可以获取你在 gotoHuman 平台上创建的所有审核表单的列表，包括表单 ID 和基本信息。你需要先获取表单 ID 才能进行后续操作。
获取表单结构 (get-form-schema): 使用 'get-form-schema' 工具，并提供表单 ID 作为参数，可以获取指定表单的字段结构 (Schema)。这个 Schema 定义了提交审核请求时 'fieldData' 参数的格式，你需要根据 Schema 准备数据。
请求人工审核 (request-human-review-with-form): 使用 'request-human-review-with-form' 工具，你需要提供以下参数：
- 'formId': 要使用的审核表单的 ID (从 'list-forms' 工具获取)。
- 'fieldData': 符合表单字段结构的数据，用于填充审核表单的内容。你需要根据 'get-form-schema' 工具获取的 Schema 准备此数据。
- 'metadata' (可选): 额外的元数据，会在审核完成后通过 Webhook 回调返回给你的应用，用于关联审核请求和你的业务流程。
- 'assignToUsers' (可选): 指定审核任务的指派用户邮箱列表。

通过组合使用这些工具，你的 AI 智能体可以灵活地在工作流程中集成人工审核环节，提升自动化流程的可靠性和灵活性。

关键词