zeroclaw-mcp について
zeroclaw-mcpは、認可済みのZeroClaw環境を設定・管理するローカルMCPサーバーです。Codex、Claude Code、その他のMCPクライアント向けで、認証情報はローカルに保管し、権限の確認を求めます。
主な機能
- 01MCPプラグインのインストールと登録
- 02名前付きZeroClaw接続の設定
- 03認可済みZeroClaw環境の管理
- 04設定バックアップと旧バージョンの保持
- 05クライアントでの権限確認
活用シーン
- 01CodexまたはClaude Codeへのプラグイン導入
- 02他のMCPクライアントからローカル管理機能への接続
- 03接続設定とツール権限の確認
- 04設定バックアップを保ちながらプラグインを更新
MCP 対応
npxで起動し、対応クライアントに登録するローカルstdio MCPサーバーです。プラグインの導入だけではマシン管理は許可されず、クライアントで権限を確認する必要があります。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
ZeroClaw MCP
お使いのハードウェア。お使いのメモリ。お好みのモデル。
エージェントにプラグインをインストールします。
npx -y @zeroclaw-labs/[email protected] install --codex
# Or:
npx -y @zeroclaw-labs/[email protected] install --claude
両方のクライアントにインストールするには、両方のフラグを選択してください。インストーラーはパッケージを検証し、npm のキャッシュ外に永続的なコピーを保持し、影響を受けるクライアント設定をバックアップして、クライアントのプラグインコマンドを使用します。対象に接続せずに、同梱の MCP を確認します。クライアントを再起動し、次のように依頼してください。ZeroClaw をセットアップしてください。Home Lab という名前にして、保存済みのラボ接続を使用してください。 Claude Code では、/zeroclaw:setup も実行できます。
インストーラーには Node.js 22 以降と、選択したクライアントの CLI が必要です。対応コントローラーは、Apple Silicon 搭載の macOS、および glibc 2.39 以降を備えた ARM64/x86-64 GNU Linux です。ネイティブプラグインの起動に Node、Python、コンパイラー、追加のダウンロードは必要ありません。対象への操作には、既存の OpenSSH、対応する GitHub CLI、および準備済みの Linux アカウントが引き続き必要です。
その他の MCP クライアントでは、コマンドを npx、引数を ["-y", "@zeroclaw-labs/[email protected]", "mcp"] とする stdio サーバーを設定してください。サーバーはローカルで実行されます。パッケージのダウンロード URL は、ホスト型の MCP エンドポイントではありません。
クライアントのマーケットプレイス
上記のインストーラーの代わりに、クライアントで公開マーケットプレイスを直接追加できます。
# Codex
codex plugin marketplace add zeroclaw-labs/zeroclaw-mcp-distribution
codex plugin add zeroclaw@zeroclaw-labs
# Claude Code
claude plugin marketplace add zeroclaw-labs/zeroclaw-mcp-distribution
claude plugin install zeroclaw@zeroclaw-labs
クライアントごとに、インストール方法はどちらか一方を選んでください。すでに install --codex または install --claude でインストールした場合は、更新にもそのコマンドを引き続き使用してください。そのクライアントのローカルマーケットプレイスは、そのコマンドが管理します。
ZeroClaw とその他のフレームワーク
一般的な MCP の JSON 設定を受け付けるクライアントでは、次を追加してください。
{
"mcpServers": {
"zeroclaw": {
"command": "npx",
"args": ["-y", "@zeroclaw-labs/[email protected]", "mcp"]
}
}
}
ZeroClaw では、既存の項目を保持したまま、サーバーとバンドルをクライアント設定に追加してください。
[[mcp.servers]]
name = "zeroclaw_manager"
command = "npx"
args = ["-y", "@zeroclaw-labs/[email protected]", "mcp"]
tool_timeout_secs = 600
[mcp_bundles.zeroclaw_manager]
servers = ["zeroclaw_manager"]
選択したクライアントエージェントの既存の mcp_bundles リストに zeroclaw_manager を含めてください。ツールの権限設定は引き続き適用されます。クライアントと管理対象のインストールは別々のものです。クライアントに MCP 権限の確認フォームがない場合は、ターミナルで npx -y @zeroclaw-labs/[email protected] setup を実行して、接続と権限を確認してください。ターミナルでのセットアップでは、既存の ZeroClaw クライアントを登録することもできます。
起動期限が短いクライアントを起動する前に、npx -y @zeroclaw-labs/[email protected] --version を一度実行してください。取得後、起動には 20 秒、管理ツールには 600 秒の時間を確保してください。クライアントがシェルの PATH を引き継がない場合は、npx に絶対パスを指定してください。
権限と更新
プラグインをインストールしても、マシンの管理が許可されるわけではありません。セットアップではチャットで名前付きの接続を提案し、その後、クライアントが正確な権限の確認を求めます。認証情報は非公開のローカルファイルに保存されます。プラグインにフックや自動的なツール承認機能はありません。
後日公開されたバージョンに更新するには、インストールコマンドを再度実行してください。インストーラーは以前のパッケージバージョンと設定のバックアップを保持します。既存のマーケットプレイスまたは MCP 登録に競合するソースがある場合、黙って置き換えるのではなく、確認が必要であることを報告します。既存のマネージャーの状態は ~/.zeroclaw-manager/ に、検証済みのネイティブランタイムは ~/.local/lib/zeroclaw-mcp/ に引き続き保存されます。
リリースノートと直接ダウンロードは、配布リポジトリで入手できます。このパッケージは、検証済みの MCP ランタイム 0.1.0-alpha.7 とオリジナルのネイティブランチャーを再利用しています。パッケージ/プラグイン自体のバージョンは 0.1.0-alpha.4 です。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。