在 Claude Code 接 MCP server

TL;DR

• Claude Code 用 .mcp.json（或 claude mcp add CLI）的 mcpServers 區塊配置連線
• stdio（本機跑 process）跟 http（遠端 endpoint）兩種 transport 都支援
• 接上之後，MCP 暴露的 tools 跟內建工具一起出現在 Claude 的 menu，用 /mcp 命令確認

一個情境：直接讓 Claude 查公司 Postgres schema

你正在讓 Claude 寫一個 report query。痛點通常長這樣：

「我先 \d users、\d orders dump 一份 schema，貼進 chat，Claude 才知道欄位名稱……欸幾天後 schema 改了，又要重貼一次。」

這就是經典 MCP server 場景：讓 Claude 自己去問 DB 拿 schema，不要靠你當人工搬運工。Postgres MCP server 已經有人寫好了，你只要在 Claude Code 端把它「掛上」。

配置：mcpServers 區塊長這樣

兩種寫法等價，挑你喜歡的：

方法 A：直接寫 .mcp.json（放在 project root，會跟著 repo 一起 commit）

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

方法 B：CLI 寫進去（不想自己編 JSON）

# stdio：本機跑 process
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb

# http：遠端 endpoint
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

差別只在 transport：

transport	何時用	怎麼設
stdio	server 跑你本機（npm 套件、Python script）	給 command + args
http	server 是別人代管的 endpoint	給 type: "http" + url

確認真的上線：/mcp

進 Claude Code 後打 /mcp，會列出所有掛上的 server 跟它們暴露的 tools：

postgres   connected   3 tools (query, list_tables, describe_table)
sentry     connected   2 tools (list_issues, get_issue)

看到 connected 就 OK。連不上會顯示 error——通常是：

• stdio：command 不存在、套件沒裝好、env var 沒給
• http：URL 打錯、要 auth header 沒帶

一輪 demo：讓 Claude 自己查 schema 寫 query

掛上 Postgres server 後，你可以直接這樣丟：

「看一下 orders table 的 schema，寫一個 query 算出上個月每個 user 的訂單金額。」

Claude 接到的流程是：

1. 呼叫 describe_table(orders)——拿到欄位
2. 呼叫 describe_table(users)——確認 join key
3. 寫出 SQL，必要時用 query 工具直接跑驗證

你不用再手動 dump schema、不用再 copy-paste。MCP tools 跟 Read、Bash 對 Claude 來說沒差別，都是 menu 上的選項。

接下來

下一篇 Git 工作流——commit、PR review、issue triage 怎麼跟 Claude 協作。MCP 那邊如果想看 server 怎麼寫（不只是用），回 MCP 系列 後面的實作篇。