将 Claude Code 连接到你的工作室
Claude Code 是 Anthropic 推出的 Claude，可以在电脑终端中运行。通过 AI 连接器，它可以在你提问时查询工作室的数据（销售额、客户、日程、财务），权限与密钥所属用户的权限相同。它只能查询，不会修改系统中的任何内容。
- 你已经在电脑上使用 Claude Code，想直接在其中询问工作室的经营情况。
- 你想用日常语言提问，让它根据系统数据整理摘要或表格。
准备好连接器地址，按照文章连接 AI中的说明复制。电脑上还需要安装 Claude Code。它通过系统登录进行连接；API 密钥是可选的，适合不想使用登录的情况（例如在没有浏览器的电脑上使用）。
第 1 步 — 添加连接器
Section titled “第 1 步 — 添加连接器”在终端中运行以下命令，将地址替换为你在 复制地址 中复制的地址：
claude mcp add --transport http heya https://seu-dominio/mcp在 Claude Code 中输入 /mcp，选择 heya，然后选择身份验证选项：系统的登录页面会在浏览器中打开。登录后，选择 公司 并点击 授权。
如果更喜欢使用 API 密钥（创建密钥时启用了 允许用作 AI 连接器），请在命令中添加请求头：--header "Authorization: Bearer hk_..."。
如果想让这台电脑上的所有文件夹都能使用连接器，而不只是当前文件夹，请在命令中添加
--scope user。
第 2 步 — 检查连接
Section titled “第 2 步 — 检查连接”运行 claude mcp list。连接器 heya 应显示为已连接。在 Claude Code 中，输入命令
/mcp 也可以查看相同的信息。
第 3 步 — 提问
Section titled “第 3 步 — 提问”打开 Claude Code 并提问，例如：“昨天我的工作室卖了多少？”第一次使用时，Claude 可能会请求你批准使用连接器工具。
- Claude 会根据问题选择合适的查询，执行查询并返回系统中的数据。
- 密钥所在的 API Key 标签页会更新 最后使用。
- 如需撤销访问权限，请在 API Key 标签页撤销密钥：Claude Code 最迟会在 30 秒内失去访问权限。
常见错误与问题
Section titled “常见错误与问题”问：claude mcp list 显示“Failed to connect”。该怎么办？
答：检查地址是否以 /mcp 结尾，以及密钥是否完整粘贴，并确认其中包含 Bearer 和后面的空格。该命令只会保存配置，不会测试密钥；只有 Claude 尝试连接时才会显示错误。
问：Claude 提示密钥需要启用“允许用作 AI 连接器”。为什么？ 答：创建密钥时没有启用该选项。请在 API Key 标签页编辑密钥，并勾选允许用作 AI 连接器。
问：如何更换密钥？
答：运行 claude mcp remove heya 移除连接器，然后使用新密钥重新添加。
问：可以通过代码仓库与团队共享配置吗？
答：不要将密钥放入共享文件（--scope project 会将配置写入 .mcp.json）。每个人都应使用自己的密钥，并拥有各自用户的权限。
问：Claude 说找不到一项我在系统中看得到的信息。为什么？ 答：密钥所属用户无权访问该页面，或者出于安全考虑，该内容不在连接器支持范围内（WhatsApp 对话、问诊记录、照片和数字账户）。请参阅文章AI 连接器。