# 助手故障排除

> 解决在 Claude、ChatGPT 和其他 MCP 客户端中使用聚易时遇到的登录、权限和工具缺失问题。

Source: https://help.gathereasy.rsvp/zh-cn/ai-assistants/troubleshooting/

## 登录窗口打不开或立即关闭

- 允许助手网站弹出窗口，然后重新连接。
- 确认地址正好是 `https://gathereasy.rsvp/api/mcp`：使用 `https`，末尾没有多余的斜杠或空格。
- 如果你修改过认证设置，请改回默认（OAuth，不填客户端 ID 或密钥）。聚易会自动注册你的助手。

## 一直提示“登录”

连接 30 天后会过期，或已被断开。请在助手的连接器设置中重新连接，并再次点击**允许访问**。

如果你刚在网站上点击了在所有设备上退出，这不会影响助手。如果你通过另一个助手撤销了访问权限，请重新连接。

## 助手说某个操作不被允许

- 使用邮件时提示 **“Insufficient scope”** 或要求重新连接：你连接时没有授予邮件权限，或在邮件功能推出之前就已连接。请在助手中断开聚易，重新连接并保持勾选邮件权限。
- **“Forbidden”**：你的聚易账户没有该权限，例如管理你不是主办方的活动，或在不是所有者或管理员时查看社群付款。

## 缺少某个功能，或助手使用了旧名称

助手可能缓存了聚易的工具列表。请刷新：

- **ChatGPT**：在**设置 → Apps & Connectors** 中打开该应用，点击 **Refresh**。
- **Claude**：打开 **Customize → Connectors**，断开聚易后重新连接。
- **Claude Code**：运行 `/mcp` 并重新连接，或重启 Claude Code。
- **其他客户端**：重启客户端或重新加载 MCP 服务器。

## 交互式面板没有出现

并非所有助手都支持 MCP Apps，不支持时会以文字显示全部信息。在 Claude 和 ChatGPT 中可以说“打开聚易”。如果面板仍未出现，请新建一个对话。

## “Too many requests”或“rate limit”

你在一分钟内发出了超过 300 次请求或 60 次修改，或在一小时内发送了过多邮件。请等一分钟再试。

## 提示数据库暂时不可用

聚易暂时无法访问。请等待提示中给出的时间后再试。

## 操作似乎失败了

重试之前，先让助手确认一下，例如“活动发布了吗？”或“公告发出去了吗？”。偶尔会出现操作其实已经完成但仍报错的情况。先确认可以避免重复的活动或消息。

## 我已付款，但助手说门票仍待付款

银行卡和银行付款有时需要一点时间确认。请一分钟后再问，或在聚易中打开活动页面。参见[门票与付款](https://help.gathereasy.rsvp/zh-cn/attending/tickets-and-payment.md#付款处理中)。

## 仍然无法解决？

[联系支持团队](https://help.gathereasy.rsvp/zh-cn/support/contact-support.md)。请告诉我们你使用的助手、你提出的请求以及确切的错误信息。切勿附上登录验证码、密码或邮箱应用专用密码。
