MCPとAPI:違い、具体例、使い分け
同じ読み取り専用のアカウント確認を使い、MCPとAPIのツール発見、認証、実行、エラーを比較します。
コードが操作と入力を決めるなら直接APIを、AIクライアントが共通の形式でツールを発見するならMCPを選べます。MCPサーバーの内部でAPIを呼ぶこともでき、両者は併用できます。
インターフェースの違い
API/SDKではコードが操作を選び応答を処理します。MCPではクライアントがサーバーのツールを発見し、プロトコルで呼びます。下流サービスの認証は引き続き必要です。公式アーキテクチャを参照してください。
同じ小さな作業を選ぶ
OOMOLに接続したGitHubユーザーの確認を両方で行います。先に目的のアカウントを接続してください。
バックエンドから呼ぶ
@oomol-lab/connector をインストールし、個人APIキーをバックエンドの 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の認証情報と応答を自分で扱います。
| 段階 | 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資料を参照してください。認証失敗はキーやアカウントを直してから再実行します。MCPでは接続エラーとツールの失敗を分けます。発見できてもGitHub取得に失敗する場合は、チームと接続先を確認します。秘密情報を除いたエラーと操作IDを残してください。
使い分ける
スケジュール、入力、再試行をコードで制御するならAPI/SDK、AIにツールを発見させるならMCPが候補です。単純なAPIには追加基盤が不要な場合もあります。SDK資料は個人・チームと顧客アカウントを分けています。OOMOL Chatで試すか、GitHubやSearch Consoleの具体例に進めます。