加你的第一個 MCP Server

一個指令把 Claude Code 連到 GitHub、資料庫、跟更多

⏱ 預估 ~6 分鐘

01 · 讀一讀

加 MCP server 到 Claude Code 是單一指令。你用 claude mcp add 後面接名字跟 URL(HTTP)或指令（stdio）。

加完之後，Claude 能用那 server 公開的每個工具 — 自動。沒有程式碼改動、沒有設定檔、沒有重啟。加進去就開始叫 Claude 用。

重點整理

下面是怎麼加遠端 HTTP server — 最常見的類型。這例子把 Claude 連到 GitHub。

加 GitHub MCP server

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

加 Notion MCP server

claude mcp add --transport http notion https://mcp.notion.com/mcp

加驗證 header

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

模式永遠一樣：claude mcp add --transport http <name> <url>。Name 是你之後怎麼參考這個 server 的名字。URL 是 MCP server 住的地方。Server 需要 token 時用 --header 加驗證 header。

Stdio server 跑本機程序。這例子用 dbhub 套件把 Claude 連到 PostgreSQL 資料庫。

加 PostgreSQL server

claude mcp add --transport stdio db \
  -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@localhost:5432/mydb"

加帶環境變數

claude mcp add --transport stdio airtable \
  --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

--(雙 dash)分開 Claude 的選項跟 server 的指令跟參數。-- 後面的所有東西是跑 MCP server 的指令。用 --env 把 API key 當環境變數安全傳遞，不要寫死。

決定你要加哪個 MCP server。HTTP server 你需要 server 的 URL。Stdio server 你需要 npm 套件名或指令。看官方 MCP server 清單或你服務的文件。

遠端 server 用 claude mcp add --transport http <name> <url>，本機的用 claude mcp add --transport stdio <name> -- <command>。記住：所有選項在 name 前面，-- 分開 server 指令。

跑 claude mcp list 看所有設定的 server，或在 Claude Code 裡用 /mcp 看狀態跟驗證。綠色狀態表示 server 連上、準備好了。

開始 Claude Code 對話、問需要那 server 的問題。GitHub：「顯示我的開啟 PR。」資料庫：「有什麼 table？」Claude 自動發現 server 的工具。

你要加一個需要 DATABASE_URL 環境變數的本機資料庫 server。旗標順序重要。哪個指令對？

列出所有你設定的 MCP server，跑 claude mcp _____

⚠ 完整互動體驗需要 JavaScript。請啟用 JavaScript 後重新整理。

※ 本站為獨立繁中教學專案，非 Anthropic 官方產品。Claude™ 為 Anthropic, PBC 商標。