Claude を使って API をデバッグする方法

Published: 2026-07-14 | Jan Procházka

API のデバッグというと、たいていは Postman コレクションを行ったり来たりしながら、使い捨てスクリプトを書いたり、単純な疑問に答えるためだけに手作業でクエリを組み立てたりします。たとえば 「なぜこのフィールドは null なのか？」 や 「どの注文が詰まっているのか？」 といった質問です。もしそれをただ 質問するだけ で済ませられたらどうでしょうか。

DbGate Central には、AI アシスタント（Claude など）にあなたの API 接続を公開するための MCP（Model Context Protocol） サーバーが組み込まれています。一度接続してしまえば、Claude はあなたと同じように、チャットから直接、ライブな GraphQL、Business Central（oData）、Shopify 接続を探索・クエリできます。しかも、アクセス権は常にあなたの管理下にあります。

このガイドでは、数分でセットアップする方法と、その後 Claude を使って 3 種類すべてをデバッグする方法を説明します。

DbGate Central を開く →

なぜ Claude で API をデバッグするのか？

読み取り・書き込みは DbGate Central のグリッドと同じエンジンを再利用しているため、Claude が見られるデータと機能は、あなたが許可した範囲とまったく同じで、それ以上になることはありません。 そのため、Claude は自然なデバッグの相棒になります。

「このエンティティのスキーマは実際どうなっているの？」
「このフィールドが null のレコードを探して、共通点を教えて。」
「どの注文が未出荷で、その理由は？」

あなたは問題を自然言語で説明し、Claude がスキーマを調べ、クエリを実行し、結果をもとに推論します。会話から離れる必要はありません。

必要なもの

デバッグしたい接続が追加済みの DbGate Central ワークスペース
- GraphQL エンドポイント
- oData エンドポイント（ここでは Microsoft Dynamics 365 Business Central を例にします）
- および / または Shopify ストア
  まだ追加していない場合は、API エンドポイントへの接続を参照してください。
カスタムコネクタ をサポートする Claude アカウント

ステップ 1 - DbGate Central で MCP プロファイルを作成する

設定タブ（アクティビティバー下部の歯車アイコン）を開き、新しい MCP プロファイル を作成します。プロファイルから、後で必要になる 3 つの値が得られます。

Server URL - https://central.dbgate.cloud/mcp/{profileId} の形式
Client ID
Client Secret

この 3 つをすべてコピーします。各ワークスペースには 複数の MCP プロファイル を持たせることができ、それぞれに独自の URL、認証情報、接続ごとの権限があります。そのため、スコープの狭いアクセス権を渡すことができます（例: ある 1 つの読み取り専用接続だけを見られるプロファイル）。

ステップ 2 - claude.ai にカスタムコネクタを追加する

claude.ai で、前のステップで取得した Server URL を使って カスタムコネクタ を追加し、Client ID と Client Secret を OAuth 認証情報として設定します。

その後、Claude は OAuth 2.1 with PKCE のハンドシェイクを実行します。あなたは DbGate にサインインし、同意を求められます。これにより、そのコネクタが特定の MCP プロファイルとワークスペースに紐づきます。クライアントシークレットは保存時に暗号化され、このステップを完了するまで、あなたのデータに関する情報は一切共有されません。

Configuring the DbGate Central custom connector in claude.ai
claude.ai で DbGate Central のカスタムコネクタを追加する様子

ステップ 3 - 接続ごとのアクセス権を付与する

デフォルトでは、MCP プロファイルはすべてに対して No access です。つまり、プロファイルを接続しただけでは何も共有されません。Claude にアクセスさせたい各接続について、そのエディタを開き、MCP access レベルを設定します。

No access（デフォルト） - 接続はエージェントから見えません。
Read-only - エージェントは一覧表示、スキーマ確認、クエリ実行はできますが、変更はできません。
Writable - エージェントは行の更新も可能です（Shopify のみ。後述）。

デバッグ用途の無難な出発点としては、GraphQL と Business Central 接続を Read-only にし、Shopify については、Claude に実際に変更させたい場合にのみ Writable を付与するのがよいでしょう。

