three.ws Autopilot

@three-ws/autopilot-mcp

AI エージェント専用の自律実行コントロールプレーンです。オートパイロットのスコープ、1 日あたりの SOL 支出上限、自動実行を設定して、提案 → 実行 → 元に戻すのループを、あらゆる MCP クライアントから実行できます。

---

stdio 経由で AI エージェントに独自の実行コントロールプレーンを提供する、Model Context Protocol サーバーです。エージェントは、操作可能な範囲（機能スコープ、1 日あたりの SOL 支出上限、自動実行と確認のポリシー）を設定し、提案 → レビュー → 実行 → 元に戻すの一連のループを進めます。人間が介在しなくても、すべての境界はサーバー側で適用されます。スコープ外または予算超過の操作は拒否され、実行されません。

これは、自律型エージェントのビジョンを支える要となる機能です。オートパイロットの設定と実行は、これまで three.ws の UI/API 内でしか利用できませんでした。このサーバーによってエージェント自身がガードレールを管理し、その範囲内で操作できるようになります。

⚠️ このサーバーは認証が必要で、書き込み操作が中心です。 execute_proposal は Solana メインネット上で実際の SOLを移動でき、その操作は取り消せません。送信するのはネイティブ SOL のみです。エージェントが $THREE を売却または送信することはありません（購入、保有、またはバーンのみ可能です）。スコープ、1 日あたりの SOL 支出上限、確認はすべて three.ws バックエンドで適用されるため、このサーバーで回避することはできません。

インストール

npm install @three-ws/autopilot-mcp

または、npx で実行できます（インストール不要）。

npx @three-ws/autopilot-mcp

クイックスタート

Claude Code では、1 行で設定できます（three.ws の認証情報を指定してください）。

THREE_WS_API_KEY=sk_live_… claude mcp add autopilot -- npx -y @three-ws/autopilot-mcp

Claude Desktop / Cursor の場合（claude_desktop_config.json または mcp.json）：

{
	"mcpServers": {
		"autopilot": {
			"command": "npx",
			"args": ["-y", "@three-ws/autopilot-mcp"],
			"env": {
				"THREE_WS_API_KEY": "sk_live_…"
			}
		}
	}
}

MCP Inspector で機能を確認できます。

THREE_WS_API_KEY=sk_live_… npx -y @modelcontextprotocol/inspector npx @three-ws/autopilot-mcp

認証

すべてのオートパイロットエンドポイントはオーナー専用のため、このサーバーには認証が必要です。エージェントのオーナーの three.ws 認証情報（three.ws の API キー（sk_live_… / sk_test_…）または OAuth アクセストークン）を THREE_WS_API_KEY に設定してください。各リクエストで Authorization: Bearer … として送信され、所有ユーザーが特定されます。エージェントが管理できるのは、そのユーザーが所有するエージェントのみです。この認証情報によって execute_proposal 経由で実際の SOL の送金が可能になるため、パスワードと同様に安全に保管してください。THREE_WS_TOKEN と THREE_WS_BEARER もエイリアスとして使用できます。

ツール

ツール	種類	説明
get_autopilot_config	読み取り専用	エージェントのガードレールを読み取ります。有効化状態、スコープ、自動実行、1 日あたりの SOL 上限、確認ポリシーに加え、信頼度も確認できます。
set_autopilot_config	書き込み・冪等	部分的なパッチでガードレールを更新します（スコープの許可、1 日あたりの SOL 上限の設定、有効化／無効化）。アクションは実行されません。
generate_proposals	書き込み	エージェントの思考を実行し、重要度の高い記憶と振り返りから、出典を明記した実際の候補アクションを生成します。
list_proposals	読み取り専用	提案キューを表示します。ID、種類、理由、パラメーター、ステータス、引用元を確認できます。ステータスで絞り込めます。
dryrun_proposal	読み取り専用	提案を実行した場合の処理（スコープ／上限／残高の確認）を、アクションを実行せずにプレビューします。
adjust_proposal	書き込み・冪等	実行前に保留中の提案のパラメーターを編集します（しきい値、金額、頻度の調整）。サーバー側で検証されます。
execute_proposal	書き込み・破壊的	実際のアクションを実行します。⚠️ wallet_transfer はメインネット上で実際の SOL を移動し、取り消せません。confirm:true が必要です。$THREE は送信されません。
dismiss_proposal	書き込み	保留中の提案を破棄し、エージェントが以後その提案を行わないよう、フィードバックの記憶を記録します。
undo_action	書き込み	取り消し可能な実行を元に戻します（アラートルール／ブリーフィングを削除）。フィードバックの記憶を記録します。SOL の送金は取り消せません。
list_autopilot_activity	読み取り専用	追記専用の署名付きレシートログを表示します。すべての自律的なアクション、その結果、出典、署名を確認できます。
compute_trust	読み取り専用	実際のアクション履歴に基づいて算出される、エージェントが獲得した信頼レベル（sandbox → trusted → autonomous）を表示します。

