How to configure the MCP service for popular AI models

這篇整理 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