如何添加自定义 MCP 服务器?
通过模型上下文协议(MCP),AI 模型可以访问外部工具和数据源,从而实现更强大的功能。ConsoleX AI 提供对基于 MCP 工具的全面支持,包括支持基于 SSE 和基于 Stdio 的 MCP 服务器。
在 ConsoleX 中集成和使用 MCP 服务器
在 ConsoleX AI 中添加和使用 MCP 服务非常简单,只需按照以下步骤操作:
- 登录 ConsoleX AI,点击左下角的 工具库(Tools Vault) 入口。
- 点击页面顶部的 添加 MCP 服务器(Add a MCP server) 按钮。
- 填写 MCP 服务器的 JSON 描述信息。
- 点击 保存(Save) 按钮,完成 MCP 服务器的集成。
如何配置基于 SSE 的 MCP 服务器
在 ConsoleX AI 中配置并添加基于 SSE 的 MCP 服务器非常简单,只需输入以下格式的配置:
{
"url": "<your_sse_mcp_server_endpoint>"
}
您还可以添加其他参数,这些参数将通过头部属性传递到服务器。例如,可以添加头部身份验证或传递其他配置参数:
{
"url": "<your_sse_mcp_server_endpoint>",
"Authorization": "Bearer <your_auth_token>",
"timezone": "Europe/Berlin"
}
注意: SSE 服务器需要自行从头部提取参数用于认证或功能逻辑处理。
如何配置基于 Stdio 的 MCP 服务器
ConsoleX 是一项云服务,因此无法直接通过 Stdio 调用本地资源。但您可以使用 MCP-connect 来实现中继,并启用基于 Stdio 传输协议的 MCP 服务器调用。
具体步骤如下:
- 在您的本地计算机上安装并运行
mcp-connect
,并为安全性设置auth_token
。 - 通过隧道服务(如 ngrok 或 Cloudflare Zero Trust)使您的 MCP 代理 URL 可通过公共网络访问。
- 在 ConsoleX 的 设置(Settings) 中输入全局 MCP 代理 URL 和
auth_token
。 - 之后,您可以像使用本地 MCP 客户端一样在 ConsoleX 中添加基于 Stdio 的 MCP 服务器配置。
个别配置:
除了设置全局代理终端和 auth_token
,您还可以为每个 MCP 服务器单独设置 bridge_url
和 auth_token
。个别设置将覆盖全局配置。
例如:
{
"bridge_url": "<your_mcp_bridge_url>",
"auth_token": "<your_auth_token>",
"command": "uvx",
"args": ["mcp-server-fetch"]
}
常见问题解答
问:哪些模型支持 MCP 服务器?
答:MCP 协议由 Anthropic 发起,因此 Claude 的 Sonnet 和 Opus 模型系列可以更好地支持 MCP 服务器调用。不过,MCP 服务器的工具部分对支持工具调用的任何其他大模型同样适用。
问:在 ConsoleX 中使用 MCP 服务器有哪些限制?
答:您无法直接在 ConsoleX 中添加基于 Stdio 的 MCP 服务器,但可以通过 MCP Bridge 实现基于 Stdio 传输协议的 MCP 调用。
问:无法成功添加本地基于 Stdio 的 MCP 服务器时,我该怎么办?
答:
- 首先,请确保
mcp-connect
已成功安装并运行。 - 确认
mcp-connect
终端能够通过公共网络访问(可以通过健康检查终端验证)。 - 如果终端可访问但仍有问题,请检查在终端中运行的
mcp-connect
的输出日志,以找到问题原因。