---
author: OOMOL
author_url: https://oomol.com/ja/about/
datePublished: 2026-11-11
title: MCPとAPI：違い、具体例、使い分け
description: 同じ読み取り専用のアカウント確認を使い、MCPとAPIのツール発見、認証、実行、エラーを比較します。
lang: ja
canonical_url: https://oomol.com/ja/blog/mcp-vs-api/
markdown_url: https://oomol.com/ja/blog/mcp-vs-api.md
---

コードが操作と入力を決めるなら直接APIを、AIクライアントが共通の形式でツールを発見するならMCPを選べます。MCPサーバーの内部でAPIを呼ぶこともでき、両者は併用できます。

## インターフェースの違い

API/SDKではコードが操作を選び応答を処理します。MCPではクライアントがサーバーのツールを発見し、プロトコルで呼びます。下流サービスの認証は引き続き必要です。[公式アーキテクチャ](https://modelcontextprotocol.io/docs/learn/architecture)を参照してください。

## 同じ小さな作業を選ぶ

OOMOLに接続したGitHubユーザーの確認を両方で行います。先に目的のアカウントを接続してください。

## バックエンドから呼ぶ

`@oomol-lab/connector` をインストールし、個人APIキーをバックエンドの `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ガイド](/ja/docs/connector-client/)を参照してください。個人、プロジェクト、MCPのキーは別物です。

## MCPで呼ぶ

[MCP設定](/ja/install/mcp/)で目的の個人・チーム範囲を選び、対応クライアントへ追加します。

> OOMOL MCPで接続済みGitHubユーザーを読み取ってください。接続が複数あれば選ばせてください。実際の本人情報を返し、変更はしないでください。

同じアカウントか確認します。OOMOLは発見・実行ツールを公開し、各GitHub操作が個別表示されるとは限りません。[MCPガイド](/ja/docs/agents/mcp/)に認証設定があります。

## 同じ操作を両経路で追う

SDK例はOOMOLのホスト型APIを呼びます。GitHubへの直接リクエストではありません。直接連携ではGitHubの認証情報と応答を自分で扱います。

| 段階 | OOMOL SDK | MCPクライアント |
| --- | --- | --- |
| 発見 | `connector.catalog.action("github.get_current_user")` を確認。 | ツールとschemaを取得し、OOMOLのツールで操作を探す。 |
| 入力 | 操作IDと `{}` を渡し、アカウントは別に選ぶ。 | ツールのschemaに合わせ、必要な操作やアカウントを渡す。 |
| 認証 | 個人キー、チーム、GitHub接続。 | MCPキー、チーム、同じGitHub接続。OAuthはOOMOLキーを代替しない。 |
| 実行 | `connector.execute(...)` を待つ。 | ツールを呼び、ホストが承認と進行を管理する。 |
| 結果 | `execute` はデータ、`executeRaw` は実行情報も返す。 | モデルの要約より先にツール結果を確認する。 |

MCPは発見と呼び出しを統一しますが、毎回モデルが選ぶ必要はありません。直接APIもモデルのツールにできます。どちらも互換性と下流APIの変更への対応が必要です。

## 失敗を分けて考える

認証失敗、チーム違い、接続不足、正常な空結果を区別します。キーを含めずエラーを記録してください。大きな比較では条件、ページング、項目を揃えます。

SDKでは `ConnectorError` を捕捉し、`code`、`status`、利用可能なリクエスト・実行IDを調べます。再試行条件は[SDK資料](/ja/docs/connector-sdk/)を参照してください。認証失敗はキーやアカウントを直してから再実行します。MCPでは接続エラーとツールの失敗を分けます。発見できてもGitHub取得に失敗する場合は、チームと接続先を確認します。秘密情報を除いたエラーと操作IDを残してください。

## 使い分ける

スケジュール、入力、再試行をコードで制御するならAPI/SDK、AIにツールを発見させるならMCPが候補です。単純なAPIには追加基盤が不要な場合もあります。[SDK資料](/ja/docs/connector-sdk/)は個人・チームと顧客アカウントを分けています。[OOMOL Chat](https://console.oomol.com/overview)で試すか、[GitHub](/ja/integrations/github/)や[Search Console](/ja/integrations/google_search_console/)の具体例に進めます。
