SuperAPI AI 工具集

integrations

通用与其它

查看项目

更新于 10-30 16:30

技能介绍

用途 本技能处理“集成已安装且账户已连接”之后的调用环节。集成是带已连接账户的已安装插件,其工具不在本机运行;superset mcp 把调用交给 Superset API,由 API 附加已保存的凭证并转发到插件的 MCP 服务器,因此凭证不会写入本机。

前置说明 安装、连接与市场属于 plugins 技能;本技能从“已有连接”开始,只有两步:列出工具,然后调用。

主要能力与使用方式

  1. 查找集成:运行 superset plugins list,每个已连接账户一行,无连接时仅一行。查看 STATUS 列:connected: <account> 可调用;needs connection 表示技能已装但账户未授权,其工具会失败,这属于连接步骤而非缺陷;not installed 表示连接仍在但插件已移除,凭证仍有效,PLUGIN 列给出所属连接器。CONNECTION 列保存连接 id,无连接时为空。一个插件有两个已连接账户时会出现两行。
  2. 调用前先列出工具:superset mcp tools --plugin linear,或用 jq -r '.[].tool' 只取名称。工具名称与描述来自插件自身服务器,不同插件版本会变化,不要调用未列出的工具。列表只给名称与描述、不给输入 schema,参数说明写在描述中,应阅读完整描述;若结构仍不明确,错误调用会返回命名出错字段的工具错误,据此修正。
  3. 调用:superset mcp call-tool list_issues --plugin linear;带参数如 superset mcp call-tool create_issue --plugin linear '{"team":"ENG","title":"Export 500s"}';也可用 - 从 stdin 读取参数,适合敏感内容,因为参数会出现在 ps 与 shell 历史中。工具名是第一个位置参数,插件始终通过 --plugin 传入;参数是第二个位置参数,默认 {}。返回的是 MCP 原始结果,即 content 数组,其文本部分通常本身是 JSON 字符串,可用 jq -r '.content[0].text' | jq 解析。

当其他技能期望的工具不存在 插件自带技能按原生 MCP 工具编写(如 mcp__linear__*),这些工具只在插件 MCP 服务器写入代理配置时存在,CLI 安装不会做到,目前仅 Claude Code 与 Codex 如此。在其他代理上工具列表中没有这些工具时,不要停止,也不要告知用户集成不可用,而应改用已连接账户上的等价命令:先 superset mcp tools --plugin linear 查看能力,再 superset mcp call-tool ... --plugin linear 调用;同时继续遵循原技能关于好 issue、好分诊的判断,只更换传输方式。

失败解读 “x” is not connected:该名称下无授权,或插件已卸载,可运行 superset plugins connect x 或先安装。传了 UUID 给 --connection:该参数现已接收插件名,使用 --plugin <name>。superset mcp tools 无目标:需加 --plugin <name>。Missing required argument:call-tool 先接工具名,插件放 --plugin。Arguments must be JSON:第二个位置参数须为整体引用的 JSON 对象。工具返回 401 或 403:先读错误,只有明确为无效、撤销或过期凭证时才重连;403 若指明范围、权限或资源,说明账户缺少该访问权,重连同一账户无效。needs connection:已装未授权,mcp 参数无法修复。

反模式 未先列工具就调用(等于猜测插件拥有的名称与 schema);使用 --connection 或 --plugin-id(已弃用别名且拒绝 UUID);命令支持 stdin 时仍把凭证作为参数传入;自行挑选多个已连接账户之一(应由用户决定);对任何 403 都重连;调用因授权失败时转而执行 superset plugins sync(它只同步本机技能,与凭证无关);为查看功能而安装或连接插件(会写入用户账户并影响其登录的所有机器,须先询问并使用 plugins 技能)。

适用场景与限制 适用于已连接集成上的工具发现与调用,以及插件技能假定的原生 MCP 工具缺失时的替代通道。限制:需已有连接;工具名与描述随插件版本变化;列表不含 schema;本机不保存凭证;原生 MCP 工具仅部分代理支持。