MCP（Model Context Protocol）是一种开放协议，用于在大型语言模型（LLM）应用程序与外部数据源和工具之间建立标准化通信。Apidog 内置了 MCP 客户端，支持调试和测试 MCP 服务器。MCP 服务器提供三项主要功能，Apidog MCP 客户端均支持对其进行调试：STDIO：通过标准输入/输出进行通信，适用于本地进程
HTTP：通过 Streamable HTTP 进行通信，适用于远程服务器
请使用网页版，或从首页下载最新版本的桌面应用程序。
创建 MCP 客户端#
在 HTTP 项目中创建一个新端点，并选择 MCP。
连接到 MCP 服务器#
输入服务器地址#
Apidog 支持通过多种方式输入 MCP 服务器连接信息：https://example-server.modelcontextprotocol.io/mcp
{
"mcpServers": {
"Everything Server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"],
"env": {}
}
}
}
{
"type": "streamable-http",
"url": "https://example-server.modelcontextprotocol.io/mcp"
}
建立连接#
由于需要执行本地命令，Apidog 会显示安全确认对话框。确认后，它将启动本地进程并建立连接。对于使用 OAuth 2.0 认证的 MCP 服务器，Apidog 会自动获取认证配置并显示认证窗口
其他认证方式（API Key、Bearer Token、Basic Auth 等）也可以在 Auth 标签页中手动配置
调试功能#
Tools 是服务器提供的可执行函数。选择一个 Tool 后，你可以通过表单或 JSON 编辑器配置参数。配置参数后，点击 Run 执行。结果将显示在响应区域中。Prompts#
Prompts 是预定义的提示词模板。选择一个 Prompt 后，配置参数（如有），然后点击 Run 获取生成的提示词。Resources#
Resources 是服务器提供的数据资源。选择一个 Resource 后，点击 Run 获取资源内容。
配置选项#
仅适用于 STDIO 模式。用于在启动 MCP 服务器进程时配置环境变量。| Key | Value |
|---|
| ACCESS_TOKEN | your-token-here |
| NODE_ENV | production |
Auth#
对于支持 OAuth 2.0 的 MCP 服务器，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 服务器并验证协议合规性时，请使用此模式。
Notifications#
Notification 表示来自 MCP 服务器的单向消息（例如日志、进度更新或资源变更），不需要响应。Notifications 会在响应时间线中单独列出。
它们通常显示日志级别（例如 info、debug、error）及相应的消息文本。
变量支持#
以下位置支持变量 {{variable_name}}：
保存和共享#
已配置的 MCP 客户端可以保存到项目中，便于后续使用和团队协作。注意：MCP 目录树（Tools、Prompts、Resources 列表）仅存储在本地，并会在每次连接时自动刷新。
FAQ#
STDIO 连接失败并显示 “command not found” 错误#
确保已安装所需运行时（如 Node.js），并检查命令路径是否正确。HTTP 连接返回 401 错误#
Apidog 会自动尝试获取 OAuth 2.0 配置。如果失败，请在 Auth 标签页中手动配置认证信息。连接成功但目录树为空#
检查服务器配置是否正确，并查看 Notifications 标签页以确认服务器是否已返回工具列表。参数类型不匹配#
使用表单模式时，Apidog 会自动验证参数类型。在 JSON 编辑器模式下，请注意不要给数字加引号，并对布尔值使用 true/false。 