> ## Documentation Index
> Fetch the complete documentation index at: https://www.perplexity.ai/help-center/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/).

# 连接器故障排除

> 解决 Perplexity 连接器的常见问题：无法连接、频繁断开、工具调用失败、已连接却被忽略、数据错误以及退款相关问题。

借助连接器，Perplexity 可以与您在 Gmail、Google Drive、GitHub、Notion、Outlook、SharePoint 等诸多工具中的账户配合使用。如果某个连接器工作异常，请对照下方与您问题最接近的症状进行排查。每个部分都从可解决大多数情况的快速检查入手，然后提供针对性的修复方法。

> [!NOTE]
>
> 开始之前，请在您首次授权该连接器时使用的同一设备和浏览器上登录 Perplexity，并确保处于正确的工作区（个人、Pro、Max 或 Enterprise）。许多连接器问题都是由于当前账户与拥有该连接的账户不同而造成的。

## 开始之前：快速检查

以下四项检查即可解决很大一部分连接器问题。请先尝试这些操作，然后再跳转到与您症状相符的部分。

**1. 确认连接器已在您的账户中启用**

打开 **插件 → 已安装**（如果您还看不到 Plugins，请使用 **Customize → Connectors**），检查该连接器是否显示为已连接。如果没有，请从**插件**页面找到该连接器的页面并选择**连接**。在 Enterprise 中，管理员会控制哪些连接器可用——请参阅 [企业版 Perplexity 连接器 常见问题](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/10673197-企业版-perplexity-连接器-常见问题.md)。

**2. 重新加载 Perplexity**

对页面进行硬性刷新（Windows 上按 **Ctrl+F5**，Mac 上按 **Cmd+Shift+R**），或重启桌面应用。会话状态和连接器令牌会在重新加载时重新读取。

**3. 检查您的方案和平台**

某些连接器和自定义 MCP 服务器仅在特定方案（Pro、Max 或 Enterprise）或特定端（网页、桌面、移动）上可用。如果连接器完全缺失，请确认您使用的是受支持的方案和平台。

**4. 使用正确的账户登录**

Perplexity 会连接到您在 OAuth 流程中批准的第三方账户。如果您有多个 Google、Microsoft 或 GitHub 账户，请先在浏览器中退出其他账户，以便授权正确的账户。

## “已安装”选项卡显示警告圆点或连接器显示“连接”

打开**插件**页面的**已安装**选项卡。在任何需要重新连接的连接器旁选择**重新连接**。对于尚未连接的连接器，请打开插件并选择**连接**。

如果连接器显示**需要升级**、**已被您的组织禁用**或**不可用**，则无法从插件中解决。有关组织限制，请参阅[连接器的基于角色的访问控制](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/2026100201-连接器的基于角色的访问控制.md)。

断开连接器会在所有插件中断开它。重新连接一次即可恢复所有插件中的连接。

## 无法连接或授权连接器

尝试连接应用时，您还没来得及批准访问，登录窗口就关闭、显示错误或卡住了。

**1. 为 perplexity.ai 允许弹窗和第三方 Cookie**

OAuth 依赖弹窗和跨站点 Cookie。广告拦截器、严格的隐私扩展和企业浏览器策略经常会将其拦截。请在禁用扩展的隐私窗口或无痕窗口中重试。如果在那里可以工作，请在您常用的浏览器中为 **perplexity.ai** 允许弹窗和 Cookie。

**2. 在提供方处退出其他账户**

如果 Google、Microsoft 或提供方有多个账户处于登录状态，OAuth 屏幕可能会授权错误的账户。在提供方处全部退出，然后重新开始连接器流程，选择您希望 Perplexity 使用的账户。

**3. 使用新的流程重试**

转到 **插件 → 已安装**（如果您还看不到 Plugins，请使用 **Customize → Connectors**），为该连接器选择**断开连接**，等待几秒后再次选择**连接**。这将强制执行新的 OAuth 握手并清除过期令牌。

**4. 请咨询您的管理员（Enterprise/工作区账户）**

某些 Google Workspace 和 Microsoft Entra 租户默认限制第三方应用。如果您看到“需要管理员批准”“应用已被阻止”或类似消息，需要由管理员批准 Perplexity。有关 Microsoft Entra 和 Google Workspace 的具体步骤，请参阅 [企业版连接器故障排除指南](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/10673201-企业版连接器故障排除指南.md)。

## 连接器不断断开或反复要求重新授权

您已经连接了应用，但几分钟或几小时后，Perplexity 又要求您重新连接。

大多数重新授权循环都源自以下原因之一：

