MCP(Model Context Protocol)は、大規模言語モデル(LLM)アプリケーションと外部データソースおよびツールの間で標準化された通信を確立するためのオープンプロトコルです。Apidog には、MCP Server のデバッグとテストをサポートする MCP Client が組み込まれています。MCP Servers は主に 3 つの機能を提供しており、そのすべてが Apidog MCP Client によるデバッグに対応しています。Prompts: 事前定義されたプロンプトテンプレート
Resources: サーバーによって提供されるデータリソース
STDIO: 標準入力/出力を介した通信で、ローカルプロセスに適しています
HTTP: Streamable HTTP を介した通信で、リモートサーバーに適しています
Web 版を使用するか、ホームページからデスクトップアプリケーションの最新バージョンをダウンロードしてください。
MCP Client を作成する#
HTTP プロジェクトで新しいエンドポイントを作成し、MCP を選択します。
MCP Server に接続する#
サーバーアドレスを入力する#
Apidog は、MCP Server の接続情報を入力するための複数の方法をサポートしています。ターミナルコマンドを貼り付けると、プロトコルは自動的に STDIO に切り替わります。URL を貼り付けると、プロトコルは自動的に HTTP に切り替わります。https://example-server.modelcontextprotocol.io/mcp
Apidog は、MCP Server の設定ファイルを直接貼り付けることをサポ ートしており、関連情報を自動的に解析して入力します。{
"mcpServers": {
"Everything Server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"],
"env": {}
}
}
}
{
"type": "streamable-http",
"url": "https://example-server.modelcontextprotocol.io/mcp"
}
設定ファイルを貼り付けると、Apidog はサーバー名、アドレス、環境変数、その他の情報を自動的に抽出します。設定ファイルに複数のサーバーが含まれている場合は、最初のサーバーが使用されます。接続を確立する#
Connect ボタンをクリックして接続を開始します。ローカルコマンドの実行が必要なため、Apidog はセキュリティ確認ダイアログを表示します。確認後、 ローカルプロセスを開始し、接続を確立します。指定された URL に接続リクエストを直接送信します。OAuth 2.0 認証を使用する MCP Servers の場合、Apidog は認証設定を自動的に取得し、認証ウィンドウを表示します
その他の認証方式(API Key、Bearer Token、Basic Auth など)も、Auth タブで手動設定できます
接続に成功すると、ディレクトリツリーにサーバーによって提供される Tools、Prompts、Resources の一覧が表示されます。
デバッグ機能#
Tools は、サーバーによって提供される実行可能な関数です。Tool を選択した後、フォームまたは JSON エディターでパラメータを設定できます。パラメータを設定した後、Run をクリックして実行します。結果はレスポンスエリアに表示されます。Prompts#
Prompts は、事前定義されたプロンプトテンプレートです。Prompt を選択した後、パラメータ(存在する場合)を設定し、Run をクリックして生成されたプロンプトを取得します。Resources#
Resources は、サーバーによって提供されるデータリソースです。Resource を選択した後、Run をクリックしてリソース内容を取得します。
設定オプション#
STDIO モードでのみ利用できます。MCP Server プロセスを開始する際に環境変数を設定するために使用します。| キー | 値 |
|---|
| ACCESS_TOKEN | your-token-here |
| NODE_ENV | production |
Auth#
HTTP モードでのみ利用できます。複数の認証方式をサポートしています。OAuth 2.0 をサポートする MCP Servers の場合、Apidog は認証設定を自動的に取得して入力できます。HTTP モードでのみ利用できます。カスタム HTTP リクエストヘッダーを設定するために使用します。
レスポンスを表示する#
Run をクリックすると、ツールの実行結果が Response パネルに表示されます。Apidog は、インタラクションを Messages と Notifications の 2 種類に分類します。Messages#
Message は、標準的なリクエスト・レスポンスのインタラクション(例: ツールを実行して結果を受け取ること)を表します。各メッセージについて、Apidog はデータを視覚化しやすくするために 3 つの表示モードを提供しています。レスポンスエリア上部のタブを使用して切り替えることができます。Content: デフォルトの表示です。整形されたテキスト出力を表示します。Apidog は JSON-RPC メッセージを解析し、ツールから返された中核的な内容(例: text フィールド)のみを抽出し、プロトコルの詳細を取り除くことで読みやすくします。
Preview: ツールから返されたリッチコンテンツをレンダリングします。レスポンスに Markdown、画像、またはその他のマルチメディアリソースが含まれている場合、このタブはそれらを視覚的な形式(例: 書式設定されたテキスト、チャート、またはデコードされた Base64 画像)に自動的にレンダリングします。これにより、手動でのデコードや生テキストの解析が不要になります。
Raw: jsonrpc、id、result 構造など、すべてのプロトコル詳細を含む完全な JSON-RPC インタラクションメッセージを表示します。MCP servers をデバッグしてプロトコル準拠を確認する場合に、このモードを使用します。
Notifications#
Notification は、レスポンスを必要としない MCP server からの一方向メッセージ(例: ログ、進行状況の更新、またはリソース変更)を表します。Notifications はレスポンスタイムラインに個別に一覧表示されます。
通常、ログレベル(例: info、debug、error)と付随するメッセージテキストが表示されます。
変数サポート#
変数 {{variable_name}} は、次の場所でサポートされています。
保存と共有#
設定済みの MCP clients は、後続の使用やチームコラボレーションのためにプロジェクトに保存できます。注: MCP ディレクトリツリー(Tools、Prompts、Resources の一覧)はローカルにのみ保存され、接続ごとに自動的に更新されます。
FAQ#
STDIO 接続が "command not found" エラーで失敗する#
必要なランタイム(Node.js など)がインストールされていることを確認し、コマンドパスが正しいことを確認してください。HTTP 接続で 401 エラーが返される#
Apidog は OAuth 2.0 設定の取得を自動的に試行します。失敗した場合は、Auth タブで認証情報を手動設定してください。接続は成功したがディレクトリツリーが空である#
サーバー設定が正しいことを確認し、Notifications タブを表示してサーバーがツール一覧を返しているかどうかを確認してください。パラメータ型の不一致#
フォームモードを使用する場合、Apidog はパラメータ型を自動的に検証します。JSON エディターモードでは、数値を引用符で囲まないようにし、ブール値には true/false を使用してください。