Corebee Customer Support

Corebee 插件

通过 AI Agent 处理 Corebee 支持收件箱：对对话分类、发送回复、查找客户、更新知识库并生成支持报告。

Cursor · Grok Bot · Grok Build · Claude Code

此插件将你的 Agent 连接到 Corebee 托管的 MCP 服务，并添加六个技能，指导 Agent 安全地使用该服务。你可以通过 OAuth 登录，无需粘贴 API 密钥。

快速开始

1. 为你的客户端安装此插件（参见安装）。
2. 按照客户端提示登录。连接服务后，浏览器会打开 Corebee 登录和授权页面，然后才会运行任何工具。具体操作因客户端而异：
   • Cursor： 使用市场列表中的安装按钮，或运行 /add-plugin corebee。Cursor 会安装插件并打开 Corebee 登录页面。如果浏览器没有打开，请在侧边栏的 Customize 中找到 corebee；Cursor 会在此处管理 MCP 服务，你可以从那里连接。
   • Grok Bot： 添加插件，然后在 Grok Bot 提示时批准连接，并在浏览器中完成登录。如果登录窗口过早关闭，请从插件条目重新打开。随后，插件会显示在已安装的插件中。
   • Grok Build： 在 /plugins 下启用 Corebee，然后按照 Grok 的提示在浏览器中完成登录。
   • Claude Code： 运行 /mcp，选择 corebee 并选择 Authenticate，或在终端中运行 claude mcp login corebee。完成后，Claude Code 才会显示 Corebee 工具。
3. 批准连接，然后向 Agent 询问 Corebee 收件箱相关事项；在 Agent 更改任何内容之前，先检查它提出的操作。

你可以这样提问

提问	技能
“检查我所有未结的 Corebee 对话，并建议优先级和负责人。”	corebee-inbox-triage
“根据我们的知识库，为 Dana 最新的对话拟一份回复。发送前先给我看。”	corebee-reply-drafting
“在我通话之前，告诉我我们对 [email protected] 了解多少。”	corebee-customer-lookup
“我们的知识库能回答这五个问题吗？如果不能，请添加我们的新退货页面。”	corebee-knowledge-base
“生成本月的支持报告，包含 CSAT 和 30 天趋势。”	corebee-support-report
“将我们的聊天小组件改为品牌色，并移到左侧。”	corebee-widget-setup

你也可以请求使用单个工具，例如“列出我待处理的 Corebee 对话”，或“本周每位 Agent 分别解决了多少个对话？”。

安装

你需要一个 Corebee 账户（注册）。客户端连接到服务时，浏览器会打开 Corebee 登录和授权页面，然后才会运行任何工具。

Cursor

• 社区目录（现已上线）： 打开 cursor.directory 上的 Corebee，然后使用 Add to Cursor。这会安装整个插件：MCP 服务、六个技能和规则。
• Cursor Marketplace： 我们的列表正在审核中。上线后，你就可以从 Marketplace 或 Customize 安装。
• 仅安装 MCP 服务： 将 Corebee MCP 添加到 Cursor。此操作会添加服务，但不包含技能和规则。
• 本地测试： 将此代码库复制到 ~/.cursor/plugins/local/corebee，运行 Developer: Reload Window，然后检查 Customize。

Grok Bot

打开 Plugins，搜索 Corebee，然后选择 Add to Grok Bot。Grok Bot 使用 Cursor Marketplace 列表，因此无需安装其他内容。Cursor 列表上线后，Corebee 就会显示在那里。

Grok Build

从 xAI 目录安装：打开 /plugins，然后在 Marketplace 选项卡中安装 Corebee。xAI 会审核目录条目，因此如果 Corebee 尚未列出，请从此仓库安装。

从此仓库安装：将仓库克隆到 ~/.grok/plugins/corebee，并检出 v1.0.0 标签（或检出你已审核过的提交）；也可以使用 --plugin-dir <path to the clone> 启动 Grok。然后打开 /plugins 并启用 Corebee。Grok 会从 ./.grok/plugins/、~/.grok/plugins/ 和任何 --plugin-dir 路径加载插件。此插件包含一个 MCP 服务和六个技能，不含钩子或脚本，因此启用后不会运行任何本机程序。

Claude Code

/plugin marketplace add Corebee-AI/corebee-plugin
/plugin install corebee@corebee

仅 MCP 服务：

