---
author: OOMOL
author_url: https://oomol.com/zh-tw/about/
datePublished: 2026-11-11
title: MCP 與 API：差異、範例與選擇
description: 以相同的唯讀帳號查詢比較 MCP 與 API，了解工具發現、憑證、執行與錯誤處理。
lang: zh-TW
canonical_url: https://oomol.com/zh-tw/blog/mcp-vs-api/
markdown_url: https://oomol.com/zh-tw/blog/mcp-vs-api.md
---

程式需要明確控制操作與參數時可直接呼叫 API；AI 用戶端需要統一發現與呼叫工具時可用 MCP。MCP 服務也能在底層呼叫 API，兩者可以一起使用。

## 介面有哪些差異

直接呼叫由程式選擇操作和處理回應；MCP 用戶端透過協定發現並呼叫工具。底層服務仍需要授權。參見[協定架構](https://modelcontextprotocol.io/docs/learn/architecture)。

## 同一個唯讀任務

兩條路徑都讀取 OOMOL 已連線的 GitHub 使用者。先連接並確認目標帳號。

## 從後端呼叫

安裝 `@oomol-lab/connector`，建立個人 API Key，將它存為後端 secret `OOMOL_API_KEY`，只在可信服務端執行：

```ts
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 指南](/zh-tw/docs/connector-client/)。個人、專案和 MCP 金鑰不能混用。

## 透過 MCP 呼叫

在 [MCP 設定頁](/zh-tw/install/mcp/)取得正確個人或團隊範圍的設定，加入相容用戶端，再詢問：

> 使用 OOMOL MCP 讀取已連線的 GitHub 使用者。若有多個連線，請我選擇。回傳實際身份欄位，不修改資料。

核對同一帳號。OOMOL 提供發現和執行工具，不一定逐一列出每個 GitHub 操作。設定細節見 [MCP 指南](/zh-tw/docs/agents/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 參考](/zh-tw/docs/connector-sdk/)。授權失敗應先修正憑證或帳號。MCP 要區分連線錯誤與工具失敗；能發現工具卻無法查詢時，先核對團隊與 GitHub 連線。保留脫敏錯誤與操作標識，便於追查。

## 選擇適合的路徑

需要程式控制排程、參數和重試時用 API/SDK；AI 用戶端要發現工具時用 MCP。簡單 API 未必需要額外平台。[SDK 參考](/zh-tw/docs/connector-sdk/)區分個人/團隊和客戶帳號。也可先在 [OOMOL Chat](https://console.oomol.com/overview)試用，再查看 [GitHub](/zh-tw/integrations/github/)或 [Search Console](/zh-tw/integrations/google_search_console/)任務。
