AIAI開発横丁AI Dev Yokocho
メニュー
Search the alley

記事を検索

2文字以上でタイトル・カテゴリ・タグを検索できます。

ZCodeのMCP・AGENTS.md・Subagentsを整理：外部ツール連携を安全に始める前に

ZCodeでMCP、AGENTS.md、Subagentsを使う前に、設定場所、Claude CodeやCodex CLIからのMCP import、安全な権限分離を整理します。

公開 2026.07.05 / 更新 2026.07.05

この記事のポイント

  • ZCodeは~/.zcode/AGENTS.mdとworkspace AGENTS.mdを読み、workspace側を現在taskの主要なproject sourceとして扱う
  • CLAUDE.mdは継続的に読むのではなく、Claude Code projectのonboarding時の移行元として扱われる
  • MCPやSubagentsは能力拡張であり、安全装置ではないため、read-only / writableを分ける

ZCodeのAGENTS.md

sourcepath / lookup使いどころ注意点
User global~/.zcode/AGENTS.md全project共通の好み、禁止操作、報告形式個別repoの細かいルールを詰め込みすぎない
Workspace現在workspaceのAGENTS.mdproject固有の構成、build/check、禁止操作workspace側が現在taskの主要なproject sourceになる
CLAUDE.md既存Claude Code projectの移行元onboarding時にAGENTS.mdへ移す材料毎回継続的に読むとは書かない

MCP Serversと外部Agentからのimport

ZCodeのMCP Serversでは、手動追加したconfigured MCP serversとplugin由来のMCP serversを分けて管理します。公式docsでは、Claude Code、Codex CLI、OpenCodeなど外部Agentの設定ファイルをscanし、importできると説明されています。

  • import前にserver名、transport、command、読み書き範囲を見る
  • globalとworkspaceのimport scopeを分ける
  • 有効化されたMCP serverをそのまま信頼しない
  • APIキーや認証情報を扱うserverは、ZCode側の権限モードとも合わせて確認する

Subagentsは分離された作業文脈として見る

Subagent公式説明の要点向く作業安全上の注意
general-purpose幅広いtask向け。read/edit/commandも扱える小さなfeature、整理、検証権限が広い前提で扱う
Exploreread-only researchやevidence gathering向け調査、call-chain把握、仕様確認最初の調査はこちらを優先
custom subagentsuser-level subagentsをSettingsから定義繰り返す専門作業betaや提供範囲は公式表示を確認

よくある質問

ZCodeはAGENTS.mdを読みますか？

はい。2026年7月5日時点の公式docsでは、~/.zcode/AGENTS.mdと現在workspaceのAGENTS.mdを読むと説明されています。

CLAUDE.mdも毎回読まれますか？

いいえ。公式docsでは、CLAUDE.mdはClaude Code projectのonboarding時の一度限りの移行元として扱われ、将来のrunはAGENTS.mdを使うと説明されています。

MCP importは安全ですか？

便利ですが安全装置ではありません。外部Agentの設定を取り込む前に、command、認証情報、読み書き権限、global/workspace scopeを確認します。

Subagentsを使えば安全に分業できますか？

文脈分離には役立ちますが、general-purposeは広いtool accessを持つため、read-only調査はExploreを優先するなど権限を分けます。

関連記事