ClaudeにAirbyte Agents MCPをつないで業務データを横断検索する手順
Airbyte Agents MCPをClaude DesktopとClaude Codeに追加し、SalesforceやHubSpotなど業務アプリのデータを会話で検索する手順。二重の認証、検索の鮮度、AOの消費も扱う。
Airbyte Agents MCPは、Airbyteが運営するリモートMCPサーバーです。CRM、サポートデスク、課金、プロジェクト管理といった業務アプリへの接続をAirbyte側で預かり、Claudeからは1つのURLだけで読み書きできるようにします。インストールするものはありません。
つなぎ方は短く済みます。つまずきやすいのは、認証が2段あることと、検索結果の鮮度がプランで変わることです。この記事では、Claude DesktopとClaude Codeへの追加手順に加え、この2点と料金の仕組み、権限の絞り方を扱います。
Airbyte Agents MCPでClaudeに何ができるようになるか
Airbyte Agentsは、AIエージェントに業務データへのリアルタイムのアクセスを渡すためのデータ基盤です。型付きのオープンソースコネクタ、管理された認証情報、低遅延の検索で構成されます。MCPはその入口のひとつで、ほかにPython SDK、CLI、API、Webアプリがあります。
MCP経由でClaudeができることは、次の3つです。
- 業務アプリのコネクタを会話で追加する(「Linearをつないで」)
- 追加済みのアプリのレコードを検索・取得する
- コネクタによっては、レコードの作成や更新、メッセージ送信などの書き込みをする
コネクタ一覧には、Salesforce、HubSpot、Stripe、Gong、Jira、Linear、Slackなどが並びます。Claude側で1回MCPを追加すれば、あとはコネクタを増やすたびにClaudeの設定を触る必要はありません。複数のデータソースを1つのMCPに束ねる点は、CData Connect AIのコネクタと似ています。
始める前に用意するもの
必要なものは3つです。
| 用意するもの | 内容 |
|---|---|
| Airbyte Agentsのアカウント | 内容app.airbyte.aiで作成する。無料プランがある |
| MCP対応のクライアント | 内容Claude Desktop、Claude Codeなど |
| 各サービスの資格情報 | 内容Linearならapi key、SalesforceならOAuthの認可 |
最後の資格情報は、Claudeに渡すものではありません。後述のとおり、ブラウザ上でAirbyteの画面に直接入力します。
Claude Desktopに追加する手順
Claude Desktopでは、リモートMCPサーバーはカスタムコネクタとして追加します。claude_desktop_config.json はローカルサーバー専用なので、ここには書きません。
Claude Desktopへの追加
- 1
カスタムコネクタを追加する
「Settings」の「Connectors」を開き、「Add custom connector」を押します。名前に任意の名称、URLに
https://mcp.airbyte.ai/mcpを入れて「Add」を押します。 - 2
Airbyteで認可する
一覧に出た「Airbyte」の「Connect」を押すとブラウザが開きます。Airbyteにログインし、Agent MCPへのアクセスを許可します。
- 3
チャットで有効にする
Claude Desktopに戻ると自動で有効になります。有効になっていない場合は、チャットの「+」から「Connectors」、「Airbyte」の順に開いてオンにします。
Claude Codeに追加する手順
ターミナルで1行実行すると登録できます。
claude mcp add --transport http airbyte-agent https://mcp.airbyte.ai/mcp登録後に claude を起動し、/mcp を入力します。一覧から airbyte-agent を選んで「Authenticate」を押すとブラウザが開くので、Airbyteにログインして許可します。戻れば使えます。
/mcp/mcp の画面は、認可をやり直すときの入口にもなります。
認証が2段あることを理解しておく
初回の接続で混乱しやすいのが、認証が2回出てくる点です。Airbyteの説明では、役割の違う2層に分かれています。
2つの認証層
1層目
ClaudeがAirbyteのMCPサーバーに入るためのOAuth 2.0です。Airbyteアカウントにログインして許可します。トークンはアカウントと組織にひも付き、期限が切れるとクライアントが自動で再認可を始めます。
2層目
SalesforceやStripeなど、つなぎたい業務アプリごとの認証です。OAuthの同意画面か、APIキーの入力フォームのどちらかになります。
2層目の入力は、必ずブラウザの専用画面で行います。チャット欄にキーを貼る必要はなく、サーバー側に保管された資格情報がエージェントに渡ることもありません。キーを会話に流したくない運用では、この設計が効きます。
最初の接続から検索までの流れ
MCPを追加しただけでは、まだ検索できるデータがありません。続けてコネクタを追加します。
コネクタを追加する
Claudeに次のように頼みます。
Connect my Linear account流れは次のとおりです。
コネクタ追加の流れ
- 1
URLが返ってくる
Claudeが認証フローを開始し、ブラウザで開くURLを案内します。
- 2
ブラウザで資格情報を入れる
そのURLを開き、OAuthの許可、またはAPIキーの入力をします。
- 3
完了の報告を受ける
コネクタが作られると、Claudeが「照会できる状態になった」と伝えます。
追加済みのコネクタを消すときも、「Delete my Linear connector」のように頼むだけです。
業務データに質問する
接続後は、自然な文で質問します。Airbyteが例に挙げているのは次のような文です。
- Show me the 10 most recent Gong calls
- Find all open deals in Salesforce worth more than $50,000
- List HubSpot contacts who were created this week
- How many Zendesk tickets are in "open" status?
Claudeはコネクタが持つエンティティ(contactsやdealsなど)を調べ、スキーマを把握してから検索します。必要な項目だけを返すので、トークンの消費も抑えられます。
結果がずれたときは先にエンティティを確認させる
期待と違う結果が返るときの対処として、Airbyteは「クエリの前に、使えるエンティティを一覧させる」ことを挙げています。Claude Codeで繰り返し使うなら、プロジェクトの CLAUDE.md に手順として書いておく方法があります。次は書き方の一例です。
## Airbyte Agents MCPの使い方
- 業務データを検索する前に、対象コネクタのエンティティ一覧を確認する
- レコードの作成・更新・削除は、実行前に対象と内容を提示して承認を得る
- 相対日付(今週など)はUTCで返る。日本時間に直して報告する3行目は、MCPのタイムスタンプがUTCで返る仕様に合わせた一文です。日本時間での集計を頼む場面では、ずれの原因を先に潰せます。
検索が速い理由と、鮮度の限界
「Salesforceの商談で、今月クローズ予定のものを全部」のような質問は、APIに検索エンドポイントがないと、ページを順にたどる作業になります。コンテキストが膨らみ、時間もかかり、APIのレート制限にも当たります。
Airbyteはこの問題を、Context Storeで解決しています。Context Storeは、接続した各データソースの一部のエンティティを複製した、検索用の保管庫です。Claudeは1つの質問ごとに、次のどちらの経路を使うかを自動で選びます。
検索の2経路
Context Store検索
複製済みのデータに対し、絞り込み、並べ替え、集計をAPI呼び出しなしで行います。対象のエンティティがストアにあれば、こちらが優先されます。
直接リクエスト
サードパーティのAPIをその場で呼びます。ストアにないエンティティと、書き込み操作は必ずこちらです。
ここで押さえたいのは、Context Storeがリアルタイムではない点です。複製の頻度はプランで決まり、Freeプランは最初の2週間が毎時、その後は毎日です。IndividualとTeamは毎時です。
加えて、次の制約があります。
- すべての項目やレコードではなく、検索に役立つ一部だけが入る
- 初回のインデックスには数分から数日かかる。完了前でも「Preview」状態のエンティティは部分的に検索できる
- 書き込み(作成、更新、削除)には使えない
最新の件数が必要な質問で結果が古いと感じたら、コネクタ詳細ページの「Last Synced」で複製の時刻を確かめます。ストアの更新状況は、エンティティごとにここで見られます。
料金とAOの消費
課金の単位はAgent Operation(AO)です。ツール呼び出しの回数だけでなく、処理の重さを測る単位とされています。
プラン別の月間AO
Free
1,000 AO
月額$0。上限に達するとAOの処理は次の請求期間まで停止
Individual
5,000 AO
月額$29。超過分は課金
Team
10,000 AO
月額$299。複数ユーザー、SSOに対応
MCPで自分のエージェント(ここではClaude)を持ち込む場合、AOを消費するのはツール呼び出しだけです。Claudeの推論にかかるトークンは、Airbyte側では課金されません。一方、Webアプリのチャットはツール呼び出しと推論の両方がAOになります。
AOとツール呼び出しの換算式は公開されていません。1AOが1回の呼び出しとは限らないので、見積もりより実測が確実です。Billingページの使用量グラフで、MCP経由の消費を確かめます。Freeプランは超過ができないため、検証中に枠を使い切ると処理が止まる点に注意が要ります。
権限を絞って使う
業務データを預ける以上、Claudeに何を触らせるかの線引きは設計の中心になります。Airbyteは3つの層を用意しています。
- ワークスペース: 資格情報の隔離単位。あるワークスペースのトークンで別のワークスペースには入れない。複数のワークスペースはTeamとCustomのプラン
- ユーザーロール: AdminとMemberの2種類
- エンティティのアクセス権: コネクタの中で、メンバーごと、エンティティごと、読み書きごとに許可を決める
たとえば給与や顧客連絡先のエンティティだけを一部のメンバーに限り、同じコネクタは全員で共有する、といった分け方ができます。
呼び出しの記録は、設定画面の「Tool Calls」で見られます。各呼び出しは「Direct」(その場のAPI呼び出し)か「Search」(Context Storeの検索)かに分類されます。コストが急に増えた理由や、想定外の書き込みを調べるときの入口です。
つながらないときの切り分け
接続の切り分け
- QAirbyteのアカウントにログインできているか?答えがいいえのとき答えがはい
app.airbyte.aiでアカウントを作成または復旧します。新しい組織に参加した場合は、認可をやり直します。
- QURLが `https://mcp.airbyte.ai/mcp` と完全に一致しているか?答えがいいえのとき答えがはい
設定のURLを直してクライアントを再起動します。
- Q認可のトークンエラーが出ていないか?答えが出ていない答えがはい
MCPサーバーを一度削除して追加し直し、保存されたトークンを消します。
それでも使えないとき
コネクタ側の資格情報フローが途中で止まっている可能性があります。ブラウザのURLで入力を最後まで済ませたかを確かめ、タイムアウトしていたら、Claudeに新しいフローを始めさせます。
MCPで足りない用途はCLIやSDKを選ぶ
MCPが向くのは、ゼロインストールで、会話しながらデータを引く使い方です。大きな結果セットを処理する、1ターンで多数の呼び出しを連ねる、時間のかかる処理を回す、シェルのツールと組み合わせる、といった用途にはCLIが向くと案内されています。PythonでPydantic AIやLangChainのエージェントを作るならSDK、Python以外のバックエンドならAPIです。
ChatGPT側でも同じMCPを使う構成は、ClaudeのコネクタとChatGPTのアプリの違いで整理しています。
まとめ
Airbyte Agents MCPは、URL 1つと2回のブラウザ認可で、複数の業務アプリをClaudeの検索対象にできます。Freeプランは超過ができず、枠を使い切ると処理が止まります。まず1つのコネクタで、Context Storeの鮮度と書き込み系の挙動を確かめ、そのうえで他のアプリへ広げる進め方が安全です。