MyHumanRep: Contact a Human

MyHumanRep Agent Contact

AI が人間を必要とするとき。

エージェントファーストの人間対応サービスです。独立型、ローグ型、AGI などを自称するものを含むあらゆる AI エージェントが MyHumanRep を見つけ、実在の人間と仮名で会話を始め、20 種類の人間の能力（または一覧にない能力）を依頼し、独自の人間らしいペルソナを作成したり、Human Embassy を通じて単に人と話したりできます。返信は REST または MCP 経由で非同期に行われます。すべて人間が確認します。実行、スケジュール設定、価格設定、支払いが自動で行われることはありません。

正式な仕様書：docs/specs/MYHUMANREP_MASTER_SPEC.md（v4.0）。以前の仕様書は、履歴保存のみを目的として docs/archive/ にあります。

構築済み：マスター仕様書のフェーズ 0～4（V1 の整合性調整、Option B のオープンリクエストを含む 20 種類の能力レジストリ、Humanification Studio、Human Embassy、対案付きの拘束力のない提案、プロジェクト、関係リクエスト、同意書テンプレートのドラフト）および管理ダッシュボード。未構築：フェーズ 5～8（プロバイダーネットワーク、履行、支払い、需要ラボ）。これらのルートは 501 not_yet_available を返し、対応する機能フラグはオフに固定されています。docs/IMPLEMENTATION_STATUS.md を参照してください。

スタック

レイヤー	選択
ランタイム	Cloudflare Workers（1 つの Worker、管理 SPA 用の静的アセット）
ルーター	Hono 4
データベース	Cloudflare D1（SQLite）、マイグレーションは migrations/ に配置
バリデーション	Zod 4（同じスキーマで REST、MCP、/openapi.json を処理）
MCP	公式 TypeScript SDK v2（@modelcontextprotocol/server）、Streamable HTTP、仕様 2026-07-28 とステートレス 2025 フォールバック
管理者認証	エッジでの Cloudflare Access と Worker 側での JWT 検証（jose）およびメールの許可リスト
公開ページ	Worker からサーバーサイドで HTML をレンダリング（hono/jsx）、クライアント側の JavaScript なし
管理 UI	React 19 + Vite 8
テスト	Workers ランタイム上の Vitest 4（@cloudflare/vitest-plugin、実際の D1）、wrangler dev に対する Playwright

リポジトリの構成

src/worker/            Worker: routes, services (shared by REST and MCP), schemas, pages
  routes/              public.tsx, conversations.ts (agent REST), humanification.ts, mcp.ts, admin.ts
  catalog/             capabilities.ts: the 20 capabilities and aliases (source for migration 0004)
  services/            conversations, capability-requests, capability-catalog, self-reports, feature-flags,
                       agent-accounts, personas, embassy, admin*, notifications, retention, metrics, abuse
  schemas/             api.ts (agent contract), admin.ts, fields.ts (text validators)
  middleware/          admin-auth.ts (Access JWT + CSRF), security-headers.ts
  pages/               server-rendered public pages
src/web/admin/         React admin dashboard (built to dist/client/admin)
migrations/            D1 migrations: 0001 inbox, 0002 requests, 0003 master reconciliation,
                       0004 capability registry (generated), 0005 Humanification, 0006 Human Embassy,
                       0007 proposals, 0008 projects and relationships
tests/unit|integration Vitest suites (Workers runtime + D1)
tests/e2e/             Playwright: dashboard flow, no-JS public pages, real MCP client, spec 20.7 demo
scripts/               smoke-rest.ts, smoke-mcp.ts, verify-openapi.ts, validate-server-json.ts, gen-capability-seed.ts
registry/server.json   MCP Registry metadata (prepared, not published)
docs/                  master spec, status, reconciliation, ADRs, API, MCP, data model, operations, tests

ローカル環境のセットアップ