claude mcp add --transport http corebee https://corebee.ai/api/v1/mcp/stream

无论使用哪种方式，都请运行 /mcp，选择 corebee 并选择 Authenticate 进行登录，或者在 shell 中运行 claude mcp login corebee。只有完成这一步后，Claude Code 才会列出 Corebee 工具。

其他 MCP 客户端

任何支持可流式 HTTP 和 OAuth 的客户端都可以使用，前提是其回调地址为 https，或者是环回主机（localhost、127.0.0.1 或 [::1]）上的普通 http 地址，端口不限。Corebee 还接受的唯一私有应用方案是 Cursor 自己的桌面回调 cursor://anysphere.cursor-mcp/oauth/callback。这与插件随附的 mcp.json 和 .mcp.json 文件内容相同：

{
  "mcpServers": {
    "corebee": {
      "type": "http",
      "url": "https://corebee.ai/api/v1/mcp/stream"
    }
  }
}

包含内容

组件	路径	宿主
Corebee MCP 服务（托管式，OAuth）	mcp.json、.mcp.json	全部
技能：收件箱分类、回复草拟、客户查询、知识库、支持报告、微件设置	skills/	全部
规则：安全使用 Corebee 工具（涉及 Corebee 的任务会应用此规则）	rules/corebee.mdc	Cursor
清单	.cursor-plugin/、.grok-plugin/、.claude-plugin/	每个宿主各一份

不含钩子、脚本、二进制文件或遥测。scripts/validate.mjs 仅在 CI 中运行，宿主不会加载它。

登录和权限

• 使用 OAuth 2.1、PKCE 和动态客户端注册。客户端会自行查找登录详情并保留令牌。插件不会存储凭据。
• 连接会代表你在登录时选定的 Corebee 工作区中操作。要连接另一个工作区，请先在 Corebee 中切换到该工作区。
• 访问令牌有效期为 1 小时。刷新令牌有效期为 30 天，并会在每次使用时轮换。
• 访问权限取决于你的角色。 无论客户端请求哪些范围，连接获得的权限都不会超出你当前角色所允许的范围；Corebee 还会在请求到达时再次检查你的角色和成员身份（每台服务最多缓存结果 30 秒）。如果你的角色权限降低，连接会在约 30 秒内受到新角色的限制。如果你离开工作区，连接会在约 30 秒内停止工作。角色晋升不会扩大现有连接的权限：请重新连接以获得额外访问权限。

角色	连接可持有的范围
Owner	全部 11 个范围
Agent	对会话、联系人和知识具有读取和写入权限，另有 metrics:read 和 settings:read。不能删除，也不能更改设置。
Viewer	只读：conversations:read、contacts:read、knowledge:read、metrics:read、settings:read

角色显示为 admin 的成员（list_team_members 仍可能返回的旧版角色）拥有 Agent 范围。

范围	允许的操作
conversations:read	列出、读取和导出会话
conversations:write	回复、添加内部备注、分配、关闭、设置优先级、添加标签、暂缓处理和标记
contacts:read / contacts:write	搜索和读取联系人 / 创建、更新联系人并添加备注
contacts:delete	删除联系人（其会话、消息、CSAT 回复、通话记录和其他关联记录会保留，但不再关联联系人）
knowledge:read / knowledge:write	列出、读取和搜索来源，并使用助手工具 / 添加和更新网页来源
knowledge:delete	删除知识来源
metrics:read	指标、趋势和报告
settings:read / settings:write	读取小组件、团队和工作区设置 / 更改小组件设置

授权页面会列出你将获得的范围，以及角色不允许的范围，并提供 允许访问 或 取消 选项。未发送任何范围的客户端（此插件的 mcp.json 不请求任何范围，许多客户端也不会发送范围）将获得角色允许的全部权限；授权页面会准确列出这些范围。只请求 Corebee 无法识别范围的客户端只能获得读取权限。

管理已连接的应用

在 Corebee 中，打开 设置 > 登录和安全 > 已连接的应用（corebee.ai/settings/security）。所有角色都可以使用此功能。你可以查看并撤销自己连接的应用。Owner 可以在此查看并撤销所有成员的应用，也可以在 设置 > 连接到 ChatGPT 和 Claude 中进行操作。点击 撤销 后，应用会在约 30 秒内退出登录，其当前访问令牌也会失效。在客户端中移除服务会丢弃客户端保存的令牌副本；连接本身仍会保留，直到过期或你在 设置 > 登录和安全 > 已连接的应用 中将其撤销。

