---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
datePublished: 2026-11-11
title: MCP 与 API：差异、示例与选择方法
description: 通过同一个只读账号查询比较 MCP 与直接 API 调用，理解工具发现、凭证、执行、错误处理和适用场景。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/blog/mcp-vs-api/
markdown_url: https://oomol.com/zh-cn/blog/mcp-vs-api.md
---

如果应用代码需要明确选择操作与参数，可以直接调用 API；如果 AI 客户端需要统一发现和调用工具，可以使用 MCP。MCP 服务底层也可以调用 API，两条路径能完成同一个任务。选择重点是调用接口与流程由谁控制。

## 接口层有哪些变化

直接使用 API 或 SDK 时，由代码选择操作、传入参数并处理响应。使用 MCP 时，客户端发现服务器提供的工具，再通过协议调用。服务仍然需要底层应用的访问权限。参见[协议架构](https://modelcontextprotocol.io/docs/learn/architecture)。

## 选择同一个只读任务

两条路径都读取 OOMOL 已连接的 GitHub 用户身份，不修改仓库。

先在 OOMOL 连接 GitHub，确认目标账号。

## 从后端代码调用

安装 `@oomol-lab/connector`，在 OOMOL Console 创建个人 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-cn/docs/connector-client/)选择目标连接。个人 API Key、项目 Key 和 MCP 凭证用途不同，不应混用。

## 通过 MCP 调用

打开 [OOMOL MCP 配置页](/zh-cn/install/mcp/)，获取目标个人或团队范围的配置，添加到兼容客户端，再提出任务：

> 使用 OOMOL MCP 读取已连接的 GitHub 用户。如果存在多个连接，请我选择。返回实际身份字段，不修改任何内容。

用同一个账号核对身份。OOMOL 提供发现和执行工具，每个 GitHub 操作不一定单独出现在 MCP 工具列表中。完整配置与认证头见 [MCP 指南](/zh-cn/docs/agents/mcp/)。

## 对照一次操作的完整路径

上面的 SDK 调用访问 OOMOL 托管 API，并非直接请求 GitHub。两条路径都复用 OOMOL 连接；直接集成 GitHub API 时，需要自行处理 GitHub 凭证和响应。

| 步骤 | OOMOL SDK 示例 | MCP 客户端 |
| --- | --- | --- |
| 发现操作 | 编码前用 `connector.catalog.action("github.get_current_user")` 检查操作。 | 发现服务的工具和 schema，再通过 OOMOL 发现工具查找 GitHub 操作。 |
| 提供输入 | 明确传入操作 ID 与 `{}`；账号选择独立于这个空输入。 | 按发现的工具 schema 提供参数，需要时包含操作与账号。 |
| 授权 | 个人 API Key、团队与 GitHub 连接。 | MCP Key、团队与同一个 GitHub 连接。Google 或 GitHub OAuth 不替代 OOMOL Key。 |
| 执行 | 代码等待 `connector.execute(...)`。 | 客户端发起工具调用，服务执行底层操作；宿主决定审批和流程编排。 |
| 读取输出 | `execute` 返回操作数据，`executeRaw` 还提供执行元信息。 | 先检查工具结果，再核对 AI 摘要。 |

MCP 统一工具发现、输入 schema 和调用方式，不要求每次都由模型选择操作。应用也能把直接 API 封装为模型工具。直接接入需要维护 API 映射和响应处理；MCP 接入需要维护客户端与服务的兼容性，并检查工具变化。两者都无法消除底层 API 变更。

## 比较结果前先区分错误

认证失败、选错团队、缺少应用连接和有效空结果是不同情况。记录目标账号和错误，避免输出凭证。

扩大比较时，应保持操作、筛选、分页和返回字段一致。

使用此 OOMOL SDK 时，捕获 `ConnectorError`，检查 `code`、`status` 及可用的请求或执行 ID；[SDK 错误说明](/zh-cn/docs/connector-sdk/#错误处理)列出可重试失败。授权失败先修正凭证或账号选择。MCP 客户端则应分别检查连接错误、工具调用失败和工具返回内容。如果工具发现正常、GitHub 查询失败，先核对 OOMOL 团队与 GitHub 连接，而非修改 MCP URL。两条路径都应保留脱敏错误和操作标识，便于定位。

## 按工作方式选择

后端任务需要代码控制调度、参数和重试时，使用 API/SDK；兼容 AI 客户端需要发现工具并处理结果时，使用 MCP。同一套连接可以同时服务后端和个人 Agent。简单的独立 API 调用未必需要额外平台。

OOMOL 的 [SDK 参考](/zh-cn/docs/connector-sdk/)区分个人/团队连接与 ProjectConnector 客户账号。想先交互试用，可以进入 [OOMOL Chat](https://console.oomol.com/overview)，也可以直接配置 MCP。继续查看 [GitHub](/zh-cn/integrations/github/) 或 [Search Console](/zh-cn/integrations/google_search_console/)的具体任务与结果核对方法。
