将 Cursor 连接到 MCP 网关
Cursor 可以作为远程 Streamable HTTP 客户端连接到 AISIX MCP 端点。它发送 AISIX 调用方 API Key，仅发现该密钥有权使用的工具，并通过网关调用这些工具，无需获取上游服务器凭证。
Cursor 继续负责选择模型、决定何时请求工具、获取所需批准和展示结果。此连接将 MCP 工具流量发送到 AISIX，不会将 Cursor 的模型请求路由到网关。要单独路由受支持的 Ask 模式模型请求，请参阅 Cursor 模型集成。
本指南将 Cursor 连接到聚合的 /mcp 端点。你可以接着设置 MCP 网关继续操作，该指南仅向调用方授予 everything__echo 权限；也可以使用现有 AISIX 环境，以及调用方有权访问且可安全调用的工具。
前置条件
开始之前，请准备以下内容：
- 完成设置 MCP 网关并保留
AISIX_PROXY和AISIX_MCP_KEY，或向网关运维团队获取 AISIX 代理源地址和调用方 API Key。对于现有环境，请使用这两个变量名导出相应值，并选择一个已获许可且可安全调用的工具进行验证。 - 安装 Cursor，并配置支持 Agent 的模型。
- 确保 Cursor 可访问 AISIX 代理 URL。运行在网关宿主机上的 Cursor 可以使用快速入门中的地址；远程开发环境则需要使用其可访问的地址。
本示例使用工作区配置，以便随项目审查连接设置。不要提交调用方 API Key，Cursor 会从环境中读取它。
配置连接
从已导出 AISIX_MCP_KEY 的 Shell 启动 Cursor。如果 Cursor 已在运行但未继承该变量，请先关闭它，再从该环境重新启动，然后测试连接。
在工作区中创建 .cursor/mcp.json，将示例 URL 替换为 $AISIX_PROXY/mcp：
{
"mcpServers": {
"aisix": {
"url": "https://gateway.example.com/mcp",
"headers": {
"Authorization": "Bearer ${env:AISIX_MCP_KEY}"
}
}
}
}
如果需要在所有工作区中使用该连接，请将同一个对象添加到 ~/.cursor/mcp.json。确保使用此配置的每个 Cursor 进程均可读取该环境变量。
打开 Customize → MCPs，选择 aisix；如果工作区来源已禁用，请将其启用。确认本地环境已连接，并显示所选的已授权工具。对于 Everything 测试服务，应仅显示 everything__echo。
验证工具调用
以下提示词使用设置指南中的 Everything 测试服务。对于现有 MCP 服务器，请替换为已授权的工具名称、有效参数和预期结果。在 Cursor Agent 聊天中明确要求使用指定工具，不要依赖自动工具选择：
使用 MCP 工具 everything__echo，消息为 "hello through AISIX"。原样返回工具结果。
如果 Cursor 请求确认，请审查并批准此次调用。使用 Everything 测试服务时，结果应为：
Echo: hello through AISIX
确认完整路径：
- Cursor 显示已授权工具，不显示调用方有效授权范围之外的工具。对于此测试服务，应仅显示
everything__echo。 - AISIX MCP 可观测性记录预期调用方 API Key 和服务器的一次成功
tools/call。 - Cursor 显示经由 AISIX 返回的工具结果。
工具发现成功说明连接和调用方授权正常，但不能证明模型会选择工具，也不能证明 Cursor 的批准策略允许执行。因此，仍需保留显式工具调用测试。
Cursor 故障排查
| 现象 | 检查项 |
|---|---|
| Cursor 未连接 | 确认 URL 以 /mcp 结尾、Cursor 可访问网关，且启动 Cursor 的环境中包含 AISIX_MCP_KEY。 |
| 工作区来源已禁用 | 打开 Customize → MCPs，选择 aisix，并启用工作区来源。 |
Cursor 返回 401 | 确认 AISIX_MCP_KEY 包含 AISIX 调用方 API Key，而非上游 MCP 凭证。 |
| 连接成功但未显示工具 | 按照工具访问故障排查检查服务器和有效授权，然后在 Cursor 中重新加载服务器。 |
| 工具已显示，但 Agent 未调用它 | 明确指定所选工具的名称，在 MCP 工具列表中启用它，并检查 Cursor 的工具批准策略。对于测试服务，请选择 everything__echo。 |