Claude Cowork 财务插件连接器机制解析从 ~~占位符到 MCP 配置的完整实践【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本篇指南以 finance/CONNECTORS.md 为核心深入讲解 knowledge-work-plugins 仓库中 Finance Accounting 插件的工具无关连接机制插件如何通过~~category占位符引用外部工具、各类连接器的可选 MCP 服务器以及如何在实际工作中完成 MCP 配置与连接。读完本文你将掌握占位符的语义与替换流程、财务场景下六大连接器类别的选型清单以及从.mcp.json编写到 MCP 目录检索的完整配置路径。为什么插件需要一套连接器机制财务与会计工作流天然依赖外部系统总账GL数据在 ERP 中经营分析数据在数据仓库里报表发送依赖邮件结账沟通依赖即时通讯。如果插件把具体产品名写死在技能文件里那么换一家数据仓库或换一套 ERP整套技能文档就全部失效。knowledge-work-plugins 仓库的解法是**工具无关tool-agnostic**设计插件文件只描述这一类工具该干什么具体连接哪个产品由用户决定。这套机制的载体正是每个插件根目录下的CONNECTORS.md文件finance/CONNECTORS.md 是财务插件的具体实例。~~ 占位符如何在技能文件中引用外部工具按照 finance/CONNECTORS.md 的说明插件文件使用~~category作为用户在该类别下连接的任何工具的占位符。例如~~data warehouse可能代表 Snowflake、BigQuery或任何其他提供 MCP 服务器的数据仓库。该约定的标准定义也出现在插件开发规范文档 cowork-plugin-management/skills/create-cowork-plugin/references/component-schemas.md 的 CONNECTORS.md 章节中在技能、Agent 等插件文件中以通用方式引用工具例如Check~~project trackerfor open tickets并在插件定制阶段cowork-plugin-customizer 技能将这些占位符替换为具体的工具名。财务插件中的实际占位符使用在 finance 插件中占位符集中出现在两个技能文件里finance/skills/financial-statements/SKILL.md#L34-L40生成财务报表时如果连接了~~erp或~~data warehouse就自动拉取指定期间的试算平衡表、对比期间数据上期、上年、预算以及科目层级未连接时则引导用户粘贴试算平衡表或上传电子表格。finance/skills/journal-entry/SKILL.md#L35-L42准备日记账分录时从~~erp或~~data warehouse自动拉取试算平衡表、子分类账明细、同类往期分录和受影响的 GL 余额。可以看到同一对占位符被多个技能复用——这正是占位符机制的价值一处连接处处生效。用户只需把某个 MCP 服务器接到~~erp类别上所有引用该占位符的技能就同时获得数据源能力。财务插件的六大连接器类别finance/CONNECTORS.md 以表格形式列出了财务插件定义的连接器类别、占位符、随插件预配置的服务器以及可替换的其他选项类别占位符随插件预配置的服务器其他可选服务器数据仓库~~data warehouseSnowflake*、Databricks*、BigQueryRedshift、PostgreSQL电子邮件~~emailMicrosoft 365—Office 套件~~office suiteMicrosoft 365—聊天~~chatSlackMicrosoft TeamsERP / 会计系统~~erp—暂无可用的 MCP 服务器NetSuite、SAP、QuickBooks、Xero分析 / BI~~analytics—暂无可用的 MCP 服务器Tableau、Looker、Power BI表中*标注的含义是占位符——MCP URL 尚未配置。也就是说Snowflake 和 Databricks 虽然被列为预配置服务器但目前只有名称占位实际连接地址还需要用户提供。这体现了插件的开箱即配 按需填充策略既给出推荐方向又不绑定死某一家服务商。按财务工作流理解各类别用途结合 finance/README.md#L57-L79 的 MCP 集成说明每个类别在财务场景中的角色如下ERP / 会计系统~~erp自动拉取试算平衡表、子分类账数据和日记账分录是结账、分录、对账类技能的主数据源。README 给出的可选产品为 NetSuite、SAP 等但当前 CONNECTORS.md 明确暂无可用的 MCP 服务器意味着这类数据目前更多依赖粘贴数据或上传文件完成。数据仓库~~data warehouse用于查询财务数据、执行差异分析、拉取历史对比数据。Snowflake、BigQuery、Databricks 均为候选Redshift 和 PostgreSQL 是替代项。电子表格工作底稿生成、对账模板和财务模型更新对应 README 中的 spreadsheets 类别未出现在 CONNECTORS 表格中但属于 README 推荐的集成方向。分析 / BI~~analytics拉取仪表盘、KPI 与趋势数据用于差异flux分析的业务解释。电子邮件~~email发送报表、发起审批请求预配置 Microsoft 365。聊天~~chat结账状态更新与团队沟通预配置 Slack可替换为 Microsoft Teams。recommendedCategories声明插件需要的集成类别在 finance/README.md#L81-L91 的配置章节中插件通过recommendedCategories字段声明推荐集成的类型清单erp-accounting— 提供 GL、子分类账与 JE 数据的 ERP 或会计系统data-warehouse— 用于财务查询与历史数据的数据仓库spreadsheets— 生成工作底稿的电子表格工具analytics-bi— 提供仪表盘和 KPI 数据的 BI 工具documents— 存放政策、备忘录和支持文档的文档存储email— 发送报表、请求审批的邮件工具chat— 用于结账状态更新和提问的团队沟通工具该字段的完整格式可参考同仓库的示例配置 cowork-plugin-management/skills/cowork-plugin-customizer/examples/customized-mcp.json其中mcpServers块定义了具体服务器如 github、asana、slack 等recommendedCategories数组则列出该插件增强能力所需的集成类别。财务插件的 README 正是用同一机制声明了自己对 ERP、数据仓库等数据源的依赖。从占位符到真实连接MCP 配置完整流程占位符本身不会自动变成工具连接的落地依赖 MCP 服务器配置。整个过程可以分为发现、连接、写配置三步。第一步发现可用的 MCP 服务器根据插件定制规范 cowork-plugin-management/skills/cowork-plugin-customizer/references/mcp-servers.md可以通过search_mcp_registry工具检索 MCP 目录传入关键字数组后返回最多 10 个结果每个结果包含nameMCP 显示名称description一行描述tools该 MCP 提供的工具列表urlMCP 端点地址写入.mcp.json时使用directoryUuid用于suggest_connectors的 UUIDconnected用户是否已连接该 MCP该文档还给出了类别到搜索关键字的映射表与财务插件的连接器类别直接对应类别搜索关键字data-warehouse[bigquery, snowflake, redshift]email[gmail, outlook, email]chat[slack, teams, discord]analytics-bi[datadog, grafana, analytics]例如要为财务插件的~~data warehouse占位符寻找真实服务器就用[bigquery, snowflake, redshift]检索 MCP 目录。第二步连接与配置写入标准流程为找到~~前缀的占位符 → 检索该类别 → 向用户展示候选结果并确认 → 若未连接则调用suggest_connectors展示连接按钮 → 将返回的url写入 MCP 配置。配置文件的落点规则依据 mcp-servers.md先检查plugin.json是否含mcpServers字段若有则编辑其指向的文件若无该字段使用插件根目录的.mcp.json默认位置若mcpServers只指向.mcpb打包服务器则在插件根目录新建.mcp.json。第三步.mcp.json 的三种服务器写法依据 component-schemas.md 的 MCP 服务器章节.mcp.json支持三种传输类型stdio本地进程{ mcpServers: { my-server: { command: node, args: [${CLAUDE_PLUGIN_ROOT}/servers/server.js], env: { API_KEY: ${API_KEY} } } } }SSE远程服务器Server-Sent Events 传输{ mcpServers: { asana: { type: sse, url: https://mcp.asana.com/sse } } }HTTP远程服务器流式 HTTP 传输{ mcpServers: { api-service: { type: http, url: https://api.example.com/mcp, headers: { Authorization: Bearer ${API_TOKEN} } } } }所有 MCP 配置都支持${VAR_NAME}环境变量替换其中${CLAUDE_PLUGIN_ROOT}始终指向插件目录用于保证配置的可移植性其他用户环境变量如 API Token也以同样语法注入。另有两点细节值得注意无 URL 的目录服务器某些 MCP 目录条目没有url端点由管理员动态提供此时可按名称引用——只要插件 MCP 配置中的服务器名称与目录条目名称一致即等同 URL 匹配。认证头HTTP 类型服务器通常需要在headers中携带认证信息如示例中的Authorization: Bearer ${API_TOKEN}。财务插件读者可以据此把 Snowflake 或 BigQuery 的 MCP 服务器填入.mcp.json完成对~~data warehouse占位符的落地。占位符的解析与定制时机从仓库文档可以推断~~占位符的替换发生在插件定制customization阶段而非运行时。这一机制在 component-schemas.md 中有明确说明在通过 cowork-plugin-customizer 技能进行定制时这些占位符会被替换为具体的工具名。换句话说技能文件SKILL.md永远保持工具无关只写~~erp、~~data warehouse这类通用引用确保插件文档不随用户的技术栈变化而失效用户的个性化发生在配置层——通过.mcp.json连接具体 MCP 服务器通过定制流程把占位符替换成自己使用的产品名CONNECTORS.md 扮演翻译表角色让用户和 Agent 都能随时查到某个占位符对应哪些真实产品选项。实操建议为财务插件接通数据源综合以上机制为 finance 插件实际接通数据源的最小路径是明确数据缺口结账、分录、报表生成技能都优先依赖~~erp与~~data warehousefinancial-statements/SKILL.md 与 journal-entry/SKILL.md 均在技能开头声明了这一依赖检索并选择用search_mcp_registry检索对应类别数据仓库用bigquery/snowflake/redshift关键字确认用户实际使用的产品是否有 MCP 服务器连接服务器未连接时通过suggest_connectors完成连接写入配置将返回的url或按名称引用写入插件根目录的.mcp.json必要时补充headers认证与环境变量无数据源时的降级路径README 与两个技能文件都明确指出未连接数据源时可以粘贴试算平衡表数据、上传电子表格或直接提供损益数据工作流依然可运行只是从自动拉取退化为手动提供。这套占位符 CONNECTORS.md .mcp.json的三层结构是 knowledge-work-plugins 仓库所有领域插件通用的连接模式。理解 finance 插件的这一实现也就掌握了整个仓库插件体系与外部系统集成的核心思路。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Cowork 财务插件连接器机制解析：从 ~~占位符到 MCP 配置的完整实践
Claude Cowork 财务插件连接器机制解析从 ~~占位符到 MCP 配置的完整实践【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本篇指南以 finance/CONNECTORS.md 为核心深入讲解 knowledge-work-plugins 仓库中 Finance Accounting 插件的工具无关连接机制插件如何通过~~category占位符引用外部工具、各类连接器的可选 MCP 服务器以及如何在实际工作中完成 MCP 配置与连接。读完本文你将掌握占位符的语义与替换流程、财务场景下六大连接器类别的选型清单以及从.mcp.json编写到 MCP 目录检索的完整配置路径。为什么插件需要一套连接器机制财务与会计工作流天然依赖外部系统总账GL数据在 ERP 中经营分析数据在数据仓库里报表发送依赖邮件结账沟通依赖即时通讯。如果插件把具体产品名写死在技能文件里那么换一家数据仓库或换一套 ERP整套技能文档就全部失效。knowledge-work-plugins 仓库的解法是**工具无关tool-agnostic**设计插件文件只描述这一类工具该干什么具体连接哪个产品由用户决定。这套机制的载体正是每个插件根目录下的CONNECTORS.md文件finance/CONNECTORS.md 是财务插件的具体实例。~~ 占位符如何在技能文件中引用外部工具按照 finance/CONNECTORS.md 的说明插件文件使用~~category作为用户在该类别下连接的任何工具的占位符。例如~~data warehouse可能代表 Snowflake、BigQuery或任何其他提供 MCP 服务器的数据仓库。该约定的标准定义也出现在插件开发规范文档 cowork-plugin-management/skills/create-cowork-plugin/references/component-schemas.md 的 CONNECTORS.md 章节中在技能、Agent 等插件文件中以通用方式引用工具例如Check~~project trackerfor open tickets并在插件定制阶段cowork-plugin-customizer 技能将这些占位符替换为具体的工具名。财务插件中的实际占位符使用在 finance 插件中占位符集中出现在两个技能文件里finance/skills/financial-statements/SKILL.md#L34-L40生成财务报表时如果连接了~~erp或~~data warehouse就自动拉取指定期间的试算平衡表、对比期间数据上期、上年、预算以及科目层级未连接时则引导用户粘贴试算平衡表或上传电子表格。finance/skills/journal-entry/SKILL.md#L35-L42准备日记账分录时从~~erp或~~data warehouse自动拉取试算平衡表、子分类账明细、同类往期分录和受影响的 GL 余额。可以看到同一对占位符被多个技能复用——这正是占位符机制的价值一处连接处处生效。用户只需把某个 MCP 服务器接到~~erp类别上所有引用该占位符的技能就同时获得数据源能力。财务插件的六大连接器类别finance/CONNECTORS.md 以表格形式列出了财务插件定义的连接器类别、占位符、随插件预配置的服务器以及可替换的其他选项类别占位符随插件预配置的服务器其他可选服务器数据仓库~~data warehouseSnowflake*、Databricks*、BigQueryRedshift、PostgreSQL电子邮件~~emailMicrosoft 365—Office 套件~~office suiteMicrosoft 365—聊天~~chatSlackMicrosoft TeamsERP / 会计系统~~erp—暂无可用的 MCP 服务器NetSuite、SAP、QuickBooks、Xero分析 / BI~~analytics—暂无可用的 MCP 服务器Tableau、Looker、Power BI表中*标注的含义是占位符——MCP URL 尚未配置。也就是说Snowflake 和 Databricks 虽然被列为预配置服务器但目前只有名称占位实际连接地址还需要用户提供。这体现了插件的开箱即配 按需填充策略既给出推荐方向又不绑定死某一家服务商。按财务工作流理解各类别用途结合 finance/README.md#L57-L79 的 MCP 集成说明每个类别在财务场景中的角色如下ERP / 会计系统~~erp自动拉取试算平衡表、子分类账数据和日记账分录是结账、分录、对账类技能的主数据源。README 给出的可选产品为 NetSuite、SAP 等但当前 CONNECTORS.md 明确暂无可用的 MCP 服务器意味着这类数据目前更多依赖粘贴数据或上传文件完成。数据仓库~~data warehouse用于查询财务数据、执行差异分析、拉取历史对比数据。Snowflake、BigQuery、Databricks 均为候选Redshift 和 PostgreSQL 是替代项。电子表格工作底稿生成、对账模板和财务模型更新对应 README 中的 spreadsheets 类别未出现在 CONNECTORS 表格中但属于 README 推荐的集成方向。分析 / BI~~analytics拉取仪表盘、KPI 与趋势数据用于差异flux分析的业务解释。电子邮件~~email发送报表、发起审批请求预配置 Microsoft 365。聊天~~chat结账状态更新与团队沟通预配置 Slack可替换为 Microsoft Teams。recommendedCategories声明插件需要的集成类别在 finance/README.md#L81-L91 的配置章节中插件通过recommendedCategories字段声明推荐集成的类型清单erp-accounting— 提供 GL、子分类账与 JE 数据的 ERP 或会计系统data-warehouse— 用于财务查询与历史数据的数据仓库spreadsheets— 生成工作底稿的电子表格工具analytics-bi— 提供仪表盘和 KPI 数据的 BI 工具documents— 存放政策、备忘录和支持文档的文档存储email— 发送报表、请求审批的邮件工具chat— 用于结账状态更新和提问的团队沟通工具该字段的完整格式可参考同仓库的示例配置 cowork-plugin-management/skills/cowork-plugin-customizer/examples/customized-mcp.json其中mcpServers块定义了具体服务器如 github、asana、slack 等recommendedCategories数组则列出该插件增强能力所需的集成类别。财务插件的 README 正是用同一机制声明了自己对 ERP、数据仓库等数据源的依赖。从占位符到真实连接MCP 配置完整流程占位符本身不会自动变成工具连接的落地依赖 MCP 服务器配置。整个过程可以分为发现、连接、写配置三步。第一步发现可用的 MCP 服务器根据插件定制规范 cowork-plugin-management/skills/cowork-plugin-customizer/references/mcp-servers.md可以通过search_mcp_registry工具检索 MCP 目录传入关键字数组后返回最多 10 个结果每个结果包含nameMCP 显示名称description一行描述tools该 MCP 提供的工具列表urlMCP 端点地址写入.mcp.json时使用directoryUuid用于suggest_connectors的 UUIDconnected用户是否已连接该 MCP该文档还给出了类别到搜索关键字的映射表与财务插件的连接器类别直接对应类别搜索关键字data-warehouse[bigquery, snowflake, redshift]email[gmail, outlook, email]chat[slack, teams, discord]analytics-bi[datadog, grafana, analytics]例如要为财务插件的~~data warehouse占位符寻找真实服务器就用[bigquery, snowflake, redshift]检索 MCP 目录。第二步连接与配置写入标准流程为找到~~前缀的占位符 → 检索该类别 → 向用户展示候选结果并确认 → 若未连接则调用suggest_connectors展示连接按钮 → 将返回的url写入 MCP 配置。配置文件的落点规则依据 mcp-servers.md先检查plugin.json是否含mcpServers字段若有则编辑其指向的文件若无该字段使用插件根目录的.mcp.json默认位置若mcpServers只指向.mcpb打包服务器则在插件根目录新建.mcp.json。第三步.mcp.json 的三种服务器写法依据 component-schemas.md 的 MCP 服务器章节.mcp.json支持三种传输类型stdio本地进程{ mcpServers: { my-server: { command: node, args: [${CLAUDE_PLUGIN_ROOT}/servers/server.js], env: { API_KEY: ${API_KEY} } } } }SSE远程服务器Server-Sent Events 传输{ mcpServers: { asana: { type: sse, url: https://mcp.asana.com/sse } } }HTTP远程服务器流式 HTTP 传输{ mcpServers: { api-service: { type: http, url: https://api.example.com/mcp, headers: { Authorization: Bearer ${API_TOKEN} } } } }所有 MCP 配置都支持${VAR_NAME}环境变量替换其中${CLAUDE_PLUGIN_ROOT}始终指向插件目录用于保证配置的可移植性其他用户环境变量如 API Token也以同样语法注入。另有两点细节值得注意无 URL 的目录服务器某些 MCP 目录条目没有url端点由管理员动态提供此时可按名称引用——只要插件 MCP 配置中的服务器名称与目录条目名称一致即等同 URL 匹配。认证头HTTP 类型服务器通常需要在headers中携带认证信息如示例中的Authorization: Bearer ${API_TOKEN}。财务插件读者可以据此把 Snowflake 或 BigQuery 的 MCP 服务器填入.mcp.json完成对~~data warehouse占位符的落地。占位符的解析与定制时机从仓库文档可以推断~~占位符的替换发生在插件定制customization阶段而非运行时。这一机制在 component-schemas.md 中有明确说明在通过 cowork-plugin-customizer 技能进行定制时这些占位符会被替换为具体的工具名。换句话说技能文件SKILL.md永远保持工具无关只写~~erp、~~data warehouse这类通用引用确保插件文档不随用户的技术栈变化而失效用户的个性化发生在配置层——通过.mcp.json连接具体 MCP 服务器通过定制流程把占位符替换成自己使用的产品名CONNECTORS.md 扮演翻译表角色让用户和 Agent 都能随时查到某个占位符对应哪些真实产品选项。实操建议为财务插件接通数据源综合以上机制为 finance 插件实际接通数据源的最小路径是明确数据缺口结账、分录、报表生成技能都优先依赖~~erp与~~data warehousefinancial-statements/SKILL.md 与 journal-entry/SKILL.md 均在技能开头声明了这一依赖检索并选择用search_mcp_registry检索对应类别数据仓库用bigquery/snowflake/redshift关键字确认用户实际使用的产品是否有 MCP 服务器连接服务器未连接时通过suggest_connectors完成连接写入配置将返回的url或按名称引用写入插件根目录的.mcp.json必要时补充headers认证与环境变量无数据源时的降级路径README 与两个技能文件都明确指出未连接数据源时可以粘贴试算平衡表数据、上传电子表格或直接提供损益数据工作流依然可运行只是从自动拉取退化为手动提供。这套占位符 CONNECTORS.md .mcp.json的三层结构是 knowledge-work-plugins 仓库所有领域插件通用的连接模式。理解 finance 插件的这一实现也就掌握了整个仓库插件体系与外部系统集成的核心思路。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考