本文介绍如何通过控制台和MCP Inspector调试MCP服务。
通过控制台调试MCP服务
在AI 网关控制台的实例页面,选择您实例所在的地域。
进入目标实例页面,选择左侧导航栏的MCP管理。
在MCP管理页面,单击目标MCP服务卡片。
单击调试页签,控制台会自动跟后端MCP Server建立连接,同时您可以在控制台查看连接建立状态。
说明如果连接失败会有对应的错误提示,建连失败的常见原因如下:
如果使用的是AI网关提供的测试域名,存在调用限额,每天整个域名限额1000次。
如果使用的是自定义域名,需要确保此域名在公网可解析,且此域名解析的地址公网可达。
如果开启了消费者鉴权,请确保使用的认证信息正确。
不支持内网域名调试。
如果开启了消费者认证,需要选择对应已授权消费者作为请求参数传入。
单击获取工具,选择您需要使用的工具,填入工具参数即可在线调试。
如果所选消费者只授权了MCP工具级别消费者认证,且仅授权某些工具的情况下,HTTP转MCP的场景中获取工具列表只能看到和调用有权限的工具;直接代理场景调试的时候能看到全部工具,选择授权的工具调用是ok的,没权限的会403。
通过MCP Inspector调试MCP服务
建议在本地启动MCP Inspector进行MCP调试。
MCP Inspector是MCP社区提供的调试工具,可用于MCP服务全流程的调试。
执行MCP Inspector安装命令:
npx @modelcontextprotocol/inspector node build/index.js
。访问MCP Inspector界面,例如通过浏览器登录以下地址:
http://127.0.0.1:6274
。配置连接信息。
选择传输类型:
Transport Type
选择SSE
。输入
URL
地址:在MCP管理的基本信息页右侧获取。(可选)若配置了消费者认证,单击
Authentication
安装展开授权配置,并填写消费者身份对应的Token。以下图的凭证配置为例,Header Name
为Authorization
不需要修改,在Bearer Token
中填入HereIsToken
。
单击
Connect
进行连接,连接成功后可以看到中间出现List Tools
按钮,单击List Tools
获取MCP服务的所有工具。(可选)若要调试具体的工具,点击工具名称,在右侧填写必要的参数,并单击
Run Tool
进行工具调用调试。