メインコンテンツへスキップ
← ブログに戻る

MCPとAPI:違い、具体例、使い分け

同じ読み取り専用のアカウント確認を使い、MCPとAPIのツール発見、認証、実行、エラーを比較します。

OOMOL

コードが操作と入力を決めるなら直接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 SDKMCPクライアント
発見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の具体例に進めます。