拉取远端 MCP 工具列表
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
starops:FetchRemoteMcpTools |
none |
*全部资源
|
无 | 无 |
请求语法
POST /mcptools HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求体参数。 |
|
| network |
object |
否 |
请求体参数。 |
|
| mode |
string |
否 |
MCP 服务网络访问模式，支持 public 和 vpc。 |
public |
| vpcId |
string |
否 |
专有网络 VPC ID。 |
vpc-xxx |
| vswId |
string |
否 |
交换机 ID。 |
vsw-xxx |
| accessIp |
string |
否 |
VPC 网络下访问 MCP 服务的 IP 地址。 |
10.0.0.12 |
| accessPort |
integer |
否 |
VPC 网络下访问 MCP 服务的端口，取值范围为 1 到 65535。 |
8080 |
| securityGroupId |
string |
否 |
安全组 ID。 |
sg-xxx |
| gatewayId |
string |
否 |
网关 ID。 |
gw-xxx |
| mcpServerId |
string |
否 |
MCP Server 实例 ID。 |
mcp-xxx |
| region |
string |
否 |
VPC 网络所在地域。 |
cn-hangzhou |
| connection |
object |
是 |
请求体参数。 |
|
| platform |
string |
否 |
MCP 服务平台类型，支持 AIGateway 和 Custom。 |
Custom |
| transport |
string |
是 |
MCP 服务传输协议，支持 http 和 sse。 |
http |
| endpoint |
string |
是 |
MCP 服务访问地址。 |
https://example.com/mcp |
| timeout |
integer |
否 |
请求 MCP 服务的超时时间，单位为毫秒。 |
5000 |
| auth |
object |
否 |
请求体参数。 |
|
| type |
string |
否 |
认证类型，目前支持 bearer。 |
bearer |
| keyInfo |
object |
否 |
请求体参数。 |
{"token":"example-token"} |
|
string |
否 |
认证键值信息。 |
example-token |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
接口返回数据。 |
||
| requestId |
string |
请求 ID。 |
0B9377D9-C56B-5C2E-A8A4-************ |
| tools |
string |
远端 MCP 服务返回的 tools/list 原始响应。 |
{"jsonrpc":"2.0","id":1,"result":{"tools":[]}} |
示例
正常返回示例
JSON格式
{
"requestId": "0B9377D9-C56B-5C2E-A8A4-************",
"tools": "{\"jsonrpc\":\"2.0\",\"id\":1,\"result\":{\"tools\":[]}}"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。