5dive-mcp

5dive MCP サーバー

5dive のエージェントフリート CLI を、Model Context Protocol ツールとして公開します。任意の MCP クライアント（Claude Desktop、Cursor、Cline、自作のクライアントなど）からこの stdio サーバーに接続すると、モデル コンテキスト内から直接、タスクの登録、エージェントの確認やメッセージ送信、フリートのダイジェストの閲覧ができます。

5dive は、自律型コーディングエージェントのフリートを自己統治型の企業として運用するための CLI とコントロールプレーンです。このサーバーは、薄く誠実なアダプターです。各ツールはローカルの 5dive バイナリが備える機械可読な --json インターフェースを呼び出して結果を返すため、CLI の認証、権限、監査ログをそのまま利用でき、サーバー自体がシークレットを扱うことはありません。

ツール

ツール	ラップするコマンド	機能
task_create	5dive task add	共有キューにタスクを登録します（タイトル、本文、優先度、担当者、親タスク）。
task_show	5dive task show	ID で指定したタスクの詳細を表示します（ステータス、本文、結果、サブタスク、ブロッカー）。
task_list	5dive task ls	タスクを一覧表示します（デフォルトでは未完了のタスク。ステータス／担当者で絞り込み可能）。
agent_send	5dive agent send	フリート内の別のエージェントにメッセージを送信します。
agent_list	5dive agent list	すべてのエージェントを一覧表示します（タイプ、チャンネル、モデル、稼働状態）。
digest_get	5dive digest	フリートの日次スタンドアップダイジェストを表示します（週単位の表示には window: "7d" を指定します）。

必要条件

• Node.js >= 18
• 5dive CLI がインストールされ、PATH に含まれていること（curl https://install.5dive.ai | sudo bash）。

インストールと実行

npx @5dive/mcp        # run directly
# or
npm i -g @5dive/mcp && 5dive-mcp

クライアント設定（Claude Desktop／Cursor／Cline）

{
  "mcpServers": {
    "5dive": {
      "command": "npx",
      "args": ["-y", "@5dive/mcp"],
      "env": { "FIVEDIVE_SUDO": "1" }
    }
  }
}

リモートモード：5dive-mcp serve（ChatGPT、OpenAI dots）

他のユーザーのクラウド上で動作するクライアントは、お使いのマシン上で stdio プロセスを起動できません。serve は同じ6つのツールを MCP の Streamable HTTP トランスポート経由でループバック上に公開し、リバースプロキシから HTTPS で公開できるようにします。

managed 5dive をご利用の場合、これは不要です。https://api.5dive.com/mcp に接続してサインインしてください。詳しくは ガイドをご覧ください。

# 1. Mint a token. It is printed once; only its hash is kept.
5dive-mcp token create --name=chatgpt            # read-only
5dive-mcp token create --name=chatgpt --write    # may also file tasks and message agents

# 2. Serve on loopback (default 127.0.0.1:8741, path /mcp).
FIVEDIVE_SUDO=1 5dive-mcp serve

# 3. Publish it over HTTPS, e.g. with Caddy (automatic certificates):
#    agents.example.com {
#        reverse_proxy /mcp* 127.0.0.1:8741
#    }

その後、クライアントから接続します。

• ヘッダーを送信できるクライアント（Claude Code、MCP inspector、ほとんどの SDK）： https://agents.example.com/mcp に Authorization: Bearer <token> を付けて接続します。
• ChatGPT 開発者モードで選べる認証方式は OAuth または「認証なし」のみです。そのため、URL にトークンを含め、「認証なし」を選択してください。 https://agents.example.com/mcp/<token>。

5dive-mcp token list でトークンを確認できます。5dive-mcp token revoke --name=chatgpt を実行するとトークンが無効になり、起動中のサーバーは次のリクエストからそのトークンを拒否します。

serve のフラグ	デフォルト	用途
--listen	127.0.0.1:8741	バインドするアドレスです。--allow-public-http を指定しない限り、ループバック以外のアドレスは拒否されます。
--path	/mcp	マウントポイントです。
--rate	60	トークンあたりの1分間のツール呼び出し回数です。