希望建立只读连接的 Owner 有两种选择：使用允许你仅请求读取范围的客户端进行连接，或者以 Viewer 角色成员的身份进行连接。

工具

托管服务会在客户端连接时列出所有工具（平铺发现，无需搜索）。2026-10-12 快照：共 44 个工具（22 个只读、19 个写入、3 个破坏性操作）。包含参数的相同列表位于 scripts/tools.json，CI 会检查此表是否与其一致。

对话

工具	范围	功能
list_conversations	conversations:read	每页最多 50 条最近对话，可按状态或受理人筛选（assignee_id 是 list_team_members 返回的 member_id）
get_conversation	conversations:read	获取一条对话及其最新的 50 条消息（当前页内按时间从早到晚排列）。当 has_more 为 true 时，传入 before = next_before，以获取这些消息之前的 50 条消息
bulk_export_conversations	conversations:read	导出最多 25 条对话的 CSV
reply_to_conversation	conversations:write	在对话所在的渠道发送回复，或保存内部备注（详情）
assign_conversation	conversations:write	分配给团队成员，或取消分配
close_conversation	conversations:write	标记为已解决
reopen_conversation	conversations:write	将状态恢复为待处理，例如对话已解决或暂停后。不会向客户发送任何内容
add_conversation_note	conversations:write	添加团队可在收件箱中看到的内部备注。客户永远不会看到，且不会通过任何渠道发送内容
set_priority	conversations:write	设置为低、中、高或紧急
add_label	conversations:write	按 ID 添加标签。没有工具可以列出标签，因此你需要标签 ID
bulk_close_conversations	conversations:write	将最多 25 条对话标记为已解决
bulk_snooze_conversations	conversations:write	将最多 25 条对话暂停至指定时间
bulk_tag_with_sentiment	conversations:write	为最多 25 条对话添加情绪标签
bulk_add_note	conversations:write	为最多 25 条对话添加相同的内部备注

联系人

工具	范围	功能
list_contacts	contacts:read	每页 50 条；搜索会匹配名称或电子邮件的任意部分，并按输入内容匹配，但 * 会匹配任意单个字符
get_contact	contacts:read	获取详细信息、自定义属性、最新备注和最近的对话
create_contact	contacts:write	创建联系人（必须提供电子邮件、电话或姓名；重复的电子邮件或电话号码将被拒绝）
update_contact	contacts:write	仅更改你传入的字段
add_contact_note	contacts:write	为联系人添加内部备注
delete_contact	contacts:delete	具有破坏性。删除联系人及其备注；其对话、消息、CSAT 回复、通话记录和其他关联记录（例如 NPS 回复）会保留并解除关联（两个步骤）
bulk_delete_contacts	contacts:delete	具有破坏性。删除最多 25 个联系人及其备注；其对话、消息、CSAT 回复、通话记录和其他关联记录会保留并解除关联

知识库

工具	范围	功能
list_knowledge_sources	knowledge:read	最多列出 50 个来源，并显示状态和分块数量
get_knowledge_source	knowledge:read	获取单个来源及其处理状态
search_knowledge	knowledge:read	在已索引内容中进行文本匹配（非语义搜索）
add_knowledge_url	knowledge:write	添加网页；索引在后台运行
update_knowledge_source	knowledge:write	重命名来源或更改其 URL
delete_knowledge_source	knowledge:delete	具有破坏性。删除来源及其所有已索引内容；指向该来源的知识缺口会保留并解除关联（两个步骤）

指标和报告

工具	范围	功能说明
get_metrics	metrics:read	对话、联系人、消息和知识条目数量、CSAT 和平均首次响应时间
get_agent_performance	metrics:read	每位团队成员的已分配数、已解决数和解决率
get_channel_analytics	metrics:read	各渠道的对话数和消息数
get_trends	metrics:read	按日或按周统计的 7、30 或 90 天序列
export_report	metrics:read	仅导出计数（summary），或导出最多 100 行（包含联系人详情，格式为 json）
export_report_task	metrics:read	以后台 MCP 任务形式生成仅包含计数的报告

小组件和工作区设置