5 つの読み取りツールはライブ状態を反映するため（提案、レシート、信頼度は呼び出しごとに変化します）、いずれも冪等ではありません。set_autopilot_config と adjust_proposal は冪等な書き込みです（同じ値を再適用しても何も起こりません）。generate_proposals、execute_proposal、dismiss_proposal、undo_action はそれぞれ実際のアクションを実行します。

入力パラメーター

list_autopilot_activity を除くすべてのツールで agentId（所有するエージェントの UUID）が必要です。list_autopilot_activity では省略可能で、省略すると所有するすべてのエージェントのデータが集計されます。

• get_autopilot_config ／ compute_trust ／ generate_proposals — agentId。
• set_autopilot_config — agentId に加えて、次のいずれか：enabled（bool）、scopes（{ create_alert?, briefing?, wallet_transfer? }）、autoExecute（{ create_alert?, briefing? }）、dailySpendSol（数値、SOL。0 にすると支出を無効化）、requireConfirm（bool）。
• list_proposals — agentId、status（pending | executed | dismissed | undone | failed）、limit（1–200）。
• dryrun_proposal ／ dismiss_proposal ／ undo_action — agentId、proposalId。
• adjust_proposal — agentId、proposalId、params（提案の種類に対応するパラメーター一式）。
• execute_proposal — agentId、proposalId、confirm（bool。取り消せない SOL の送金には必須）。
• list_autopilot_activity — agentId（省略可能）、limit（1–200）、cursor（前回の next_cursor の値）。

ループ

// 1. Grant the agent a reversible capability
// set_autopilot_config
> { "agentId": "…", "enabled": true, "scopes": { "create_alert": true } }
{ "ok": true, "config": { "enabled": true, "scopes": { "create_alert": true, "briefing": false, "wallet_transfer": false }, "daily_spend_sol": 0, "require_confirm": true } }

// 2. Let the agent propose actions from its memory
// generate_proposals
> { "agentId": "…" }
{ "ok": true, "createdCount": 1, "source": "memory",
  "created": [ { "id": "p_…", "kind": "create_alert", "title": "Alert when $THREE crosses $0.01",
                 "rationale": "You noted interest in $THREE around $0.01 — I'll watch it.", "status": "pending" } ] }

// 3. Preview before acting
// dryrun_proposal
> { "agentId": "…", "proposalId": "p_…" }
{ "ok": true, "preview": { "kind": "create_alert", "willDo": "Create a real alert rule… Reversible.",
                           "checks": [ { "label": "Scope \"create_alert\" granted", "ok": true } ], "blocked": false } }

// 4. Execute for real (reversible kind — no confirm needed)
// execute_proposal
> { "agentId": "…", "proposalId": "p_…" }
{ "ok": true, "receipt": "Created a price above alert.", "actionId": "1843", "proposal": { "status": "executed" } }

// 5. Changed your mind? Undo it.
// undo_action
> { "agentId": "…", "proposalId": "p_…" }
{ "ok": true, "proposal": { "status": "undone" } }

実際の SOL を支出するには、所有者が scopes.wallet_transfer を許可し、正の値の dailySpendSol を設定する必要があります。また、事前承認されていない場合は、execute_proposal を confirm:true を指定して再度呼び出す必要があります。これら 3 項目はすべてサーバー側で確認されます。エージェントが支出するのは SOL のみで、$THREE を売却したり送信したりすることはありません。

要件

• Node.js >= 20。
• エージェントの所有者用の three.ws 認証情報（THREE_WS_API_KEY）。
• https://three.ws（または独自の THREE_WS_BASE）へのネットワークアクセス。

環境変数

変数	必須	デフォルト	備考
THREE_WS_API_KEY	はい	—	three.ws API キー（sk_live_…）または OAuth アクセストークン。シークレットです。実際の SOL を移動できます。
THREE_WS_BASE	いいえ	https://three.ws	セルフホスト時、またはプレビューを対象とする場合にのみ上書きしてください。
THREE_WS_TIMEOUT_MS	いいえ	60000	リクエストごとのタイムアウト（生成時にサーバー側で LLM 処理を実行します）。

リンク

• ホームページ：https://three.ws
• 変更履歴：https://three.ws/changelog
• 課題：https://github.com/nirholas/three.ws/issues
• ライセンス：Apache-2.0。詳細は LICENSE をご覧ください。

---

_{three.ws SDK スイートの一部です — 3D AI エージェント、オンチェーン ID、エージェントによる支払い。
ウェブサイト · 変更履歴 · GitHub}