gotoHuman

gotoHuman MCPサーバー

gotoHumanを使うと、AIエージェントやエージェント型ワークフローに人間による承認を簡単に追加できます。
カスタマイズ可能な承認UIを備えた、完全マネージドの非同期ヒューマン・イン・ザ・ループ・ワークフローです。
組み込みの認証、Webhook、通知、チーム機能、進化するトレーニングデータセットを利用できます。

MCPサーバーを使用して、AIワークフローから人間の承認をリクエストしたり、統合の支援に使用したりできます。

使用方法

npmで以下として利用可能です：

@gotohuman/mcp-server

Cursor / Claude などでのセットアップ

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

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

ツール

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（静的URLはgotoHumanのレビュータイプまたはエージェントに設定できます）
  • workflow: このレビューをマルチステップのエージェント型ワークフローにリンクする任意のオブジェクト：
    • runId: 複数のステップをリンクするための現在のワークフロー実行の一意のID
  • metadata: レビューテンプレート送信後にWebhookレスポンスに含まれる任意の追加データ
  • assignToUsers: レビューを割り当てる任意のユーザーメールアドレスのリスト
• 戻り値 reviewId と reviewLink

開発

# 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である必要があります