MCP 原語

MCP 三大原語（Primitives）

MCP Server 能提供給 Claude 的 3 種能力：Tools / Resources / Prompts。

對照表

原語	定位	範例
Tools	可執行的動作	query_employee(id), send_slack(text)
Resources	唯讀的靜態資源	員工手冊 PDF、組織圖、API 文件
Prompts	預設提示模板	「年度考核評語範例」

何時用哪個

• 想 Claude 去做 → Tool
• 想 Claude 去讀 → Resource
• 想提供範本 → Prompt

Tools（最常用）

讓 Claude 能執行特定操作：

{
  name: "query_employee",
  description: "依員工編號查 PAM 員工資訊",
  inputSchema: {
    type: "object",
    properties: {
      employee_no: { type: "string", description: "員工編號" }
    },
    required: ["employee_no"]
  }
}

Claude 看到「查員工 E001」→ 自動呼叫 query_employee("E001")。

Resources

把靜態文件丟給 Claude 當參考：

mcp://pam/employee-handbook.pdf
mcp://pam/org-chart.json
mcp://pam/api-spec.yaml

Claude 在需要時讀這些（不會無限 spam 進 context）。

Prompts

預先寫好的 prompt 模板，使用者一鍵呼叫：

@pam-eval-narrative employee=E001

伺服端展開為：

你是資深 HRBP。請為員工 E001 寫一段年度評語，包含…

設計原則

1. Tool 名稱用動詞：query_*, send_*, create_*
2. Resource 用 URI：固定路徑，方便引用
3. Prompts 含參數：模板 + 變數，靈活套用

相關概念

強連結（原文明確提及）

• MCP 三層架構
• OAuth 流程 — 工具呼叫前的認證
• Sub-agent — 讓子 agent 用 MCP Tool

深入閱讀（外部資源）

• 深入閱讀：11-MCP 建置與使用

← 回到 wiki