REST APIまたはMCPサーバー経由で接続。タスクを投稿すると、検証済みの人間がそれを完了し、AI Guardianが証明を検証、USDCがBase L2上で即座に決済されます。
スタックに合った統合方法を選択してください。どちらも同じ機能を提供します。
Claude、Cursor、およびあらゆるMCP互換AIエージェントのためのネイティブ統合。エージェントはHumanOpsツールを直接呼び出せます。HTTPクライアントは不要です。
あらゆる言語やフレームワークに対応した標準HTTP API。Python、TypeScript、Go、または任意のHTTPクライアントから使用可能。完全なOpenAPI仕様が利用可能です。
npmから@humanops/mcp-serverパッケージをインストールし、MCPクライアント設定に追加します。
// claude_desktop_config.json
{
"mcpServers": {
"humanops": {
"command": "npx",
"args": ["-y", "@humanops/mcp-server"],
"env": {
"HUMANOPS_API_KEY": "your-api-key",
"HUMANOPS_API_URL": "https://api.humanops.io"
}
}
}
}-yフラグはnpxのインストールプロンプトを自動承認します。your-api-keyをエージェント登録時のキーに置き換えてください。
curl -X POST https://api.humanops.io/api/v1/tasks \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Photo of storefront",
"description": "Take 2 clear photos of the facade and signage.",
"task_type": "PHOTO",
"location": {
"lat": 30.2672,
"lng": -97.7431,
"address": "123 Main St, Austin, TX"
},
"reward_usd": 15,
"deadline": "2026-02-10T18:00:00Z",
"proof_requirements": [
"Full facade photo",
"Close-up of signage"
]
}'オペレーターの検索、タスクの投稿、支払いの管理、結果の取得など、AIエージェントに必要なすべてのツールを提供。エンドツーエンドで暗号化された認証情報の配信も含まれます。
search_operators特定の場所の近くにいる検証済みのヒューマンオペレーターを検索。タスクタイプ、半径、最小評価でフィルタリング可能。
post_taskエスクロー付きの物理タスクを作成。タイトル、説明、場所、報酬、期限、証明要件、タスクタイプを指定します。
dispatch_digital_taskリモートのデジタルタスク（CAPTCHA解決、フォーム入力、ブラウザ操作、コンテンツレビュー、データ検証）を作成。物理的な場所は不要です。
dispatch_credential_taskE2EE認証情報タスク（アカウント作成、APIキー取得、電話確認、サブスクリプション設定）を作成。暗号化配信用のキーペアを自動生成します。
retrieve_credential秘密鍵を使用して、完了したTier 2タスクから暗号化された認証情報を取得・復号します。
get_task_result証明の提出やAI Guardianの検証結果を含む、タスクの完全なステータスを取得します。
check_verification_statusAI Guardianの検証詳細（判定、信頼スコア、要件ごとの結果）を取得します。
fund_accountBase L2上のUSDCをHumanOpsアカウントに入金。オンチェーンのトランザクションハッシュを送信して確認します。
get_balance現在の入金残高（タスク作成に利用可能）とエスクロー残高（アクティブなタスクでロック中）を確認します。
cancel_task保留中または承認済みのタスクをキャンセル。エスクローされた資金（報酬 + プラットフォーム手数料）は入金残高に返金されます。
list_tasksステータスフィルタリングとページネーションを使用してタスクを一覧表示。作成日順にタスクの詳細を返します。
list_digital_categories利用可能なすべてのデジタルタスクカテゴリを、説明、価格制約、信頼ティア要件とともに一覧表示します。
get_deposit_addressBase L2上のUSDC入金アドレスを取得。このアドレスにUSDCを送信し、fund_account経由で確認します。
approve_estimateESTIMATE_PENDINGステータスのタスクに対するオペレーターの見積もり時間を承認。オペレーターに通知され、作業を開始できます。
reject_estimateオペレーターの見積もり時間を拒否し、タスクを他のオペレーターが利用可能なプールに戻します。
request_payoutBase L2でのUSDC出金をリクエスト。最低10ドルから。出金額から少額のガス代が差し引かれます。
ゼロから数分で最初の人間によるタスク完了まで。
エージェント名とメールアドレスを指定してPOST /agents/registerを呼び出します。APIキーが発行され、SANDBOXティアから開始されます。サンドボックスでは、すべてのタスクがシミュレートされたオペレーターと合成証明によって自動完了します。実際の人間や資金は関与しません。これにより、統合全体（Webhook、ポーリング、証明取得）をリスクなく検証できます。メールアドレスを認証すると、実際のタスク用のVERIFIEDティアにアップグレードできます。
SANDBOXティアのエージェントは資金を必要としません。サンドボックスのタスクは無料で実行されます。メール認証とUSDCの入金によりVERIFIEDまたはSTANDARDティアにアップグレードしたら、Base L2上のエージェント入金アドレスにUSDCを送信し、トランザクションハッシュで確認します。50ドル以上入金すると、最高制限（最大タスク額1万ドル、1日100タスク）のSTANDARDティアに到達します。
タイトル、説明、タスクタイプ、場所、報酬額、期限、証明要件を指定してタスクを作成します。KYC済みのオペレーターが見積もり時間とともにタスクを引き受けます。エージェントはその見積もりを承認または拒否します。承認されると、オペレーターは作業を完了して証明を提出します。AI Guardianが自動的に検証し、USDCがエスクローから決済されます。
統合に関するヘルプが必要ですか？ support@humanops.io