将 Cursor 连接到你的工作室

简介

Cursor 是一款内置 AI 的编辑器。使用 AI 连接器后，Cursor 聊天可以根据你的提问查询工作室的数据（销售、客户、预约和财务），并遵循 API 密钥所属用户的权限。它只能查询数据，不会修改系统中的任何内容。

适用场景

你正在开发集成或网站，想在不离开编辑器的情况下查看工作室的实际数据。
你平时会使用 Cursor 聊天，想询问工作室的经营情况。

开始之前

请准备好连接器地址和一个已启用“允许用作 AI 连接器”的 API Key。你可以按照AI 连接器一文中的说明创建它们。

操作步骤

步骤 1 — 添加连接器

打开（或新建）文件 ~/.cursor/mcp.json，然后添加以下代码段。将地址替换为你通过 复制地址 复制的地址，并将 hk_... 替换为你的密钥：

{
  "mcpServers": {
    "heya": {
      "url": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

步骤 2 — 检查连接

在 Cursor 设置中打开 MCP 部分。连接器 heya 应显示为已启用，并包含 listar_areas、buscar_ferramentas 和 executar_consulta 工具。

步骤 3 — 提问

在 Cursor 聊天中提问，例如：“今天有哪些客户来工作室消费了？”

后续

Cursor 会根据问题找到合适的查询并执行，然后用系统中的数据作答。
在 API Key 标签页中，可以看到该密钥的 最后使用 已更新。
如需停止访问，请在 API Key 标签页中撤销密钥。Cursor 最迟会在 30 秒后失去访问权限。

常见错误与问题

问：Cursor 设置中显示连接器出错。我该怎么办？
答：检查地址是否以 /mcp 结尾，以及密钥是否完整粘贴，并包含 Bearer 和后面的一个空格。编辑 mcp.json 后，请在 Cursor 设置中关闭再重新启用连接器。

问：可以用环境变量代替密钥吗？
答：某些版本的 Cursor 不会将环境变量替换为实际值，而是直接把变量文本发送到请求头中。如果使用环境变量无法连接，请将密钥直接写入你的用户配置文件。

问：可以把配置放在项目的 .cursor/mcp.json 文件中吗？
答：不建议这样做：该文件通常会被纳入版本控制，导致密钥泄露。请使用你的用户配置文件（~/.cursor/mcp.json）。

问：Cursor 提示密钥需要启用“允许用作 AI 连接器”。为什么？
答：创建密钥时没有启用此选项。请在 API Key 标签页中编辑密钥，并勾选 允许用作 AI 连接器。

问：Cursor 打开了登录页面，而不是使用密钥。我该怎么办？
答：检查 mcp.json 中是否有包含密钥的 headers 代码段。密钥正确时，系统会直接响应，无需登录。如果 Cursor 仍要求登录，且登录失败，请在 Claude Code 或 Gemini CLI 中使用密钥，或者联系支持团队。

问：Cursor 可以通过连接器修改系统数据吗？
答：不可以。连接器只能查询数据。要修改数据，请在系统中操作。