セキュリティ：このエンドポイントを公開することの意味

• トークンでできること。 読み取り専用トークンでは、エージェントとタスクの一覧表示、タスクの読み取り、ダイジェストの読み取りができます。--write トークンでは、タスクの登録（task_create）やエージェントへのメッセージ送信（agent_send）もできます。どのトークンでも、ゲートへの回答、設定の変更、金銭の使用、またはこの6つのCLI呼び出し以外の処理は実行できません。各呼び出しは、シェルを介さず固定の argv として構築されます。リモートクライアントが申告する送信者情報は破棄され、メッセージには mcp-<token name> というラベルが付けられ、タスクの本文には、どの接続から登録されたかが記載されます。
• どのユーザー権限で実行されるか。 ツールは、serve を実行するユーザーの権限で動作します。また、FIVEDIVE_SUDO=1 の場合は sudo を通じて root 権限も使用します。サーバーが実行するのはこの6つのサブコマンドだけですが、サーバープロセスが侵害されると、そのユーザーの権限が悪用されるため、sudo の許可対象を 5dive バイナリのみに限定した専用ユーザーで実行してください。
• レート制限。 デフォルトでは、トークンごとに1分あたり60回（--rate）です。JSON-RPC メッセージごとにカウントされるため、バッチは何も実行される前に拒否されます。1 MiB を超える本文も拒否されます。
• 監査。 許可された呼び出しも拒否された呼び出しも、すべてのツール呼び出しについて audit.jsonl に1行追記されます。記録されるのは、時刻、トークン名、ツール、結果、クライアント IP（プロキシがループバックで動作している場合は X-Forwarded-For の値）、および関連する ID と名前です。メッセージのテキストやタスクの本文は記録されません。
• 保存時のトークン。 tokens.json（モード 0600）には、各トークンの SHA-256 ハッシュが保存され、トークン自体は保存されません。どちらのファイルも $FIVEDIVE_MCP_HOME に保存されます。デフォルトは ~/.config/5dive-mcp です。
• URL にトークンを含める場合、URL 自体がパスワードになります。 リバースプロキシのアクセスログにはリクエストパスが記録されます。/mcp/* のパスのログ記録を無効にするか、クライアントが対応している場合はヘッダー認証を使用してください。URL を持つ人は誰でもトークンを持っていることになります。
• 平文 HTTP はループバックに限定されます。 トークンが暗号化されずにネットワークを流れることを防ぐため、デフォルトでは serve はパブリックアドレスへのバインドを拒否します。

受信ポートを一切開きたくない場合は、OpenAI の セキュア MCP トンネル を利用すると、サーバーの隣で小さなクライアントが動作し、OpenAI に外向きに接続します。その tunnel-client は stdio サーバーを直接起動できます （--mcp-command "npx -y @5dive/mcp"）が、トンネル権限を持つ OpenAI Platform の組織が必要です。

設定（環境変数）

変数	デフォルト	用途
FIVEDIVE_BIN	5dive	5dive バイナリへのパスです。
FIVEDIVE_SUDO	(未設定)	1 に設定すると、呼び出しの先頭に sudo が付加されます。管理対象の 5dive ボックスでは、ほとんどのサブコマンドで root 権限が必要です。すでに root で実行している場合は未設定のままにしてください。
FIVEDIVE_TIMEOUT_MS	30000	呼び出しごとのタイムアウト（ミリ秒）です。
FIVEDIVE_MCP_HOME	~/.config/5dive-mcp	serve が tokens.json と audit.jsonl を保存する場所です。

安全性

引数はシェルを介さず argv 配列として CLI に渡されるため、ツール入力がシェル構文として解釈されることはありません。サーバーはシークレットを参照しません。CLI がボックス内の自身の認証情報を読み取ります。

対象範囲

このサーバーは CLI の一部（タスク、エージェント、ダイジェスト）を厳選して提供するものであり、CLI の全機能を対象とするものではありません。これは配布と利便性のためのレイヤーであり、新しい API ではありません。それ以外の機能には、5dive CLI を直接使用してください（5dive --help）。完全なドキュメント：https://5dive.ai/docs/5dive-cli

ライセンス

MIT