<ul>
  <li>**您在提供方处登录了多个账户。**Perplexity 会为其进入的会话刷新令牌；如果该会话发生变化，令牌就会不再匹配。在提供方处退出其他账户，然后重新连接。</li>
  <li>**提供方的密码或会话最近被重置。**一些提供方会在密码重置、MFA 更改或会话被撤销时使已发放的所有令牌失效。在发生任何此类更改后重新连接一次。</li>
  <li>**第三方 Cookie 被阻止。**Perplexity 无法静默刷新会话。请为提供方的身份验证域和 **perplexity.ai** 允许第三方 Cookie。</li>
  <li>**您的管理员撤销了该应用。**在 Enterprise 工作区中，Google Workspace、Microsoft Entra 或提供方管理控制台中的管理员操作可能强制重新授权。请询问您的管理员，Perplexity 应用是否最近被移除或限制。</li>
</ul>

如果在这些修复之后循环仍在继续，请为该连接器选择**断开连接**，退出提供方，使用您想要的账户重新登录，然后重新连接。

## 连接器的工具调用失败、报错或超时

Perplexity 尝试使用已连接的应用时，出现错误、请求超时或没有返回任何结果。

**1. 重试一次**

在长时间空闲后的首次调用中，提供方的瞬时错误和速率限制很常见。一次重试即可解决大多数短暂故障。

**2. 确认目标仍然存在且您有权访问**

如果任务引用了特定文件、页面、仓库、邮箱或电子表格，请直接在提供方处打开以确认其仍然存在，并且您的账户具有读取或写入权限。已重命名的文件夹、已撤销的共享和已归档的项目会引起看起来像 Perplexity 错误的连接器故障。

**3. 将请求的操作与授予的范围进行比对**

读取权限并不意味着写入权限。如果任务尝试修改、创建或删除某项内容，则连接器需要写入范围。请为连接器选择**断开连接**并再次选择**连接**，让 OAuth 屏幕显示完整的权限集，并批准您需要的每个范围。

**4. 等待提供方的速率限制过去**

反复出现“rate limit”“quota”“429”或“too many requests”等字样的失败来自于提供方对您账户的限流，而不是 Perplexity。请等待几分钟后再重试，或将任务拆分为更小的步骤。

## Perplexity 提示连接器未连接或忽略了它

您的应用在**已安装**选项卡中显示为已连接，但 Perplexity 表示无法访问它，或在回答时没有使用它。

**1. 在编辑器中选中该连接器**

