用途
本技能用于发现和调用已连接集成（如 Linear、GitHub、Sentry、Notion）所提供的工具。每个集成是一个已安装插件并连接了账户，其工具不由本地执行，而是通过 superset mcp 交由 Superset API 转发至插件的 MCP 服务器，凭据由 API 附加，不写入本机。因此即使沙箱无法直接访问 Linear，也能通过此方式创建 Linear 问题。
主要能力
- 列出已连接账户及其状态，识别可调用、需连接、未安装等情况。
- 列出指定插件暴露的工具名称与描述（来自插件自身服务器，可能随版本变化）。
- 调用工具，支持从标准输入读取参数（适合传递敏感信息）。
- 返回 MCP 原始结果，通常为包含 JSON 字符串的 content 数组。
使用方式
- 查找集成：运行
superset plugins list，查看 STATUS 列：connected: <account>表示可调用；needs connection表示已安装但未授权；not installed表示插件已移除但凭据仍有效。CONNECTION 列为连接 ID，PLUGIN 列为所属连接器。 - 列出工具：
superset mcp tools --plugin linear，可用 jq 仅取名称：superset mcp tools --plugin linear | jq -r '.[].tool'。调用前务必先列出，不要猜测工具名。描述中通常包含参数说明，应阅读完整描述。 - 调用工具：
superset mcp call-tool list_issues --plugin linear或带参数superset mcp call-tool create_issue --plugin linear '{"team":"ENG","title":"Export 500s"}'，也可从标准输入读取：echo '{...}' | superset mcp call-tool create_issue --plugin linear -。工具名为第一个位置参数，插件通过--plugin指定，参数为第二个位置参数，默认{}，-表示从标准输入读取。敏感信息建议用标准输入，避免出现在进程列表或 shell 历史中。
当其他技能期望的工具缺失时
插件自带的技能可能声明原生 MCP 工具（如 mcp__linear__*），这些工具仅在插件 MCP 服务器写入代理配置时存在，目前仅对 Claude Code 和 Codex 生效。在其他代理上，应继续使用本技能通过 superset mcp tools 和 call-tool 完成相同操作，不要中断或告知用户集成不可用；原技能中对任务质量的判断仍然适用，仅传输方式改变。
常见错误解读
"x" is not connected. Connect an account first.：该名称下无授权，或插件未安装。运行superset plugins connect x或先安装。--connection takes a plugin name now, not a connection id.：传入了 UUID，应使用--plugin <name>。Missing required argument: <tool>：call-tool第一个参数应为工具名，插件用--plugin。Arguments must be JSON: ...：第二个位置参数应为 JSON 对象，作为一个 shell 词引用。- 工具返回 401 或 403：先阅读错误。仅在明确提示凭据无效、撤销或过期时重连；若 403 指明作用域、权限或资源，表示账户缺少相应权限，重连同一账户无效。
needs connection：已安装未授权，通过 mcp 传参无法解决。
反模式
- 未先列出工具就直接调用（猜测名称和参数结构）。
- 使用已弃用的
--connection或--plugin-id（均拒绝 UUID）。 - 命令支持标准输入时仍将凭据作为参数传递。
- 自行选择多个已连接账户中的一个（应由用户决定）。
- 遇到任何 403 都重连（其中一半是现有账户的权限问题）。
- 调用因授权失败时使用
superset plugins sync（该命令仅同步本机技能，与凭据无关）。 - 为查看插件功能而安装或连接（会写入用户账户并影响其所有设备，应先询问并使用 plugins 技能）。
适用场景
需要与已连接的 Linear、GitHub、Sentry、Notion 等集成交互，且已通过 plugins 技能完成安装和连接之后。
限制
- 本技能不负责安装、连接或市场操作，这些属于 plugins 技能。
- 工具名称、描述和参数结构由插件服务器定义，可能随版本变化；没有输入 schema，需依赖描述和错误反馈。
- 原生 MCP 工具仅在 Claude Code 和 Codex 中可用。
- 凭据不写入本机，但调用依赖 Superset API 可访问。