跳到主要内容
← 返回博客

MCP 与 API:差异、示例与选择方法

通过同一个只读账号查询比较 MCP 与直接 API 调用,理解工具发现、凭证、执行、错误处理和适用场景。

OOMOL

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

接口层有哪些变化

直接使用 API 或 SDK 时,由代码选择操作、传入参数并处理响应。使用 MCP 时,客户端发现服务器提供的工具,再通过协议调用。服务仍然需要底层应用的访问权限。参见协议架构。

选择同一个只读任务

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

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

从后端代码调用

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

通过 MCP 调用

打开 OOMOL MCP 配置页,获取目标个人或团队范围的配置,添加到兼容客户端,再提出任务:

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

用同一个账号核对身份。OOMOL 提供发现和执行工具,每个 GitHub 操作不一定单独出现在 MCP 工具列表中。完整配置与认证头见 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 错误说明列出可重试失败。授权失败先修正凭证或账号选择。MCP 客户端则应分别检查连接错误、工具调用失败和工具返回内容。如果工具发现正常、GitHub 查询失败,先核对 OOMOL 团队与 GitHub 连接,而非修改 MCP URL。两条路径都应保留脱敏错误和操作标识,便于定位。

按工作方式选择

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

OOMOL 的 SDK 参考区分个人/团队连接与 ProjectConnector 客户账号。想先交互试用,可以进入 OOMOL Chat,也可以直接配置 MCP。继续查看 GitHub 或 Search Console的具体任务与结果核对方法。