嗨，我係 Lena。幾星期前突然有樣嘢 click 咗，但我仲一路喺度諗：點解我要去到嗰一刻先至真係睇明。
我一直都有用 Claude Code——跑 shell、改檔、一步一步咁做 refactor。係好用，但總覺得成件事仲係幾 siloed。直到我接咗個 GitHub MCP server，叫佢 review 一個 pull request、睇埋相關嘅 Sentry errors，然後再 update 張 Jira ticket。同一個 session，三個服務，真係一齊行得通。
嗰一刻開始，佢就唔再似「聰明啲嘅 terminal wrapper」，而係開始有種可以自由組合嘅感覺。呢篇 guide，就係我當時最想有人直接塞俾我嗰份——唔使我自己花兩個鐘，喺零零碎碎嘅 docs 同 GitHub issues 入面慢慢執。
MCP 喺 Claude Code 入面點樣運作
Claude Code 本身就係一個 MCP client。 呢個分野好重要。淨係佢自己，已經可以讀檔、跑 bash、搜 code、call Anthropic API。其實已經唔少。但如果冇中間嗰層去接，佢就掂唔到你嘅 GitHub repos、Postgres tables，或者 Figma frames。
嗰層就係 MCP——一個用嚟做 AI-tool integrations 嘅 open source standard。當你加一個 MCP server，Claude Code 就會多一批新 tools：query database、讀 Jira tickets、同外部服務互動。
Claude Code 點樣 handle tool calls
當 Claude Code 判斷自己需要 call 某個 MCP tool，佢唔會一諗到就即刻發出去。喺任何 MCP tool 真正 execute 之前，Claude Code 都會先彈個 permission prompt——會顯示 tool 名同 input arguments，等你睇清楚佢準備做咩。
Tool 名會跟一個固定格式：mcp__<server-name>__<tool-name>。所以 filesystem server 嘅 read tool，就會變成 mcp__filesystem__read_file。如果你喺 headless 或者 CI 環境度預先 approve tools，呢個命名規則就特別重要。
MCP 加咗啲 built-in tools 本身冇嘅能力
Claude Code 原生嘅 tools 對本地環境其實已經幾夠用。但佢哋做唔到嘅，係伸手去外部服務、query databases，或者從 issue trackers 拉資料。MCP 就係將呢個 reach 拉遠。每加一個 server，Claude Code 就會多一組新 capability：query database、開 GitHub issue、跑 browser test，或者喺 Figma 度拎 design tokens。
Model Context Protocol specification 定義咗三個 core primitives：Resources（原始資料）、Tools（動作）、Prompts（可重用 templates）。實際用落，你大多數時間都係同 Tools 打交道。
點樣喺 Claude Code 安裝同設定 MCP servers
MCP config 放喺邊
Claude Code 主要會喺兩個地方存放 MCP configuration：
- Project scope —— 你個 project directory 入面嘅
.mcp.json，可以 version control，亦都可以同 team share - User scope —— 你嘅 user settings，所有 projects 都用得到
Project-specific 嘅 override 仲可以放喺 .claude/settings.local.json；而 user-specific 嘅本機設定則可以放喺 ~/.claude/settings.local.json。
如果你係自己一個開發，user scope 通常係更實際嘅預設。要俾 team 一齊用，.mcp.json 就會自然好多——因為佢會同個 repo 一齊 commit。
點樣加一條 server entry
最主要嘅方法係用 claude mcp add 呢條 command。對 remote MCP servers 嚟講，官方更推薦 HTTP transport，亦都係 cloud-based services 最廣泛支援嘅 transport：
# Remote HTTP server (recommended for cloud services)
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Local stdio server (for tools needing direct system access)
claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /home/user/projects
# User-scoped (available across all projects)
claude mcp add --scope user my-db -- npx -y @my-org/mcp-server-postgres
有樣嘢真係好多人會中伏：所有 options（--transport、--env、--scope）都一定要擺喺 server name 前面。-- 呢個分隔符，先至係用嚟將 server name 同後面嘅 command arguments 分開。次序一錯，啲 flags 就會傳錯 process。
如果你用 Windows，記得用 cmd /c 包住 npx commands：
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package
如果冇 cmd /c 呢層 wrapper，Windows 通常會直接 execute 唔到 npx，最後就拋個 "Connection closed."
點樣 verify 連線
加完 server 之後，跑：
claude mcp list
喺 Claude Code session 入面，用 /mcp 打開 management panel，就可以睇每個 server 係 connected、disconnected 定係 error。
喺 session 入面試 tool call
當一個 server 顯示 connected 之後，你直接叫 Claude Code 用佢就得。好似加咗 filesystem server 之後，你可以講："Read the file at /home/user/projects/config.json"。如果設定冇問題，你會先見到 permission prompt，之後佢先 execute。
值得提一句：MCP configuration 會跟住 Claude Code 更新而變。最 authoritative 嘅，始終都係官方 Claude Code MCP documentation。如果實際行為同呢度寫嘅唔一樣，以官方 docs 為準。
我會推薦俾 Claude Code 用嘅 MCP servers
以下呢批，係我見過到 2026 年初仲算穩定、仲有人維護嘅。GitHub 上嘅 official MCP servers repository 有完整 list——有啲係 Anthropic 維護，更多係 community-built。
Filesystem —— 基礎款。讀、寫、整理本機檔案，仲可以設定 directory boundaries。你可以自己控制 expose 邊啲 directories。
claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /your/project/path
GitHub —— 用 personal access token，經 HTTP transport 加 GitHub MCP server：
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'
咁樣 Claude Code 就可以掂 PRs、issues 同 repositories。你可以直接問："Review the diff in PR #234 and leave inline comments."
PostgreSQL —— 俾 Claude 直接 query 你個 database。將 connection string 設做 environment variable：
claude mcp add --scope user my-db -- npx -y @modelcontextprotocol/server-postgres
# Set DATABASE_URL in your environment
Web search / Fetch —— Firecrawl MCP 會 fetch URLs，再回傳乾淨嘅 Markdown。當 Claude 需要最新 API docs，或者 training data 冇收錄到嘅第三方參考時，就會幾有用。
Context7 —— 專門拉返 version-specific library documentation。當你手上個 framework version，對 Claude 嚟講唔夠新或者資料唔夠乾淨，呢個就幫到手。
Sequential Thinking —— 佢唔係 data source，而係 reasoning server。當你要做複雜 refactor，佢會幫 Claude 先將任務拆成明確步驟，再逐步 execute。
有句提醒我想講得直接啲：第三方 MCP servers 要小心用。 Anthropic 並冇逐個 verify 所有 MCP servers 嘅正確性同安全性。尤其係會 fetch 唔可信內容嗰類 server，更容易將 prompt injection 風險帶入嚟。
喺 Claude Code 入面點樣 troubleshoot MCP
Server 完全唔出現
最常見原因係 PATH。Claude Code 喺拉起 MCP server subprocess 時，用嘅 shell environment 同你平時 terminal 唔一定一樣，所以 node 同 npx 有機會搵唔到。如果你用 nvm，要嘛直接用 Node binary 嘅 absolute path，要嘛確保 nvm 喺 non-interactive shell 都會 load——即係將 nvm 初始化嗰段加落你個 shell profile。
另外，記得 validate 你嘅 JSON。Trailing commas、漏引號、未 escape 嘅反斜線，都會令佢靜靜地 fail。JSON 本身唔容許 trailing commas，而呢個偏偏又係 MCP config files 最常見嘅錯。restart 之前先用 JSON linter 過一過，通常會少好多時間浪費。
Tool calls 回 error
如果 server 連到，但 tool calls fail，先 check tool 名格式係咪真係：mcp__<server-name>__<tool-name>。另外，亦都要 check environment variables（API keys、connection strings）係咪真係喺你個 shell 入面 set 好——Claude Code 繼承嘅係 process environment，唔會自動由 .env file 幫你讀。
如果係 SSE transport 問題：MCP_TIMEOUT 呢個 environment variable 唔適用於 SSE connections——轉返去 HTTP transport，通常更穩，亦都係官方 docs 推薦嘅做法。
唔止 MCP：點樣令 Claude Code 做過嘅嘢可以真正重用
有樣嘢我一直喺度諗。MCP 解決咗 reach 問題——Claude Code 而家可以掂 GitHub、databases、Slack。但每個 session 依然都係由零開始。Claude 摸到嘅 fixes、認到嘅 patterns、行得通嘅 approaches——唔會自動帶到下一次。
「Claude 今次做咗件有用嘅事」同「嗰件有用嘅事，而家已經變成我成套系統點樣運作嘅一部分」之間，真係有條縫。而且，呢條縫同 MCP 解決嗰批問題，其實唔係同一層。
而家最實際嘅 workaround，反而幾直接：用 CLAUDE.md 寫低你希望 Claude 之後會重用嘅 patterns；將好用嘅 prompts 同 code 一齊 commit；將成功嘅 Claude Code sessions 當成值得 capture 嘅資產——唔好只係用完就算。
FAQ
點樣將 MCP servers 加入 Claude Code？
用 claude mcp add，揀啱 transport flag。Remote services 用 --transport http；本地 tools 用 --transport stdio。用 --scope project 將 server 綁去個 project，或者用 --scope user 綁去你嘅 user profile。完整 syntax 同 examples 都喺 official Claude Code MCP docs 入面。
Claude Code 嘅 MCP config file 喺邊？
Project-scoped configs 會喺 project root 嘅 .mcp.json。User-scoped configs 會喺你嘅 Claude Code user settings。更複雜嘅情況，你亦都可以直接改 ~/.claude.json——不過記得 restart 之前先 validate 個 JSON。
邊啲 MCP servers 同 Claude Code 最夾？
對多數 developers 嚟講：GitHub MCP server 同 filesystem server 已經 cover 到最高頻用途。如果你成日 query databases，就加 PostgreSQL。Documentation-heavy 嘅工作可以考慮 Context7。複雜 multi-step refactor 則適合 Sequential Thinking。最好先由一兩個開始，確認佢哋 connect 得乾淨，再慢慢加。
我應該仲會繼續睇住呢套 stack 點樣變。上面呢份 list，反映嘅係 2026 年初真正仲有人維護、而且真係用得落手嘅嘢——唔係理論上聽落幾吸引但其實冇人理嗰種。