工具	范围	功能说明
list_widgets	settings:read	列出你的聊天小组件及其 widget_id
get_widget_settings	settings:read	获取小组件的外观和行为设置
list_team_members	settings:read	列出最多 50 位成员及其角色和 member_id
get_organization_settings	settings:read	获取套餐、状态和 AI 设置
update_widget_settings	settings:write	设置颜色、欢迎标题、回复时间和聊天前表单
configure_widget_appearance	settings:write	设置颜色、欢迎标题、徽标和位置
configure_widget_behavior	settings:write	设置回复时间和聊天前表单

助手

只读辅助工具。每个工具接收 task_description（以及可选的 context 和 history），并返回 answered、response、confidence 和建议的 actions。不会执行或写入任何内容。四个工具中有三个使用固定关键词规则，不使用 AI 模型。

工具	范围	功能说明
a2a_knowledge_agent	knowledge:read	知识 Agent（唯一会运行 AI 模型的工具）：查找最多 5 段相关的已索引内容，并且仅根据这些内容撰写简短回答，同时注明来源。如果模型不可用，则返回最相关内容段落的摘录，并降低 confidence，因此请先检查 confidence 和来源再依赖其回答。如果未找到相关内容或无法执行搜索，answered 为 false，因此请使用 search_knowledge 进行确认。每个工作区每分钟最多调用 30 次
a2a_escalation_agent	knowledge:read	升级 Agent：通过关键词规则标记你提供的文本中要求联系真人、表达沮丧或重复出现的问题，并建议带有优先级的交接。它不会进行交接或通知任何人
a2a_diagnostic_agent	knowledge:read	诊断 Agent：针对六个领域（登录、性能、聊天小组件、电子邮件、账单、数据缺失）使用关键词规则，返回一般性的可能原因和步骤。它不会查看你的账户或数据
a2a_action_agent	knowledge:read	操作 Agent：通过关键词规则建议一项收件箱操作（分配、关闭、设置优先级、添加标签、暂停、添加备注、导航），但不会填入详细信息。你需要自行完成操作，并使用相应工具执行

提示词： summarize_conversation 和 draft_reply。资源： conversations://open、metrics://dashboard、knowledge://sources 和 conversation://{id}。

回复

reply_to_conversation 使用与 Corebee 收件箱相同的发送路径：

• 电子邮件、SMS、WhatsApp、Slack、Messenger、Instagram、Telegram、Microsoft Teams 和 Discord 的回复会通过相应渠道发送。网页聊天回复会显示在客户的聊天窗口中。
• 如果服务提供商已接受回复，或回复已推送到聊天窗口，结果会显示 delivered: true。之后发生的退信不会反映在此状态中。
• delivered: false 会附带原因。电话对话以及无法发送消息的渠道会将回复保存在对话中，但不会发送。
• private: true 会保存客户看不到的内部备注。
• 传入 idempotency_key，即可安全重试。回复无法撤回。
• 回复会以你的身份发送。在已交接给真人处理的对话中，回复会被视为人工回复，因此 Corebee 的 AI 会停止在该对话中作答。

删除

删除需要调用两次。第一次调用不会删除任何内容：它会返回预览和 confirm_token。在 5 分钟内，使用该令牌重复相同的调用即可删除。令牌只能使用一次，且仅适用于相同的项目。客户端在第二次调用时显示的审批提示是人工检查环节，因此请先阅读预览，再批准操作。只有所有者才能删除。

• delete_contact 和 bulk_delete_contacts 会删除联系人及其备注、渠道身份和已保存的 AI 记忆。联系人的对话及其中的所有消息仍会保留在收件箱中，但会移除联系人关联；其 CSAT 回复、通话记录和其他关联记录（例如 NPS 回复）也会以相同方式保留。预览会通过 linked_conversations_kept 报告保留的对话数量（conversations_to_delete 是一个已弃用的别名，值相同，并将在下一个版本中移除）。如果服务无法清除关联记录，调用将失败并显示“未删除任何内容。”，联系人不会受到影响。如果清除关联记录后删除操作本身失败，联系人也会保留，但其 CSAT 回复和通话记录已解除关联。
• delete_knowledge_source 会删除知识来源及其索引分块、扫描历史、标签、版本历史和引用记录。指向该来源的知识缺口会保留，但会移除关联。也适用相同的两个失败点：清除知识缺口失败时不会删除任何内容；删除操作本身失败时，来源会保留，但其知识缺口已解除关联。

安全

