Skip to content

Commit 55585c3

Browse files
committed
feat(faq): 🕵️ add inspector troubleshooting step for MCP connection issues
1 parent 54119fc commit 55585c3

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

doc/faq.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,8 +134,26 @@ npm i @cloudbase/cloudbase-mcp@latest -g
134134
**5. 尝试全局安装**
135135
- 如果 npx 方式持续有问题,可以尝试[全局安装方式](#如何全局安装-cloudbase-ai-toolkit)
136136

137+
**6. 使用 inspector 工具验证 MCP 连接**
138+
- 如果上述方法都无效,可以通过 inspector 工具进一步排查 MCP 是否正常:
139+
```bash
140+
npx @modelcontextprotocol/inspector npx @cloudbase/cloudbase-mcp@latest
141+
```
142+
- 命令行会输出类似如下的网址:
143+
```
144+
http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=8fbe0137d3bd77f0181a66a0ced8476283ba2b25927f2d3fd84492dfa1eb2199
145+
```
146+
- 用浏览器打开该网址,填写如下信息:
147+
- **Command** 填写为 `npx`
148+
- **Arguments** 填写为 `@cloudbase/cloudbase-mcp@latest`
149+
- 然后点击 **Connect** 进行测试,需要等待安装和连接 MCP Server
150+
- 如果测试 OK,说明 MCP 工具本身连接正常,问题可能出在客户端配置或环境。
151+
- 如果连接失败,可以复制下方红色的错误信息,在 [社区 issue](https://cnb.cool/tencent/cloud/cloudbase/community/-/issues) 提交问题,便于进一步排查。
152+
137153
一般情况下,在 MCP 列表中重新启用或刷新即可正常安装并显示工具。
138154

155+
156+
139157
---
140158

141159
### MCP 配置不生效怎么办?

0 commit comments

Comments
 (0)