> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 故障排除

> 解决 GetQR 连接器在 Claude、ChatGPT 和 Cursor 中的常见问题。

找到您看到的消息或症状，然后按照解决方法操作。大多数问题源于成员角色、订阅或已过期的连接。

## 快速检查

在进行其他操作之前，请先检查以下三项：

1. \*\*角色。\*\*您在工作区中是 Admin 或 Editor。Viewer 无法使用 AI 连接器。
2. \*\*订阅。\*\*工作区 Admin 的订阅处于有效状态。
3. \*\*连接。\*\*在 **My Account** → **AI connectors** 中，您的助手显示为 **Active**。

## 连接

> **“AI connectors aren't available”（AI 连接器不可用）**
>
> GetQR 登录页面显示“Viewers can't connect AI assistants. Ask an editor or the workspace owner.”（Viewer 无法连接 AI 助手。请联系 Editor 或工作区所有者。）您的角色是 Viewer。请让工作区 Admin 将您的角色更改为 Editor。请参阅[角色与权限](/zh/members/roles-and-permissions)。

> **“An active subscription is required”（需要有效的订阅）**
>
> AI 助手只能连接到拥有有效订阅的 GetQR 账户。
>
> * \*\*Admin：\*\*点击 **View plans** 续订。有关付款的问题，请参阅[帮助中心](https://getqr.com/help)。
> * \*\*Editor：\*\*页面显示“The workspace owner needs an active subscription before you can connect an AI assistant.”（工作区所有者需要拥有有效订阅，您才能连接 AI 助手。）请联系您的工作区 Admin。

> **“This connection request is invalid”（此连接请求无效）**
>
> 将您引导至 GetQR 的应用无法识别，或其重定向地址不匹配。请关闭窗口，然后从助手重新连接。如果问题持续出现，请从助手中删除 GetQR，并使用 `https://getqr.com/api/mcp` 重新添加。

> **“Couldn't connect this assistant. Try again.”（无法连接此助手，请重试）**
>
> 您点击 **Allow** 后批准失败。请再次点击 **Allow**，或从助手重新开始连接。

> **GetQR 对话框一直停留在“Waiting for…”**
>
> GetQR 会一直等待，直到您批准连接。请在助手中完成登录，并在 GetQR 页面上点击 **Allow**。对话框会自动更新。如果您关闭了助手的标签页，请点击 **Cancel** 并重新开始。

> **ChatGPT：“Set up ChatGPT on desktop”**
>
> ChatGPT 不支持在移动应用中添加连接器。请在电脑上打开 chatgpt.com 来连接 GetQR。请参阅[连接 ChatGPT](/zh/ai-connectors/connect-chatgpt)。

> **Cursor：“Set up Cursor on desktop”**
>
> Cursor 是桌面应用，只能从电脑上连接。请参阅[连接 Cursor](/zh/ai-connectors/connect-cursor)。

> **点击 Open Cursor 按钮无法打开 Cursor**
>
> 请安装 Cursor 桌面应用并允许浏览器打开它。或者手动将 GetQR 添加到 `mcp.json`。请参阅[连接 Cursor](/zh/ai-connectors/connect-cursor#手动添加)。

> **Connect 对话框中的助手显示为灰色**
>
> 它已连接到您的账户。如需重新开始，请先撤销连接。请参阅[管理连接](/zh/ai-connectors/manage-connections)。

## 连接之后

> **助手提示令牌无效或已过期**
>
> 访问令牌有效期为 1 小时，助手会自动续期。如果助手 30 天未使用，或连接已被撤销，续期就会失败。请从助手重新连接并点击 **Allow**。请参阅[重新连接助手](/zh/ai-connectors/manage-connections#重新连接助手)。

> **连接显示 Expired**
>
> 该助手 30 天未使用。请从助手重新连接。连接会再次显示 **Active**。

> **连接器原本正常，之后因“Active subscription required”停止工作**
>
> 工作区订阅已失效。在续订之前，所有连接都将停止工作。Admin 可以在 GetQR 中查看套餐；有关付款的问题，请参阅[帮助中心](https://getqr.com/help)。

> **连接器因“AI connectors are not available for this role.”停止工作**
>
> 您的角色已被更改为 Viewer，或您已被移出工作区。请向工作区 Admin 申请 Editor 角色。

> **助手没有使用 GetQR**
>
> 在提示词中提及 GetQR，例如“Using GetQR, list my QR codes”（使用 GetQR 列出我的二维码）。检查助手中是否已为此聊天启用该连接器。

> **助手操作的工作区不正确**
>
> 每个连接都绑定到一个工作区：您的默认工作区，或您加入的第一个工作区。

## 任务与结果

> **助手无法创建 vCard、PDF 或其他类型的二维码**
>
> 该连接器只能创建网站二维码。其他类型请在[二维码生成器](/zh/qr-types/overview)中创建。

> **助手无法更改短链接**
>
> 二维码创建后，短链接无法更改。请使用您想要的短链接创建一个新二维码。

> **助手无法管理成员**
>
> 成员管理仅对工作区 Admin 开放。Editor 会收到权限错误。

> **助手无法使用我上传的 Logo 或 AI 设计**
>
> 上传的 Logo、Convert logo to QR、Branded designs 和 AI designs 无法通过连接器使用。请使用推荐的 Logo，或在应用中设置二维码样式。

> **下载或导出链接无法使用**
>
> 链接有效期为 1 小时。请让助手提供新的链接。对于大型导出，空白页面表示文件尚未准备好：请等待约一分钟。如果约 5 分钟后仍为空白，请缩短时间段或改用 CSV 格式重新请求导出。

> **域名无法用于二维码**
>
> 域名必须已生效，且二维码需要自定义短链接。请让助手检查该域名。如果尚未生效，请在 DNS 服务商处添加助手提供的 CNAME 记录（仅 DNS，不使用代理），一分钟后再次检查。请参阅[验证域名及故障排除](/zh/custom-domains/verify-and-troubleshoot)。

> **助手询问有关账单或删除账户的问题**
>
> 订阅、账单和账户删除功能永远不会向助手开放。请使用 GetQR 应用或[帮助中心](https://getqr.com/help)。

## 仍未解决？

请发送电子邮件至 [help@getqr.com](mailto:help@getqr.com)，并说明您使用的助手、您提出的请求以及您看到的错误消息。

## 后续步骤

> **[管理连接](/zh/ai-connectors/manage-connections)**

> **[功能一览](/zh/ai-connectors/capabilities)**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.