gotoHuman

公式

ヒューマンインザループプラットフォーム - AIエージェントや自動化がgotoHumanの受信箱に承認リクエストを送信できるようにします。

GitHub

Goto Human MCPで何ができますか？

利用可能なレビューテンプレートの一覧表示 — list-forms を使用してアカウント内のすべてのレビューテンプレートを取得し、そのIDとフィールドの概要を確認します。
レビューテンプレートのスキーマを取得 — get-form-schema を使用して、レビューを送信するために必要な正確なフィールド構造と設定を取得します。
人間によるレビューを依頼 — request-human-review-with-form を使用してAI生成コンテンツを承認用に送信し、必要に応じてレビュー担当者を割り当てたり、複数ステップのワークフロー実行にステップをリンクしたりします。
レビューをワークフローに連鎖 — runId と prevSteps を含む workflow オブジェクトを渡すことで、複数の人間によるレビューステップを単一の追跡可能な実行に接続します。

ドキュメント

gotoHuman MCP Server

gotoHuman は、AI エージェントやエージェントワークフローに人間による承認を簡単に追加できるようにします。
カスタマイズ可能な承認 UI を備えた、完全マネージド型の非同期 human-in-the-loop ワークフローです。
組み込みの認証、Webhook、通知、チーム機能、そして進化するトレーニングデータセットをご活用いただけます。

MCP サーバーを使用して、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"
      }
    }
  }
}

API キーを取得し、app.gotohuman.com で承認ステップを設定してください。

デモ

左側は 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 を使用します。runId なしで workflow が送信された場合（{} であっても）、または手動トリガーの場合、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 である必要があります。