MCP(Model Context Protocol)是一種開放協定,用於在大型語言模型(LLM)應用程式與外部資料來源和工具之間建立標準化通訊。Apidog 內建 MCP Client,支援對 MCP Servers 進行除錯與測試。MCP Servers 提供三項主要功能,Apidog MCP Client 均支援對其進行除錯:STDIO:透過標準輸入/輸出進行通訊,適用於本機程序
HTTP:透過 Streamable HTTP 進行通訊,適用於遠端伺服器
請使用網頁版,或從首頁下載最新版本的桌面應用程式。
建立 MCP Client#
在 HTTP 專案中建立新的端點,並選擇 MCP。
連線至 MCP Server#
輸入伺服器位址#
Apidog 支援多種方式輸入 MCP Server 連線資訊: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 會自動擷取伺服器名稱、位址、環境變數及其他資訊。如果設定檔包含多個伺服器,將會使用第一個。建立連線#
由於需要執行本機命令,Apidog 會顯示安全確認對話框。確認後,將啟動本機程序並建立連線。對於使用 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 程序時設定環境變數。| Key | Value |
|---|
| ACCESS_TOKEN | your-token-here |
| NODE_ENV | production |
Auth#
對於支援 OAuth 2.0 的 MCP Servers,Apidog 可以自動擷取並填入驗證設定。僅適用於 HTTP 模 式。用於設定自訂 HTTP 請求標頭。
檢視回應#
點擊 Run 後,工具執行結果將顯示在 Response 面板中。Apidog 將互動分為兩種類型:Messages 和 Notifications。Messages#
Message 代表標準的請求-回應互動(例如執行工具並接收結果)。針對每則訊息,Apidog 提供三種檢視模式,協助你將資料視覺化。你可以使用回應區域頂部的分頁在它們之間切換:Content: 預設檢視。顯示乾淨的文字輸出。Apidog 會解析 JSON-RPC 訊息,並僅擷取工具回傳的核心內容(例如 text 欄位),移除協定細節以便閱讀。
Preview: 轉譯工具回傳的豐富內容。如果回應包含 Markdown、images 或其他多媒體資源,此分頁會自動將其轉譯為視覺格式(例如格式化文字、圖表或解碼後的 Base64 圖片)。這可免除手動解碼或解析原始文字的需求。
Raw: 顯示完整的 JSON-RPC 互動訊息,包含所有協定細節(例如 jsonrpc、id 和 result 結構)。在除錯 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 表示布林值。