用 MCP 连接器为 MonstarX 提供工具
要点在“后端 → 云服务 → 连接器 → MCP”中,填写名称和 HTTPS 地址添加一个远程 MCP 服务器,或粘贴 JSON 配置一次添加多个。MonstarX 会检查连接、列出服务器的工具,之后就能在该项目的构建模式中使用它们。每个项目最多 32 个服务器。
MCP(模型上下文协议,Model Context Protocol)是 AI 工具之间互相提供能力的一种通用方式。MCP 服务器是提供一组工具的服务:搜索某些文档、在公司系统中查询信息、执行某项任务。如今很多产品都提供了自己的 MCP 服务器。
把 MCP 服务器连接到项目后,MonstarX 的构建助手在开发这个应用时就能使用其中的工具。例如,连接一个文档服务器,然后说“查一下支付服务商的文档,按他们推荐的方式构建退款流程”。
- 你需要服务器的公开 HTTPS 地址,可以在服务商的文档中找到。它通常以
/mcp或/sse结尾。 - 如果服务器要求登录,请从服务商那里获取访问令牌或 API 密钥。
如何添加 MCP 服务器?
Section titled “如何添加 MCP 服务器?”-
打开项目,点击顶部栏中的后端,再点击云服务。
-
在连接器中找到 MCP 卡片,点击添加服务器。
-
填写表单:
- 服务器名称:任意一个你认得出的名字,比如“文档搜索”。
- 服务器 URL:服务器的 HTTPS 地址。
- 连接类型:新型服务器选 Streamable HTTP;如果服务商给你的是 SSE 地址,选旧版 SSE。
- Bearer 令牌(选填):如果服务器需要,填写访问令牌。
- 自定义请求头(JSON,选填):用于要求把密钥放在自定义请求头中的服务器,比如
{ "X-Api-Key": "…" }。
-
点击连接并检查工具。MonstarX 会先连接服务器并列出它的工具,然后才保存。如果连接失败,什么都不会保存,并且会告诉你该检查什么。
可以一次添加多个服务器吗?
Section titled “可以一次添加多个服务器吗?”可以,前提是你已经有其他工具中的 MCP 配置。点击导入 JSON(而不是添加服务器),粘贴一个 mcpServers 对象,然后点击连接并检查工具:
{ "mcpServers": { "documentation": { "url": "https://mcp.example.com/mcp" }, "workspace": { "type": "http", "url": "https://tools.example.org/mcp", "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } }, "legacy": { "type": "sse", "url": "https://legacy.example.net/sse" } }}MonstarX 会在保存之前检查每一个服务器。每个名称都必须不同。在你电脑上启动程序的服务器(用 command 而不是 url)无法导入。
MonstarX 如何使用这些工具?
Section titled “MonstarX 如何使用这些工具?”服务器连接并启用后,MonstarX 就会了解它的工具,以及什么时候该用。像平常一样在聊天中提出需求,必要时提一下服务器的名字:“用文档搜索服务器查一下 webhook 是怎么运作的”。
- 构建模式可以查看并使用这些工具。
- 规划和聊天模式能看到有哪些工具,但不能使用。
- 两个服务器可以有同名的工具,MonstarX 会把它们区分开。
- 导入的应用同样适用。
如何管理已连接的服务器?
Section titled “如何管理已连接的服务器?”MCP 卡片中的每个服务器都会显示工具数量和以下按钮:
- 点击工具数量,查看它提供的工具。
- 检查连接会重新连接并刷新工具列表,适用于服务商新增了工具的情况。
- 禁用会让 MonstarX 停止使用该服务器,即使是正在运行的请求也会立即停用。启用则重新开启。
- 移除会在你确认后,删除该服务器及其已保存的凭据。
哪些情况不支持?
Section titled “哪些情况不支持?”- 在你自己电脑上运行(通过命令启动)的服务器,或位于私有网络、
localhost上的服务器。地址必须是公开的 HTTPS 地址。 - 通过弹出窗口登录(交互式 OAuth)。请从服务商那里获取令牌,作为 Bearer 令牌粘贴。
- 刷新会过期的令牌。令牌过期后,请移除服务器,再用新令牌重新添加。
- MCP 资源(resources)和提示(prompts),以及需要反过来向 MonstarX 提问的服务器(sampling 或 elicitation)。MonstarX 只使用工具。
- 每个项目最多 32 个服务器。
- 凭据严格保密。 地址以及任何令牌或请求头都会加密保存,永远不会出现在聊天、应用代码或已发布的应用中。
- 只作用于一个项目。 服务器只属于你添加它的那个项目,而且只有项目所有者能添加。
在哪里找到 MCP 服务器的地址?
在服务商自己的文档中,通常位于“MCP”或“AI 集成”之类的章节下。它是一个 HTTPS 地址,常以 /mcp 结尾。
为什么 MonstarX 在聊天模式下不能使用这些工具?
工具可能会修改其他系统中的内容,所以 MonstarX 只在构建模式下运行它们。聊天和规划模式仍然可以看到服务器有哪些工具。
服务器要求我登录,怎么办?
向服务商索取访问令牌或 API 密钥,粘贴到 Bearer 令牌(选填)中;如果服务商指定了其他请求头,则填到自定义请求头中。
我的令牌过期了,怎么更新?
移除该服务器,再用新令牌重新添加。MonstarX 不会自动刷新令牌。