某些端要求您按聊天或按任务逐一启用连接器。使用连接器选择器或 **@** 提及，或在 Computer 中输入 **/** 并在 **Plugins** 下选择该连接器。

**2. 检查您的来源或焦点设置**

如果 Focus、Sources 或类似筛选器被设为仅 Web、Academic 或 Social，Perplexity 将不会调用您已连接的应用。请将来源或焦点设置为允许连接器，然后重试。

**3. 确认连接器归属于此工作区或项目**

在个人账户中授权的连接器在 Enterprise 工作区或项目中不会自动可用。请在您希望使用连接器的工作区或项目内部重新授权。

**4. 重新加载后再试**

对 Perplexity 进行硬性刷新或重启桌面应用，以便重新获取连接器状态。如果它仍显示为已连接但未被使用，请选择**断开连接**并再次选择**连接**。

## 连接器返回错误、缺失或过时的数据

您可以在应用中找到文件、电子邮件、事件或记录，但 Perplexity 的回答中没有这些内容。它返回的信息也可能已经过时。

**1. 确认数据在授予的范围内**

Perplexity 只能看到您授权的内容。您未共享的文件夹中的文件、其他账户的邮箱以及设置时未选择的私有仓库都在范围之外。请重新连接，并在必要时扩大访问范围。

**2. 给索引留出更新时间**

对于同步文件集合的连接器（例如 Google Drive、OneDrive、SharePoint、Dropbox 或 Box），新添加的项目可能需要几分钟才能变得可搜索。请等待几分钟，然后进行硬性刷新。

**3. 检查提供方一侧的过滤器**

回收站、归档、垃圾邮件以及“仅自己”的文件夹通常会被排除。如果内容位于其中之一，请将其移动或共享到连接器可以访问的位置。

**4. 重新授权以强制刷新获取**

如果数据看上去停留在旧状态，请为该连接器选择**断开连接**并再次选择**连接**。这会清除任何缓存的令牌，并触发一次新的授权。

## Perplexity 无法执行写入操作（发送、创建、编辑、删除）

Perplexity 可以读取已连接应用中的信息，但无法完成发送电子邮件、创建事件或编辑文档等操作。操作可能失败，也可能没有出现请您批准操作的提示。

<ul>
  <li>**该连接器可能仅以只读方式获得授权。**请选择**断开连接**并再次选择**连接**，并在提供方的同意屏幕上批准每一项权限。</li>
  <li>**您可能对目标本身没有写入权限。**即使已授予写入范围，第三方账户仍然需要对具体文件、文件夹、日历或仓库拥有编辑或所有者访问权限。</li>
  <li>**写入的批准卡必须确认。**Perplexity 会在执行有影响的写入操作之前请求您的批准。如果您不小心关闭了该卡，请让 Perplexity 再次执行该操作。</li>
  <li>**Enterprise 管理员可以限制写入操作。**在受管理的工作区中，您的管理员可以允许读取但阻止写入。请让管理员检查连接器的权限设置。</li>
</ul>

## 选择器、方案或平台中缺少某个连接器

您找不到想使用的连接器，或者它显示为灰色，或只出现在您的某一台设备上。

<ul>
  <li>**方案。**某些连接器和自定义 MCP 服务器仅限于 Pro、Max 或 Enterprise。请在 [连接器与集成](https://www.perplexity.ai/help-center/help-center/zh-CN/collections/18799295-连接器与集成) 合集中的连接器文章中查看方案要求。</li>
  <li>**平台。**某个连接器可能在网页上已启用，但尚未在移动端启用，或者相反。如果它在一台设备上能用而在另一台设备上不能，平台就是最有可能的原因。</li>
  <li>**地区。**由于提供方本身受地区限制，一些连接器并非在所有地区都可用。</li>
  <li>**Enterprise 策略。**在 Enterprise 中，由管理员选择向成员提供哪些连接器。如果某个连接器在您所有设备上都缺失而在其他账户上存在，请让管理员启用它。</li>
</ul>

## 自定义 MCP 服务器设置问题

通过自定义 MCP 服务器，您可以让 Perplexity 指向您自己的兼容 MCP 的端点。大多数设置问题都属于以下几类：

<ul>
  <li>**OAuth 重定向 URI 未加入允许列表。**请将连接器设置屏幕上显示的 Perplexity 回调 URL 添加到 MCP 服务器的允许重定向 URI 中，并在重试前保存更改。</li>
  <li>**服务器拒绝 Perplexity 的请求头。**请确认您的服务器接受标准 MCP 请求头，并且不需要自定义请求头。如果需要自定义请求头，请通过 [添加自定义远程连接器](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/13915507-tian-jia-zi-ding-yi-yuan-cheng-lian-jie-qi.md) 添加。</li>
  <li>**更新后工具清单未刷新。**请为连接器选择**断开连接**并再次选择**连接**，以迫使 Perplexity 重新获取清单。新添加的工具只有在清单被重新获取后才会出现。</li>
  <li>**OAuth 完成但没有显示任何工具。**请确认您的 MCP 服务器至少公开一个工具，并且身份验证以工具期望的格式返回令牌。</li>
  <li>**桌面应用上的本地 MCP。**本地 MCP 服务器需要在受支持的平台上运行 Perplexity 桌面应用。如果没有该选项，请将桌面应用更新到最新版本。</li>
</ul>

## 隐私、数据访问与断开连接

要断开连接器或删除其数据：

**1. 在 Perplexity 中断开连接器**

打开 **插件 → 已安装**（如果您还看不到 Plugins，请使用 **Customize → Connectors**），为该连接器选择**断开连接**。Perplexity 会立即停止对其进行调用。

**2. 在提供方处撤销访问权限**

在第三方提供方的账户或安全设置中，撤销对 Perplexity 的授权。即使令牌曾被缓存在某处，这也会使其失效。

**3. 必要时申请删除数据**

如果您还希望删除 Perplexity 已获取的数据，请按照 [Google Drive 连接器：文件上传安全](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/13714508-google-drive-连接器-文件上传安全.md) 中的步骤以及其他文件连接器的对应文章操作，或使用您的账户详情联系支持团队。

如有关于连接器数据如何存储和使用的问题，请参阅 [隐私与数据](https://www.perplexity.ai/help-center/help-center/zh-CN/collections/18799294-yinsi-yu-shuju)。

## 连接器出错时消耗了积分

如果某项任务消耗了积分但连接器没有产生有用的结果，您可以请求支持团队复查该运行。请附上：

<ul>
  <li>连接器名称以及失败任务的大致时间。</li>
  <li>简要说明您的请求内容以及出错情况。</li>
  <li>如有可能，附上错误或任务页面的截图。</li>
</ul>

联系方式请参阅 [订阅方案和账单](https://www.perplexity.ai/help-center/help-center/zh-CN/collections/18799292-dingyue-fangan-he-zhangdan) 与 [如何联系 Perplexity 团队？](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/10354891-ruhe-lianxi-perplexity-tuandui.md)。

## 仍然无法解决？

如果以上步骤都未能解决您的问题，请与支持团队联系，并尽可能多地提供细节：连接器、平台（网页、桌面、iOS、Android）、您的方案、准确的错误信息，以及截图或简短的屏幕录制。这些上下文能让我们复现问题，并更快为您提供修复。请从 [需要支持？](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/10354888-xuyao-zhichi.md) 开始。


## Related topics

- [Apple Health 连接器故障排除](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/20260918-apple-health-连接器故障排除.md)
- [文件应用连接器故障排除（Pro 订阅者）](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/11185430-wen-jian-ying-yong-lian-jie-qi-gu-zhang-pai-chu-pro-ding-yue-zhe.md)
- [企业版连接器故障排除指南](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/10673201-企业版连接器故障排除指南.md)
- [故障排除与支持](https://www.perplexity.ai/help-center/help-center/zh-CN/collections/18799303-guzhang-paichu-yu-zhichi.md)