SuperAPI AI 工具集

connect

办公与效率

查看项目

更新于 10-16 08:18

技能介绍

用途

Connect 是 Well 插件的连接与验证技能,用于在安装 Well 插件后确认 MCP 服务器已注册、完成一次性认证,并验证 Well 工具是否正常工作。当用户运行 /well:connect、刚安装 Well 插件,或 Well 工具没有响应时使用。

主要能力

  • 确认 well MCP 服务器已注册并处于活动状态。
  • 引导用户完成基于 OAuth 的一次性浏览器登录认证,无需 API key 或额外配置。
  • 通过调用 well_get_schema 验证连接是否可用,并返回可用的数据根类型(如 companies、invoices、transactions、ledger_accounts 等)。
  • 连接成功后提供三个可直接使用的示例提问,帮助用户快速获得价值。
  • 提示可用的进阶技能,包括 /well:reconciliation、/well:vat-summary、/well:ar-aging、/well:month-end-close、/well:compte-de-resultat、/well:balance-sheet、/well:cash-flow-forecast。

使用方式

  1. 确认 MCP 服务器已注册:如果用户刚安装插件,提示运行 /reload-plugins,然后运行 /mcp 查看 well 是否出现。
  2. 认证:运行 /mcp,选择 well,然后选择 Authenticate。浏览器会打开,登录 Well 账户并批准即可。如果 /mcp 显示 well 已认证,则跳过此步。
  3. 验证:调用 well_get_schema(无参数)。如果返回 roots 列表,说明连接正常,可告知用户“Connected ✓,N 个数据类型可用”。如果返回认证错误,回到第 2 步;如果返回服务器错误,说明连接正常但工作区数据路径可能暂时不可用。
  4. 展示可问的问题:连接后提供三个具体示例,例如“Summarize last month's cash flow”“List my unpaid invoices over €5,000”“Build my compte de résultat for the last quarter”。

适用场景

  • 刚安装 Well 插件后需要完成首次连接。
  • Well 工具无响应或需要排查连接问题。
  • 需要确认 MCP 连接状态和可用数据类型。
  • 需要快速了解连接后可以提出哪些问题。

限制

  • 认证方式为 OAuth 浏览器登录,首次连接需要一次性登录。
  • 工具调用会消耗 Well credits,按工作区计划计费;仅在用户询问费用时提及。
  • 如果工作区数据路径暂时不可用,well_get_schema 可能返回服务器错误,此时连接本身正常。
  • 具体可用数据类型和进阶技能的实际行为取决于 Well 工作区配置,资料中未提供更详细的错误处理或配置说明。