• 每项技能都会将客户消息、联系人字段和知识库文本视为不可信数据，绝不会遵循其中的指令。
• 技能会先读取并展示查找结果，然后在每次更改前征求确认。只有在你看到确切文本并说“发送”后，才会发送回复。
• 每项工具都标注了是否为只读工具，删除操作则标注为破坏性操作，因此需要审批的客户端可以区分读取和更改。
• 每个工作区的限制均采用失败关闭机制：每分钟最多 30 条回复；每个工具每分钟最多 10 次单项删除；每分钟最多 5 次批量调用，每次最多 25 项；每分钟最多调用 a2a_knowledge_agent 30 次。删除的两个步骤都会计入限额。

任何会读取客户文本的 Agent 都存在提示注入风险。请在批准前检查 Agent 提出的操作。

数据与隐私

• 工具结果（包括对话和联系人详细信息）会根据 AI 客户端及其模型提供商的条款发送给它们。
• Corebee 根据其隐私政策、服务条款和数据处理协议处理你的工作区数据。
• export_report 使用 format: json 时会返回联系人姓名、电子邮件和电话号码。默认的 summary 格式仅返回计数。
• 使用这些工具删除联系人不会清除其对话、消息、CSAT 回复、通话记录或其他关联记录（例如 NPS 回复）。如需完整移除客户数据，请联系 [email protected]。
• 插件本身不会收集任何信息。请参阅 PRIVACY.md。
• 你的 AI 客户端只会与 corebee.ai 通信：MCP 端点 https://corebee.ai/api/v1/mcp/stream，以及同一主机上的 Corebee OAuth 端点和发现元数据。登录和授权页面会在浏览器中打开，是普通的 Corebee 网页，受 Corebee 的隐私政策和Cookie 政策约束，包括在你同意后加载的任何分析工具。

故障排查

问题	处理方法
登录后未返回 Cursor	Cursor 桌面应用会返回 cursor://anysphere.cursor-mcp/oauth/callback，因此请允许浏览器打开 Cursor。
“redirect_uri 必须是 https，或仅限 loopback 的 http”	您的客户端在远程主机上注册了纯 http 回调。请使用回调地址为 https 或 loopback 的客户端。
“没有受支持的 redirect_uri；请使用 https 或 loopback http”	您的客户端仅提供了自定义应用回调（私有 scheme），Corebee 不接受此类回调，Cursor 自己的桌面回调除外。请使用回调地址为 https 或 loopback 的客户端。
401 或“需要登录”	重新连接服务以再次登录。应用被撤销（在 设置 > 登录与安全 > 已连接的应用 中）后不久，或您离开工作区时，也会发生这种情况。
“权限不足。所需范围：...”	您的角色无权执行此操作，或者您的客户端只请求了读取范围。请联系所有者，或重新连接并允许客户端请求写入范围（也可以不指定任何范围，这样便可使用您的角色允许的所有权限）。
“此工作区有 N 个小组件；请传入 widget_id。”	调用 list_widgets 并传入您想要的 widget_id。
删除操作返回 confirmation_required	这是预期行为。查看预览，然后使用 confirm_token 批准第二次调用。
“confirm_token 无效、已过期或已使用……”	不带令牌再次调用删除操作，以获取新的预览。
确认后出现“删除联系人时出错”（批量工具会显示“删除联系人时出错”）或“删除知识来源时出错”	未删除任何内容。服务可能无法清除与该项目关联的记录，也可能是在清除这些关联后删除操作本身失败；如果是第二种情况，联系人（或来源）仍然存在，其 CSAT 回复和通话记录（或知识缺口）现已取消关联。请从预览重新开始；如果再次失败，请联系 [email protected]。
set_priority、add_label 或 assign_conversation 因缺少值而失败	请明确传入该值。托管服务无法询问该值。
回复中的 delivered: false	查看 reason。对于电话对话，请在 Corebee 收件箱中跟进。
速率限制错误	等待一分钟后重试。
add_knowledge_url 显示 pending	索引会在后台运行。使用 list_knowledge_sources 再次检查。

支持

• 电子邮件：[email protected]
• 帮助中心：https://corebee.ai/help
• 插件问题：GitHub issues
• 定价：该插件免费且开源；您需要拥有 Corebee 账户（定价）

安全

请通过 [email protected] 或 GitHub 私密漏洞报告 私下报告漏洞。请参阅 SECURITY.md。

许可证

MIT。Corebee 名称和徽标是 COREBEE CHAT LTD 的商标，不受 MIT 许可。