MCP 實戰入門：讓你的 AI Agent 連接一切

不再當「資訊孤島」

MCP 是什麼？

一句話說：MCP（Model Context Protocol）是 AI Agent 和外部工具之間的「通用介面標準」。

沒有 MCP 之前，你要讓 AI Agent 連接一個新工具（比如 Notion、GitHub、資料庫），每次都要自己寫程式、做 API 對接，麻煩且不可複用。有了 MCP 之後，工具提供商按照統一的標準發布 MCP Server，AI Agent 按照同樣的標準接入，雙方都不用重複開發。

類比：MCP 就是 AI 領域的 USB 介面標準——不管你插什麼裝置，介面一樣，就能用。

MCP 的三個核心概念

1. MCP Server

工具方提供的「適配器」。比如 Notion 的 MCP Server、GitHub 的 MCP Server。你在本機或伺服器上執行這個 Server，它就變成 AI Agent 可以呼叫的介面。

2. MCP Client

AI Agent 這邊的對接層。Claude、OpenClaw 等支援 MCP 的 Agent 會內建 MCP Client，自動發現並呼叫你執行的 MCP Server。

3. Resources / Tools / Prompts

MCP Server 暴露給 Agent 的三類能力：

Resources：可讀的資料（檔案、資料庫記錄）
Tools：可執行的操作（建立、修改、查詢）
Prompts：預設的提示詞範本

三個馬上能跑的實戰案例

案例一：讓 AI 讀寫你的 Notion

npx @notionhq/notion-mcp-server

設定好之後，你可以直接問 AI：「幫我在 Notion 的專案資料庫裡新建一條任務：優化登入頁面，截止日期下週五」

案例二：讓 AI 管理你的 GitHub

npx @modelcontextprotocol/server-github

設定後：「幫我看看這個倉庫最近 7 天的 PR，有沒有超過 3 天沒人 review 的」

案例三：讓 AI 查詢本機資料庫

npx @modelcontextprotocol/server-sqlite --db-path ./mydata.db

之後直接用自然語言查資料：「過去 30 天銷售額最高的 5 個產品是什麼？」

在 OpenClaw 裡設定 MCP

OpenClaw 內建了 MCP Client 支援。在設定檔裡加上：

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["@notionhq/notion-mcp-server"],
      "env": { "NOTION_API_KEY": "你的 key" }
    }
  }
}

重啟 OpenClaw 後，Agent 會自動發現並註冊這個 MCP Server。

常見踩坑

問題	原因	解決
Server 啟動失敗	Node 版本太低	升級到 Node 18+
Agent 看不到工具	設定檔路徑錯誤	檢查 JSON 格式和路徑
權限不足	API Key 權限範圍不夠	重新產生完整權限的 Key

SFD Lab | 實測環境：OpenClaw v1.x + Node 20