MCP 服务配置

前提条件

• 已创建至少一个数字员工。具体操作，请参见创建数字员工。

• 已部署 MCP 服务，且服务处于运行状态。MCP 服务可以部署在以下环境中：

  • 公网可访问的服务器

  • 阿里云 VPC 内的 ECS 或 ACK 集群（需通过 VPC 模式接入）

  • 函数计算 FC

  • 百炼平台托管的 MCP 工具

• 如果使用 VPC 模式，需要准备以下网络信息：

  • 服务所在的 VPC ID

  • 安全组 ID

  • MCP 服务的内网 IP 地址和监听端口

  说明 直连模式要求 MCP 服务的访问地址在公网可达。VPC 模式适合私网 ECS/ACK 场景，系统会创建或复用反向访问链路，但受可用区资源限制。请根据实际网络环境选择合适的接入方式。

添加 MCP 服务

添加流程分为 4 步：选择访问网络 → 填写服务地址 → 拉取工具列表 → 选择可调用工具。

STAROps 支持两种网络模式：

添加 MCP 服务时连接超时

1. 确认 MCP 服务地址格式正确，包含完整的协议、IP/域名、端口和路径（如 http://xx.xx.xx.xx:8080/mcp）。

2. 确认 MCP 服务正在运行且端口监听正常。

3. 如果使用直连模式，检查公网访问是否可达：

   curl -X POST http://<MCP 服务地址>/mcp \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}'
   
   Responses: {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-03-26","capabilities":{"tools":{}},"serverInfo":{"name":"k8s-mcp","version":"0.1.0"}}}

4. 如果使用 VPC 模式，检查 VPC、交换机、安全组配置是否正确，安全组出方向规则是否放行了 MCP 服务端口。

工具列表为空或工具同步失败

工具列表依赖 MCP 服务端的 Tool 注册信息。如果列表为空或不完整，请尝试以下操作：

1. 确认 MCP 服务端已正确注册 Tool，且服务处于运行状态。

2. 单击获取工具列表手动触发重新拉取。

MCP 服务状态显示不可用

MCP 服务不可用通常由以下原因导致：

• 服务端进程异常退出或未启动。请检查 MCP 服务的运行状态。

• 证书过期或认证失败。如果使用 HTTPS 端点，请确认 TLS 证书有效。

• 函数计算冷启动超时。使用函数计算部署的 MCP 服务，首次调用可能超时，重试即可恢复。