Claude にできること

一度接続を共有すると、Claude は oData、GraphQL、Shopify 接続に対して次のツールを利用できます。

接続の一覧取得 - そのプロファイルで利用を許可された接続の一覧
エンティティの一覧取得 - テーブル、ビュー、カタログエンティティ
スキーマの確認 - カラム名と型
行のクエリ - フィルタ、ページング、列の選択
行の更新 - Shopify のみ、かつ Writable アクセスが付与されている場合のみ

API タイプごとのデバッグ

ここでは、接続タイプごとに、実際のデバッグセッションがどのように見えるかを示します。プロンプトは平易な英語で、イタリック の部分は Claude が裏側で実行するツール呼び出しです。

GraphQL

GraphQL の柔軟性は、同時にデバッグの難しさにもつながります。クエリが黙って null を返し、スキーマなのか、引数なのか、データなのか、どこに原因があるのかを推測するしかない、という状況になりがちです。そこで、スキーマの探索を Claude に任せます。

You: In my GraphQL connection, list the available entities, show me the schema of orders, then find any orders where total is null and tell me what they have in common.

Claude は list_entities を実行してビューを列挙し、get_schema を orders に対して実行してフィールドと型を確認し、続いて query_rows で問題のレコードを取得します。そのうえで結果を分析し、たとえばすべてのレコードで関連する payment ノードが欠けている、といったパターンを見つけます。

oData - Business Central

Microsoft Dynamics 365 Business Central は、データを oData V4 サービスとして公開しており、DbGate Central はこれを通常のテーブル群として扱います。そのため、顧客、請求書、元帳仕訳などの ERP データを、自然言語でクエリできるようになります。

You: In my Business Central connection, find the sales invoices for customer “Contoso” from last month, and total their amounts.

Claude は query_rows を使い、あなたの依頼を裏側で oData のクエリオプションに変換します。$filter で顧客と日付範囲を絞り込み、$select で取得する列を選び、$top / $skip でページングし、その結果を合計して返します。

Shopify

Shopify ストアの場合、DbGate Central は Shopify Admin API を通じて接続し、商品、注文、顧客、メタフィールドなどを公開します。

You: Find order #1043 and tell me why its fulfillment is stuck.

Claude は Shopify 接続に対して query_rows を実行し、その注文を特定して、出荷および明細行のステータスを確認します。

そして、Writable アクセスを付与している場合に限り、修正も行えます。

You: Add the tag needs-review to that order.

Claude は update_rows を使用します。これは Shopify のみで利用可能で、Writable アクセスが必須 です。Claude は一致条件と値でレコードを特定し、指定された更新を適用します。読み取り専用接続ではこのツール自体が利用できないため、意図せずデータが変更されることはありません。

コントロールは常にあなたの手に

MCP サーバーは、AI アシスタントとワークスペースを共有しても、コントロールを手放さずに済むように設計されています。

デフォルトでは何も共有されない - すべての接続は No access から始まります。
接続ごとの権限付与 - MCP プロファイルごとに、どの接続を Read-only / Writable にするかを細かく決められます。
書き込みはオプトインかつ限定的 - update_rows は Shopify にしか存在せず、Writable アクセスがある場合にのみ利用できます。
セキュアな設計 - 認証には OAuth 2.1 with PKCE を使用し、クライアントシークレットは保存時に暗号化されます。
あなた以上の権限は持たない - エージェントはグリッドと同じエンジンを使うため、あなたとまったく同じデータと機能だけを見ます。

まとめ

DbGate Central の MCP プロファイルと claude.ai のカスタムコネクタを組み合わせることで、Claude は GraphQL、Business Central（oData）、Shopify API の実践的なデバッグパートナーになります。スキーマを確認し、クエリを実行し、あなたが許可した範囲で修正も適用できます。一度セットアップし、必要なものだけに権限を与えたら、クエリを書く代わりに質問を投げかけるだけで済むようになります。