這篇整理 4 個終端型 AI 工具目前支援的 MCP 設定方式：
- Google Gemini CLI
- OpenAI Codex CLI
- Claude Code
- GitHub Copilot CLI
本文假設專案目錄是 /code/chan。
範例都以 minhlucvan/agent-browser-mcp 為例，目標設定如下：
{
"mcp": {
"servers": {
"agent-browser": {
"command": "npx",
"args": ["agent-browser-mcp"]
}
}
}
}
先決條件
- 已安裝 Node.js，讓
npx可用 - 以下範例以 macOS/Linux 路徑表示
1. Google Gemini CLI
Gemini CLI 支援：
- 全域設定：
~/.gemini/settings.json - 專案設定：
/code/chan/.gemini/settings.json - 指令管理：
gemini mcp add/remove/enable/disable/list
專案目錄設定
在專案根目錄建立或編輯 /code/chan/.gemini/settings.json：
{
"mcpServers": {
"agent-browser": {
"command": "npx",
"args": ["agent-browser-mcp"]
}
}
}
全域設定
編輯 ~/.gemini/settings.json：
{
"mcpServers": {
"agent-browser": {
"command": "npx",
"args": ["agent-browser-mcp"]
}
}
}
用指令安裝
安裝到目前專案：
gemini mcp add -s project agent-browser npx agent-browser-mcp
安裝到全域：
gemini mcp add -s user agent-browser npx agent-browser-mcp
不進 TUI 列出 MCP
列出目前可用的 MCP server：
gemini mcp list
用指令移除
移除專案設定：
gemini mcp remove -s project agent-browser
移除全域設定：
gemini mcp remove -s user agent-browser
如果只是暫時停用，也可以用：
gemini mcp disable agent-browser
gemini mcp enable agent-browser
2. OpenAI Codex CLI
Codex 支援：
- 全域設定：
~/.codex/config.toml - 專案設定：
/code/chan/.codex/config.toml - 指令管理：
codex mcp add/remove/list/get/login/logout
要注意一點：目前 codex mcp add/remove 沒有 scope 參數，實務上比較適合管理全域設定。若你要做專案限定 MCP，直接編輯 /code/chan/.codex/config.toml 會比較明確。
專案目錄設定
在專案根目錄建立或編輯 /code/chan/.codex/config.toml：
[mcp_servers.agent-browser]
command = "npx"
args = ["agent-browser-mcp"]
全域設定
編輯 ~/.codex/config.toml：
[mcp_servers.agent-browser]
command = "npx"
args = ["agent-browser-mcp"]
用指令安裝
Codex CLI 目前最直接的做法是加到全域設定：
codex mcp add agent-browser -- npx agent-browser-mcp
不進 TUI 列出 MCP
列出目前已設定的 MCP server：
codex mcp list
用指令移除
codex mcp remove agent-browser
專案設定怎麼移除
如果你是手動寫在 /code/chan/.codex/config.toml，就把這段刪掉：
[mcp_servers.agent-browser]
command = "npx"
args = ["agent-browser-mcp"]
如果只是暫時不想用，也可以改成：
[mcp_servers.agent-browser]
command = "npx"
args = ["agent-browser-mcp"]
enabled = false
3. Claude Code
Claude Code 的 MCP scope 最完整，分成 3 種：
- local：只對你自己、只在目前專案有效，存在
~/.claude.json（巢狀於projects.{專案路徑}.mcpServers） - project：專案共享，存在專案根目錄
/code/chan/.mcp.json - user：全域，存在
~/.claude.json（頂層mcpServers）
如果你這篇文章要區分「專案目錄設定」和「全域設定」，最適合介紹的是：
- 專案設定：
/code/chan/.mcp.json - 全域設定：
~/.claude.json
專案目錄設定
在專案根目錄建立 /code/chan/.mcp.json：
{
"mcpServers": {
"agent-browser": {
"command": "npx",
"args": ["agent-browser-mcp"]
}
}
}
全域設定
編輯 ~/.claude.json，放在頂層 mcpServers：
{
"mcpServers": {
"agent-browser": {
"type": "stdio",
"command": "npx",
"args": ["agent-browser-mcp"]
}
}
}
用指令安裝
安裝成專案共享設定：
claude mcp add --transport stdio --scope project agent-browser -- npx agent-browser-mcp
安裝成全域設定：
claude mcp add --transport stdio --scope user agent-browser -- npx agent-browser-mcp
如果你想做「只在這個專案對你自己有效」，可以用：
claude mcp add --transport stdio --scope local agent-browser -- npx agent-browser-mcp
不進 TUI 列出 MCP
列出目前可用的 MCP server：
claude mcp list
用指令移除
claude mcp remove agent-browser
如果你先前是用 --scope user 或 --scope project 加的，移除時記得用同樣 scope：
claude mcp remove --scope user agent-browser
claude mcp remove --scope project agent-browser
claude mcp remove --scope local agent-browser
4. GitHub Copilot CLI
GitHub Copilot CLI 支援：
- 全域設定：
~/.copilot/mcp-config.json - 專案設定：
/code/chan/.mcp.json或/code/chan/.github/mcp.json - 指令管理：
copilot mcp add/remove/list/get
要注意一點：目前 copilot mcp add/remove 是針對 user-level，也就是 ~/.copilot/mcp-config.json。專案層級通常要手動編輯 /code/chan/.mcp.json 或 /code/chan/.github/mcp.json。
專案目錄設定
可以在專案根目錄放 /code/chan/.mcp.json：
{
"mcpServers": {
"agent-browser": {
"type": "local",
"command": "npx",
"args": ["agent-browser-mcp"]
}
}
}
或放在 /code/chan/.github/mcp.json，作為 repository-level 共享設定：
{
"mcpServers": {
"agent-browser": {
"type": "local",
"command": "npx",
"args": ["agent-browser-mcp"]
}
}
}
全域設定
編輯 ~/.copilot/mcp-config.json：
{
"mcpServers": {
"agent-browser": {
"type": "local",
"command": "npx",
"args": ["agent-browser-mcp"]
}
}
}
用指令安裝
Copilot CLI 的 mcp add 目前是寫入全域設定：
copilot mcp add agent-browser --type local -- npx agent-browser-mcp
不進 TUI 列出 MCP
列出目前已設定的 MCP server：
copilot mcp list
用指令移除
copilot mcp remove agent-browser
專案設定怎麼移除
如果是手動寫在 /code/chan/.mcp.json 或 /code/chan/.github/mcp.json，就把 agent-browser 那段刪掉即可。
四套工具差異總結
| 工具 | 全域設定 | 專案設定 | 可用指令安裝到專案？ | 可用指令移除？ |
|---|---|---|---|---|
| Gemini CLI | ~/.gemini/settings.json |
/code/chan/.gemini/settings.json |
可以，-s project |
可以，gemini mcp remove -s project |
| OpenAI Codex CLI | ~/.codex/config.toml |
/code/chan/.codex/config.toml |
官方文件偏向手動編輯專案設定 | 可以移除 CLI 加上的全域設定 |
| Claude Code | ~/.claude.json |
/code/chan/.mcp.json |
可以，--scope project |
可以，claude mcp remove --scope project |
| GitHub Copilot CLI | ~/.copilot/mcp-config.json |
/code/chan/.mcp.json 或 /code/chan/.github/mcp.json |
user-level 可以；project-level 建議手動編輯 | 可以移除 user-level；project-level 手動刪除 |
參考資料
- Gemini CLI configuration: https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/configuration.md
- Gemini CLI MCP servers: https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md
- OpenAI Codex config basics: https://developers.openai.com/codex/config-basic
- OpenAI Codex MCP: https://developers.openai.com/codex/mcp
- Claude Code MCP: https://code.claude.com/docs/en/mcp
- GitHub Copilot CLI config directory: https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference
- GitHub Copilot CLI MCP docs: https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers
- GitHub Copilot CLI command reference: https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference
