docs(pages): sync restructured MCP guide to en and ja (#293)

Sync the reorganized zh/mcp.md into the English and Japanese versions:
remove the MCP client-side paragraph and the How it works section,
split Configuration into Adding/Removing subsections, drop the manual
JSON edit example, move env to the end of the code block and table, and
align dash spacing. Also fix a double-space typo in the zh version.

Author: lizhengfeng101

pages/src/content/docs/en/mcp.md

@@ -9,11 +9,6 @@ one or more external MCP servers, and the tools those servers expose
 become available to the review agent — right alongside the
 [built-in tools](../tools/) like `file_read` and `code_search`.
 
-This is the *client* side of MCP. OCR does **not** run as an MCP server
-that other agents call — see the note in
-[Integrations](../integrations/#what-about-mcp) for that direction. This
-page is about the opposite: giving OCR's own reviewer extra capabilities.
-
 ## When to use it
 
 Reach for an MCP server when the reviewer would benefit from context that
@@ -27,40 +22,11 @@ lives outside the diff:
   dependency checker as a tool the reviewer can invoke on demand.
 
 If all you need is a plain read of the repo, the built-in tools already
-cover it — MCP is for reaching *beyond* the checkout.
-
-## How it works
-
-- OCR connects to each configured server over the **stdio transport**: it
-  launches the server as a subprocess and speaks MCP over its
-  stdin/stdout.
-- The subprocess runs with its **working directory set to the repository
-  root**, and inherits OCR's environment plus any `env` you configure.
-- On startup OCR lists the server's tools and registers them into the same
-  tool registry the built-in tools use. Registered MCP tools are available
-  in **both the plan phase and the main task**.
-- Servers stay alive for the duration of the review and are shut down when
-  it finishes.
-
-If a server fails to start (or its `setup` command fails), OCR prints a
-warning and **continues the review without it** — a broken MCP server
-never blocks a review.
+cover it — MCP is for reaching beyond the checkout.
 
 ## Configuration
 
-MCP servers live under the `mcp_servers` key in your user config file
-(`~/.opencodereview/config.json`). Each entry is keyed by a name you
-choose and accepts these fields:
-
-| Field | Type | Required | Description |
-|---|---|---|---|
-| `command` | string | ✓ | Executable that starts the MCP server (e.g. `npx`, `uvx`, an absolute path). |
-| `args` | string array | | Arguments passed to `command`. |
-| `env` | string array | | Extra environment variables in `KEY=VALUE` form. |
-| `tools` | string array | | Allowlist of tool names to register. Empty = register every tool the server offers. |
-| `setup` | string | | Shell command run once before the server starts (e.g. install deps). Runs in the repo root with a 5-minute timeout. |
-
-### With the CLI
+#### Adding an MCP server
 
 The `ocr config set` command writes these fields non-interactively. Array
 fields (`args`, `env`, `tools`) take a JSON array string:
@@ -72,39 +38,33 @@ ocr config set mcp_servers.docs.command npx
 # Arguments
 ocr config set mcp_servers.docs.args '["-y", "@acme/docs-mcp-server"]'
 
-# Environment variables (KEY=VALUE entries)
-ocr config set mcp_servers.docs.env '["DOCS_TOKEN=secret", "DOCS_REGION=eu"]'
-
 # Restrict which tools are exposed to the reviewer
 ocr config set mcp_servers.docs.tools '["search_docs", "get_page"]'
 
 # A setup command to run before the server starts
 ocr config set mcp_servers.docs.setup "npm install -g @acme/docs-mcp-server"
+
+# Environment variables (KEY=VALUE entries)
+ocr config set mcp_servers.docs.env '["DOCS_TOKEN=secret", "DOCS_REGION=eu"]'
 ```
 
+#### Removing an MCP server
+
 Remove a server with `unset`:
 
 ```bash
 ocr config unset mcp_servers.docs
 ```
 
-### By hand
-
-The same configuration as JSON:
+MCP servers live under the `mcp_servers` key in your user config file (`~/.opencodereview/config.json`).
 
-```json
-{
-  "mcp_servers": {
-    "docs": {
-      "command": "npx",
-      "args": ["-y", "@acme/docs-mcp-server"],
-      "env": ["DOCS_TOKEN=secret", "DOCS_REGION=eu"],
-      "tools": ["search_docs", "get_page"],
-      "setup": "npm install -g @acme/docs-mcp-server"
-    }
-  }
-}
-```
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `command` | string | ✓ | Executable that starts the MCP server (e.g. `npx`, `uvx`, an absolute path). |
+| `args` | string array | | Arguments passed to `command`. |
+| `tools` | string array | | Allowlist of tool names to register. Empty = register every tool the server offers. |
+| `setup` | string | | Shell command run once before the server starts (e.g. install deps). Runs in the repo root with a 5-minute timeout. |
+| `env` | string array | | Extra environment variables in `KEY=VALUE` form. |
 
 ## Filtering tools
 

pages/src/content/docs/ja/mcp.md

@@ -9,54 +9,23 @@ OCR は **Model Context Protocol（MCP）クライアント**として動作で
 エージェントから利用できるようになり、`file_read` や `code_search` などの
 [組み込みツール](../tools/)と並んで使えます。
 
-これは MCP の**クライアント**側です。OCR は他のエージェントが呼び出す MCP server
-としては動作**しません**——その方向については[統合](../integrations/#mcp)の
-説明を参照してください。本ページはその逆、OCR 自身のレビュアーに能力を追加する話です。
-
 ## いつ使うか
 
 レビュアーが diff の外にあるコンテキストを必要とするときに MCP server を導入します：
 
-- **Issue / チケット参照**——リンクされた Jira / GitHub issue を取得させ、変更が
+- **Issue / チケット参照** —— リンクされた Jira / GitHub issue を取得させ、変更が
   述べられた要件に合致するか確認する。
-- **ドキュメント / ナレッジベース**——社内 API ドキュメントやコーディング規約を
+- **ドキュメント / ナレッジベース** —— 社内 API ドキュメントやコーディング規約を
   取り込み、コメントが実際のチームルールを引用できるようにする。
-- **カスタム解析**——linter、スキーマ検証器、依存関係チェッカーを、レビュアーが
+- **カスタム解析** —— linter、スキーマ検証器、依存関係チェッカーを、レビュアーが
   必要に応じて呼び出せるツールとして公開する。
 
-リポジトリを読むだけでよいなら組み込みツールで十分です——MCP は checkout の**外**に
+リポジトリを読むだけでよいなら組み込みツールで十分です —— MCP は checkout の外に
 到達するためのものです。
 
-## 仕組み
-
-- OCR は設定された各 server に **stdio トランスポート**で接続します：server を
-  サブプロセスとして起動し、その stdin/stdout 経由で MCP を話します。
-- サブプロセスは**作業ディレクトリをリポジトリのルート**に設定して実行され、OCR の
-  環境変数に加えて設定した `env` を継承します。
-- 起動時に OCR は server のツールを列挙し、組み込みツールが使うのと同じツール
-  レジストリに登録します。登録された MCP ツールは **plan フェーズと main task の
-  両方**で利用できます。
-- server はレビューの間ずっと稼働し続け、終了時にシャットダウンされます。
-
-server の起動に失敗した場合（または `setup` コマンドが失敗した場合）、OCR は警告を
-表示し、**それを使わずにレビューを続行**します——壊れた MCP server がレビューを
-ブロックすることはありません。
-
 ## 設定
 
-MCP server はユーザー設定ファイル（`~/.opencodereview/config.json`）の
-`mcp_servers` キーの下に置きます。各エントリは任意の名前を key とし、次の
-フィールドを受け付けます：
-
-| フィールド | 型 | 必須 | 説明 |
-|---|---|---|---|
-| `command` | string | ✓ | MCP server を起動する実行ファイル（`npx`、`uvx`、絶対パスなど）。 |
-| `args` | string 配列 | | `command` に渡す引数。 |
-| `env` | string 配列 | | 追加の環境変数、`KEY=VALUE` 形式。 |
-| `tools` | string 配列 | | 登録するツール名の許可リスト。空 = server が提供する全ツールを登録。 |
-| `setup` | string | | server 起動前に一度実行される shell コマンド（依存関係のインストールなど）。リポジトリのルートで実行、タイムアウト 5 分。 |
-
-### CLI を使う
+#### MCP server を追加する
 
 `ocr config set` コマンドはこれらのフィールドを非対話的に書き込みます。配列
 フィールド（`args`、`env`、`tools`）は JSON 配列文字列を受け取ります：
@@ -68,44 +37,38 @@ ocr config set mcp_servers.docs.command npx
 # 引数
 ocr config set mcp_servers.docs.args '["-y", "@acme/docs-mcp-server"]'
 
-# 環境変数（KEY=VALUE エントリ）
-ocr config set mcp_servers.docs.env '["DOCS_TOKEN=secret", "DOCS_REGION=eu"]'
-
 # レビュアーに公開するツールを制限
 ocr config set mcp_servers.docs.tools '["search_docs", "get_page"]'
 
 # server 起動前に実行する setup コマンド
 ocr config set mcp_servers.docs.setup "npm install -g @acme/docs-mcp-server"
+
+# 環境変数（KEY=VALUE エントリ）
+ocr config set mcp_servers.docs.env '["DOCS_TOKEN=secret", "DOCS_REGION=eu"]'
 ```
 
+#### MCP server を削除する
+
 `unset` で server を削除します：
 
 ```bash
 ocr config unset mcp_servers.docs
 ```
 
-### 手動で編集
-
-同じ設定を JSON で書くと：
+MCP server はユーザー設定ファイル（`~/.opencodereview/config.json`）の `mcp_servers` キーの下に置きます。
 
-```json
-{
-  "mcp_servers": {
-    "docs": {
-      "command": "npx",
-      "args": ["-y", "@acme/docs-mcp-server"],
-      "env": ["DOCS_TOKEN=secret", "DOCS_REGION=eu"],
-      "tools": ["search_docs", "get_page"],
-      "setup": "npm install -g @acme/docs-mcp-server"
-    }
-  }
-}
-```
+| フィールド | 型 | 必須 | 説明 |
+|---|---|---|---|
+| `command` | string | ✓ | MCP server を起動する実行ファイル（`npx`、`uvx`、絶対パスなど）。 |
+| `args` | string 配列 | | `command` に渡す引数。 |
+| `tools` | string 配列 | | 登録するツール名の許可リスト。空 = server が提供する全ツールを登録。 |
+| `setup` | string | | server 起動前に一度実行される shell コマンド（依存関係のインストールなど）。リポジトリのルートで実行、タイムアウト 5 分。 |
+| `env` | string 配列 | | 追加の環境変数、`KEY=VALUE` 形式。 |
 
 ## ツールのフィルタリング
 
 デフォルトでは server が広告するすべてのツールが登録されます。server が
-レビュアーに必要以上のツールを公開する場合は `tools` に許可リストを設定します——
+レビュアーに必要以上のツールを公開する場合は `tools` に許可リストを設定します ——
 ツールが少なく的確なほどエージェントは集中でき、トークンコストも下がります。
 リストに含まれていて server が実際には提供しない名前は警告付きでスキップされる
 ため、タイプミスは黙って無視されるのではなく stderr に表示されます。
@@ -135,16 +98,16 @@ server をオンデマンドでインストールまたはビルドするのに
 すべての MCP 診断情報は **stderr** に、`[ocr]` プレフィックス付きで出力されるため、
 stdout の `--format json` 出力を汚染することはありません：
 
-- `Running setup for MCP server "x": …`——setup コマンドを実行中。
-- `failed to start MCP server "x": …`——サブプロセスが 30 秒の初期化タイムアウト内に
+- `Running setup for MCP server "x": …` —— setup コマンドを実行中。
+- `failed to start MCP server "x": …` —— サブプロセスが 30 秒の初期化タイムアウト内に
   接続できなかったか、`command` が `PATH` にない。
-- `tool "y" conflicts with built-in tool, skipping`——server のツールを改名するか、
+- `tool "y" conflicts with built-in tool, skipping` —— server のツールを改名するか、
   `tools` から外す。
-- `allowed tool "y" not found in server's tool list`——`tools` の名前が server の提供
+- `allowed tool "y" not found in server's tool list` —— `tools` の名前が server の提供
   する何にも一致しない。スペルを確認。
 
 ## 関連項目
 
-- [ツール](../tools/)——MCP ツールが並ぶ 6 つの組み込みツール。
-- [設定](../configuration/)——設定ファイル全体とすべてのキー。
-- [CLI リファレンス](../cli-reference/)——`ocr config` と review のフラグ。
+- [ツール](../tools/) —— MCP ツールが並ぶ 6 つの組み込みツール。
+- [設定](../configuration/) —— 設定ファイル全体とすべてのキー。
+- [CLI リファレンス](../cli-reference/) —— `ocr config` と review のフラグ。

pages/src/content/docs/zh/mcp.md

@@ -5,51 +5,24 @@ sidebar:
 ---
 
 OCR 可以作为 **Model Context Protocol（MCP）客户端**。你把它指向一个或多个外部
-MCP server，这些 server 暴露的工具就会提供给审查 agent——与 `file_read`、
+MCP server，这些 server 暴露的工具就会提供给审查 agent —— 与 `file_read`、
 `code_search` 等[内置工具](../tools/)并列。
 
-这是 MCP 的**客户端**侧。OCR **不会**作为供其他 agent 调用的 MCP server 运行——
-那个方向见[集成](../integrations/#mcp-怎么办)中的说明。本页讲的是相反的事：为
-OCR 自己的审查器扩展能力。
-
 ## 何时使用
 
 当审查器需要 diff 之外的上下文时，就该引入 MCP server：
 
-- **Issue / 工单查询**——让 agent 拉取关联的 Jira / GitHub issue，核对变更是否
+- **Issue / 工单查询** —— 让 agent 拉取关联的 Jira / GitHub issue，核对变更是否
   符合声明的需求。
-- **文档 / 知识库**——拉取内部 API 文档或编码规范，让评论引用真正的团队约定。
-- **自定义分析**——把 linter、schema 校验器或依赖检查器暴露为工具，供审查器按需
+- **文档 / 知识库** —— 拉取内部 API 文档或编码规范，让评论引用真正的团队约定。
+- **自定义分析** —— 把 linter、schema 校验器或依赖检查器暴露为工具，供审查器按需
   调用。
 
-如果你只需要读仓库本身，内置工具就够了——MCP 是为了触达 checkout **之外**的东西。
-
-## 工作原理
-
-- OCR 通过 **stdio 传输**连接每个配置的 server：把 server 作为子进程启动，通过其
-  stdin/stdout 说 MCP 协议。
-- 子进程的**工作目录设为仓库根目录**，并继承 OCR 的环境变量，外加你配置的 `env`。
-- 启动时 OCR 列出该 server 的工具，并注册进内置工具所用的同一个工具注册表。已注册的
-  MCP 工具在 **plan 阶段和 main task 阶段都可用**。
-- server 在整个审查期间保持存活，审查结束时关闭。
-
-如果某个 server 启动失败（或其 `setup` 命令失败），OCR 会打印警告并**在不使用它的
-情况下继续审查**——损坏的 MCP server 绝不会阻塞审查。
+如果你只需要读仓库本身，内置工具就够了 —— MCP 是为了触达 checkout 之外的东西。
 
 ## 配置
 
-MCP server 配置在用户配置文件（`~/.opencodereview/config.json`）的 `mcp_servers`
-键下。每一项以你自选的名字为 key，接受以下字段：
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `command` | string | ✓ | 启动 MCP server 的可执行文件（如 `npx`、`uvx`、绝对路径）。 |
-| `args` | string 数组 | | 传给 `command` 的参数。 |
-| `env` | string 数组 | | 额外环境变量，`KEY=VALUE` 形式。 |
-| `tools` | string 数组 | | 要注册的工具名白名单。为空 = 注册该 server 提供的全部工具。 |
-| `setup` | string | | server 启动前运行一次的 shell 命令（如安装依赖）。在仓库根目录运行，超时 5 分钟。 |
-
-### 使用 CLI
+#### 添加 MCP server
 
 `ocr config set` 命令以非交互方式写入这些字段。数组字段（`args`、`env`、`tools`）
 接受 JSON 数组字符串：
@@ -61,44 +34,38 @@ ocr config set mcp_servers.docs.command npx
 # 参数
 ocr config set mcp_servers.docs.args '["-y", "@acme/docs-mcp-server"]'
 
-# 环境变量（KEY=VALUE 条目）
-ocr config set mcp_servers.docs.env '["DOCS_TOKEN=secret", "DOCS_REGION=eu"]'
-
 # 限制暴露给审查器的工具
 ocr config set mcp_servers.docs.tools '["search_docs", "get_page"]'
 
 # server 启动前运行的 setup 命令
 ocr config set mcp_servers.docs.setup "npm install -g @acme/docs-mcp-server"
+
+# 环境变量（KEY=VALUE 条目）
+ocr config set mcp_servers.docs.env '["DOCS_TOKEN=secret", "DOCS_REGION=eu"]'
 ```
 
+#### 移除 MCP server
+
 用 `unset` 移除某个 server：
 
 ```bash
 ocr config unset mcp_servers.docs
 ```
 
-### 手动编辑
-
-等价的 JSON 配置：
+MCP server 配置在用户配置文件（`~/.opencodereview/config.json`）的 `mcp_servers` 键下。
 
-```json
-{
-  "mcp_servers": {
-    "docs": {
-      "command": "npx",
-      "args": ["-y", "@acme/docs-mcp-server"],
-      "env": ["DOCS_TOKEN=secret", "DOCS_REGION=eu"],
-      "tools": ["search_docs", "get_page"],
-      "setup": "npm install -g @acme/docs-mcp-server"
-    }
-  }
-}
-```
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `command` | string | ✓ | 启动 MCP server 的可执行文件（如 `npx`、`uvx`、绝对路径）。 |
+| `args` | string 数组 | | 传给 `command` 的参数。 |
+| `tools` | string 数组 | | 要注册的工具名白名单。为空 = 注册该 server 提供的全部工具。 |
+| `setup` | string | | server 启动前运行一次的 shell 命令（如安装依赖）。在仓库根目录运行，超时 5 分钟。 |
+| `env` | string 数组 | | 额外环境变量，`KEY=VALUE` 形式。 |
 
 ## 过滤工具
 
 默认注册 server 声明的每个工具。当 server 暴露的工具超出审查器所需时，用 `tools`
-设一个白名单——更少、更精准的工具能让 agent 更专注，也降低 token 成本。白名单里
+设一个白名单 —— 更少、更精准的工具能让 agent 更专注，也降低 token 成本。白名单里
 server 实际没有提供的名字会被跳过并给出警告，因此拼写错误会显示在 stderr 上，而不是
 悄无声息地什么都不做。
 
@@ -125,16 +92,16 @@ MCP 工具名与内置工具共享同一个命名空间。如果某个 server 
 所有 MCP 诊断信息都输出到 **stderr**，以 `[ocr]` 前缀标记，因此绝不会污染 stdout 上
 的 `--format json` 输出：
 
-- `Running setup for MCP server "x": …`——正在执行 setup 命令。
-- `failed to start MCP server "x": …`——子进程未在 30 秒初始化超时内连接成功，或
+- `Running setup for MCP server "x": …` —— 正在执行 setup 命令。
+- `failed to start MCP server "x": …` —— 子进程未在 30 秒初始化超时内连接成功，或
   `command` 不在 `PATH` 中。
-- `tool "y" conflicts with built-in tool, skipping`——重命名该 server 的工具，或将其
+- `tool "y" conflicts with built-in tool, skipping` —— 重命名该 server 的工具，或将其
   从 `tools` 中去掉。
-- `allowed tool "y" not found in server's tool list`——`tools` 中的名字与 server 提供
+- `allowed tool "y" not found in server's tool list` —— `tools` 中的名字与 server 提供
   的任何工具都不匹配；检查拼写。
 
 ## 另见
 
-- [工具](../tools/)——MCP 工具与之并列的六个内置工具。
-- [配置](../configuration/)——完整的配置文件与每个键。
-- [CLI 参考](../cli-reference/)——`ocr config` 与 review 参数。
+- [工具](../tools/) —— MCP 工具与之并列的六个内置工具。
+- [配置](../configuration/) —— 完整的配置文件与每个键。
+- [CLI 参考](../cli-reference/) —— `ocr config` 与 review 参数。