MCP 與 API:差異、範例與選擇
以相同的唯讀帳號查詢比較 MCP 與 API,了解工具發現、憑證、執行與錯誤處理。
程式需要明確控制操作與參數時可直接呼叫 API;AI 用戶端需要統一發現與呼叫工具時可用 MCP。MCP 服務也能在底層呼叫 API,兩者可以一起使用。
介面有哪些差異
直接呼叫由程式選擇操作和處理回應;MCP 用戶端透過協定發現並呼叫工具。底層服務仍需要授權。參見協定架構。
同一個唯讀任務
兩條路徑都讀取 OOMOL 已連線的 GitHub 使用者。先連接並確認目標帳號。
從後端呼叫
安裝 @oomol-lab/connector,建立個人 API Key,將它存為後端 secret OOMOL_API_KEY,只在可信服務端執行:
import { Connector } from "@oomol-lab/connector";
const connector = new Connector({
apiKey: process.env.OOMOL_API_KEY!,
team: "<team-name>",
});
const result = await connector.execute("github.get_current_user", {});
console.log(result);
將 <team-name> 換成 GitHub 連線所在的 OOMOL 團隊,並在下方 MCP 設定選擇同一團隊。
核對回傳身份。多連線選擇方式見 Connector 指南。個人、專案和 MCP 金鑰不能混用。
透過 MCP 呼叫
在 MCP 設定頁取得正確個人或團隊範圍的設定,加入相容用戶端,再詢問:
使用 OOMOL MCP 讀取已連線的 GitHub 使用者。若有多個連線,請我選擇。回傳實際身份欄位,不修改資料。
核對同一帳號。OOMOL 提供發現和執行工具,不一定逐一列出每個 GitHub 操作。設定細節見 MCP 指南。
對照同一次操作
SDK 範例使用 OOMOL 託管 API,不是直接呼叫 GitHub。直接整合 GitHub API 時,需自行處理 GitHub 憑證與回應。
| 步驟 | OOMOL SDK | MCP 用戶端 |
|---|---|---|
| 發現 | 用 connector.catalog.action("github.get_current_user") 檢查操作。 | 發現工具與 schema,再透過 OOMOL 工具尋找操作。 |
| 輸入 | 明確傳入操作 ID 和 {},另行選擇帳號。 | 依工具 schema 提供操作、輸入與必要帳號。 |
| 授權 | 個人 API Key、團隊、GitHub 連線。 | MCP Key、團隊、相同 GitHub 連線。OAuth 不取代 OOMOL Key。 |
| 執行 | 等待 connector.execute(...)。 | 發起工具呼叫,宿主決定審批與編排。 |
| 結果 | execute 回傳資料;executeRaw 增加執行資訊。 | 核對工具結果與 AI 摘要。 |
MCP 統一發現與呼叫方式,不要求每次由模型選擇。直接 API 也能封裝成模型工具。兩條路徑都需維護相容性,並處理底層 API 變更。
先區分錯誤
認證失敗、錯誤團隊、缺少連線與有效空結果要分開處理。記錄錯誤但不記錄金鑰。比較較大任務時保持篩選、分頁與欄位一致。
SDK 捕獲 ConnectorError 後檢查 code、status 與可用的請求或執行 ID,重試條件見 SDK 參考。授權失敗應先修正憑證或帳號。MCP 要區分連線錯誤與工具失敗;能發現工具卻無法查詢時,先核對團隊與 GitHub 連線。保留脫敏錯誤與操作標識,便於追查。
選擇適合的路徑
需要程式控制排程、參數和重試時用 API/SDK;AI 用戶端要發現工具時用 MCP。簡單 API 未必需要額外平台。SDK 參考區分個人/團隊和客戶帳號。也可先在 OOMOL Chat試用,再查看 GitHub或 Search Console任務。