エージェントが任意のMCPサーバーに接続されます。
Hoody AgentはプロダクションレディのModel Context Protocolクライアントを搭載しています。GitHub、Slack、Jira、カスタムAPI、または任意のMCP互換サーバーに接続でき、ツールはランタイムで発見され、エージェントの組み込み機能と統合されます。
ローカルstdio + リモートStreamableHTTP / SSE · 認証済みサーバーのOAuth · 破壊的操作には確認が必要
# Register an MCP server on your workspace
$ curl -X POST https://abc123-def456-workspaces-1.node-us-1.containers.hoody.com/api/v1/workspaces/{workspaceID}/mcp \
-H "Content-Type: application/json" \
-d '{ "name": "linear", "config": { "type": "remote", "url": "https://mcp.linear.app/sse" } }'
<< 200 OK
{ "linear": { "status": "needs_auth" } }— エージェントは起動時にすべての接続サーバーでlistTools()を呼び出します。新しいツールは次の推論ターンで表示されます。
POST1回。ツールが現れます。
エージェントはすべての接続MCPサーバーでlistTools()を呼び出します。サーバーが返すもの — ファイルシステム、Slackメッセージ、Jiraチケット、カスタムAPI — はすべて次の推論ステップのエージェントのネイティブHTTP機能と統合されます。
1. サーバーを登録
/api/v1/agent/mcp/serversに名前とenabledフラグをPOSTします。Hoodyが接続を解決して開始します。
2. ツールを発見
MCPクライアントがサーバーでlistTools()を呼び出します。スキーマは動的 — 事前に宣言されたマニフェストは不要です。
3. ネイティブツールと統合
発見されたツールはエージェントの組み込みツールセットに参加します。同じプロンプトがGitHubツール、ファイルシステムツール、エージェント自身のコンテナ制御ツールを叩けます。
4. 安全に実行
破壊的操作 — ファイル書き込み、外部API変更 — には明示的な確認が必要です。エージェントが状態をサイレントに破壊することはありません。
GET/api/v1/agent/mcp/servers
重要な4つの機能。
MCPクライアントはコンパクトですが意見があります。ツールサーフェスが拡大し続ける中でエージェントを信頼性の高い状態に保つために、すべての機能が存在します。
動的ツール発見
固定リストなし。エージェントは各接続サーバーに提供内容を問い合わせるため、何も再デプロイせずにツールカタログが進化します。
ローカル + リモートプロトコル
エージェントに隣接して動作するローカルサーバーにはstdio、ネットワーク越しのリモートサーバーにはStreamableHTTP + SSE。1つのクライアントで両方に対応。
OAuth認証
認証済みリモートサーバー向けの完全なOAuthフロー — GitHubのMCPサーバー、Google DriveのMCPサーバー、ユーザーIDでツールをゲートするあらゆるサービスに接続できます。
安全性優先の実行
破壊的なツールコールは実行前に確認が必要です。エージェントが一時停止してアクションを表示し、状態に触れる前に承認を待ちます。
任意のMCPクライアントが接続できます。
Hoody Agentは外部サーバーにMCPで話しかけます — サーバーURLまたはstdioコマンドをエージェントに入れるだけで、そのツールは次のターンであなたのものになります。公式MCPレジストリ、コミュニティカタログ、または独自の内部ツールを経由して接続します。
Claude Desktop
AnthropicのリファレンスMCPクライアント — サーバー設定を追加するとHoodyのツールがClaudeのツールピッカーに表示されます。
Cursor
完全なMCPサポート付きのAIネイティブIDE — 1つの設定でファイル、ターミナル、exec、すべてにアクセス。
Cline
VS Codeの自律コーディングエージェント — MCP経由でHoodyコンテナ全体の読み書きが可能。
Windsurf
CodiumのエージェントIDE — MCPツールがCascadeフローに直接参加します。
Continue.dev
オープンソースのAIコーディングアシスタント — MCP優先統合、自前モデル持ち込み可能。
Hoody Agent + DIY
同じプロトコルで独自のMCPクライアントを作成 — またはhoody-agentの組み込みクライアントを使用。
{
"mcpServers": {
"hoody": {
"url": "https://abc123-def456-workspaces-1.node-us-1.containers.hoody.com/mcp",
"auth": { "type": "oauth" }
}
}
}プロトコルはオープンです — 上記のすべてのクライアントが同じツールサーフェスに到達します。ベンダーアダプターは不要。
1つのツールコール、エンドツーエンド。
エージェントはツールを要求し、1つを選んで呼び出し、結果を読みます。4つのステップすべてがMCPプロトコルです。それ以外は何もありません。
発見
エージェントはすべての接続MCPサーバーでlistTools()を呼び出します。各サーバーはツールスキーマを返します — クライアント側のカタログ管理は不要です。
選択
モデルがツールの説明を推論し、現在のステップに合ったものを選択します。手動ルーティングロジックは不要です。
実行
コールはMCPメッセージとして送信されます。Hoodyのクライアントがトランスポート（stdio / HTTP / SSE）と認証を透過的に処理します。
反映
型付きJSONレスポンスが返ります。エージェントはそれを読んで続行 — 成功したツールコールは別の推論入力になります。
→ listTools()
← [ { name: "read_file", schema: {...} },
{ name: "write_file", schema: {...} },
{ name: "run_shell", schema: {...} }, ... ]
→ callTool("read_file", { path: "/hoody/storage/readme.md" })
← { content: "# Project readme\n\nSee ..." }
→ callTool("run_shell", { cmd: "pytest tests/" })
⟳ requires confirmation — destructive-op gate
← { exitCode: 0, stdout: "... 42 passed ..." }エージェントは破壊的操作をサイレントに実行しません。
MCP が公開するのは鋭利な道具です——ファイル書き込み、シェル実行、API の変更。Hoody のクライアントは 4 つのゲートを課し、エージェントに能力を与えつつ、大砲一式までは渡しません。
破壊的操作の確認
書き込み、削除、または外部副作用を実行するツールコールは明示的な承認のために一時停止されます。エージェントは明確なプロンプトを表示し、ユーザーが承認するかdiffを先に確認します。
リモートサーバーのOAuth
リモートMCPサーバーは完全なOAuthフロー経由で認証します — GitHub、Slack、Jira、IDゲート付きの任意のツール。トークンはサーバー上に保持され、エージェントが生のクレデンシャルを見ることはありません。
サーバーごとの許可リスト
すべてのMCPサーバーはPOST /agent/mcp/serversで明示的に登録されます。未承認のサーバーは接続できません。DELETEで失効させると、ツールは次のエージェントターンで消えます。
完全な監査証跡
すべてのツールコール（発見、実行、結果）はHoody Proxyを通じてログに記録されます。レビュー可能、エクスポート可能、改ざん防止。
MCPの世界に接続。
公式レジストリ、コミュニティ、または独自の内部ツールなど、任意のMCP互換サーバーが同じ方法で接続できます。サーバーURLまたはstdioコマンドをエージェントに追加すると、次のターンからそのツールが利用可能になります。
メッセージ、チャンネル、チームへのDM
チケット、スプリント、ステータス更新
公式リファレンスサーバー（ローカルファイル）
実際のDBへの読み取り専用クエリ
スクレイピングなしのWeb検索
ヘッドレスブラウザー自動化
すでに動作しているREST / gRPCサーフェスをMCPサーバーとして作成
今日から接続できる例。新しいMCPサーバーは毎週追加されています; このリストはHoody側でハードコードされていません。
POST1つでより多くのツールが使えます。
Hoody Agentコンテナを起動し、接続したいMCPサーバーをPOSTすると、次の推論ターンからライブになります。SDKのインストール、エージェントの再起動、追加インフラは不要です。
関連情報 — /platform/ai-gatewayでモデルレイヤー、/platform/control-planeでガバナンスAPI、/kit/agentでAgentランタイム。