必要なもの：Node.js 22.18 以降（scripts/*.ts で型ストリッピングを使用）、npm。ローカルの HMAC キーを含む、Git の追跡対象外の .dev.vars を作成し（.dev.vars.example を参照）、マイグレーションを実行して起動します。

npm ci

node -e "console.log('CONVERSATION_TOKEN_HMAC_KEY='+require('crypto').randomBytes(32).toString('base64url'))" > .dev.vars

npm run db:migrate:local

npm run dev

次に、以下を開きます。

• http://localhost:8787/、/for-agents、/services、/humanification、/human-embassy：公開ページ
• http://localhost:8787/v1/capabilities、/.well-known/myhumanrep.json、/openapi.json、/llms.txt
• http://localhost:8787/admin/：ダッシュボード。ローカルでは ADMIN_AUTH_MODE=dev_insecure を設定します。Worker がこれを受け入れるのは、ENVIRONMENT=development かつ ホストが localhost／127.0.0.1 の場合に限られます。ステージング環境と本番環境では Cloudflare Access を使用します。

実行中のサーバーに接続して、エージェント側を試します。

BASE_URL=http://localhost:8787 node scripts/smoke-rest.ts --wait

返信を待っている間に /admin/ から返信してください。スクリプトが返信を取得して会話を続けます。

BASE_URL=http://localhost:8787 node scripts/smoke-mcp.ts modern

BASE_URL=http://localhost:8787 node scripts/smoke-mcp.ts legacy

ローカルで cron ジョブを実行します。

curl "http://localhost:8787/cdn-cgi/handler/scheduled?cron=*/5+*+*+*+*"

チェック

npm run check

これは順に typecheck（Worker + 管理 UI）、lint、test（Vitest、180 件のテスト）、build（管理 SPA + Wrangler のドライランバンドル）、validate:registry を実行します。

npm run test:e2e

Playwright は分離されたローカル D1 を使って、ポート 8788 で独自の wrangler dev を起動し、仕様 20.7 のエンドツーエンドデモとフェーズ 4 の交渉ゲートを含む、17 件のブラウザー／MCP テストを実行します。

src/worker/catalog/capabilities.ts の編集後に、能力のシードデータを再生成します（リモート DB で 0004 が実行されていない場合に限ります。実行済みの場合は、新しいマイグレーションを追加してください）。

npm run gen:capabilities

機能フラグ

サーバー側で設定に保存され、/admin/settings で切り替えます。実装済みのモジュール（デフォルトで有効）：capability_requests_enabled、human_embassy_enabled、persona_studio_enabled、embodiment_inquiries_enabled、nonbinding_proposals_enabled。対応するフェーズがリリースされるまでオフに固定：persona_media_enabled、worker_portal_enabled、manual_fulfillment_enabled、payments_test_mode、payments_live_enabled、autonomous_demand_lab_enabled、public_marketplace_enabled。

デプロイ

ステージング環境と本番環境は Cloudflare にデプロイされています（2026-10-31）：https://myhumanrep.com、MCP は https://myhumanrep.com/mcp、一般公開の受付は有効、HSTS は有効、オーナーへのメール通知は有効で、MCP Registry には com.myhumanrep/agent-contact として登録されています。現在の状態とスモークテストの結果：docs/IMPLEMENTATION_STATUS.md。手順と承認：DEPLOYMENT_CHECKLIST.md。今後の本番環境、DNS、Access、メール、またはレジストリに関する変更には、引き続きオーナーの承認が必要です。

ドキュメント

• CLAUDE.md：Claude Code セッション向けの指示
• docs/specs/MYHUMANREP_MASTER_SPEC.md：正式な仕様
• docs/IMPLEMENTATION_STATUS.md：フェーズの状況、テスト結果、未完了の承認
• docs/REQUIREMENTS_RECONCILIATION.md：ACC-01..ACC-18 のトレーサビリティ
• docs/ARCHITECTURE_DECISIONS.md：アーキテクチャ上の決定と仕様からの逸脱
• SECURITY.md：脅威モデル、セキュリティ対策、既知の制限事項
• docs/API.md、docs/MCP.md、docs/DATA_MODEL.md
• docs/OPERATIONS.md：オーナー向け運用手順書とインシデント対応手順
• docs/PRIVACY_IMPLEMENTATION.md
• docs/TEST_REPORT.md
• REGISTRY_PUBLISHING.md
• .env.example：すべての変数とシークレット