knowledge-work-plugins 企业搜索插件连接器Connectors完全指南~~category占位符机制与 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导读本指南围绕enterprise-search企业搜索插件的 CONNECTORS.md 展开系统讲解该插件的核心连接机制以~~category类别占位符指代用户实际接入的工具Slack、Microsoft 365、Notion 等从而让插件保持**工具无关tool-agnostic**的设计。读完本文你将理解占位符的工作方式与解析原则、七大类连接器的能力边界与推荐服务器组合、.mcp.json中预配置的 MCP 服务器细节以及如何按需接入新源、利用源优先级与速率限制感知扩展企业搜索的覆盖面。什么是~~category占位符在enterprise-search插件的所有文件中~~category并不是某个具体工具的硬编码名称而是一个类别占位符代表用户在该类别中接入的任意工具。例如~~chat可能指 Slack也可能指 Microsoft Teams 或其他提供 MCP 服务器的聊天工具。这种设计的核心价值在于插件与具体产品解耦工作流只按类别chat、email、cloud storage 等描述不绑定特定 SaaS 产品一套工作流适配任意接入方.mcp.json虽然预配置了特定 MCP 服务器但同类别下的任何 MCP 服务器都可正常工作搜索结果天然带源标签插件在搜索输出中以~~chat:、~~email:作为来源标记这些标记是动态的会随用户实际连接的工具解析为对应名称。在 README.md 的搜索示例中可以看到这些占位符的典型用法~~chat: #engineering thread from Tuesday with the decision ~~email: Follow-up email from Sarah with the spec ~~cloud storage: Updated API design doc (modified yesterday)本插件的连接器总览CONNECTORS.md 给出了完整的连接器对照表定义了类别、占位符、仓库预配置服务器与可选替代方案类别占位符预配置服务器其他可选方案聊天~~chatSlackMicrosoft Teams、Discord邮件~~emailMicrosoft 365—云存储~~cloud storageMicrosoft 365Dropbox知识库~~knowledge baseNotion、GuruConfluence、Slite项目跟踪~~project trackerAtlassianJira/Confluence、AsanaLinear、monday.comCRM~~CRM未预配置Salesforce、HubSpot办公套件~~office suiteMicrosoft 365Google Workspace关键点解读CRM 类别刻意留空源码层面的.mcp.json没有为 CRM 预配置服务器这是有意为之——CRM 工具高度因企业而异需要用户按需自行接入Microsoft 365 一源多用它同时承担邮件、云存储、办公套件三个类别的预配置角色因为这三个能力通常由同一套账号体系提供聊天类别选项最丰富Slack 之外还有 Teams、Discord说明该类别抽象层足够宽。预配置服务器.mcp.json实际内容占位符机制的落地点是仓库根目录的.mcp.json。它预配置了 7 个 MCP 服务器均为 HTTP 类型其中部分还带 OAuth 配置{ mcpServers: { slack: { type: http, url: https://mcp.slack.com/mcp, oauth: { clientId: 1601185624273.8899143856786, callbackPort: 3118 } }, notion: { type: http, url: https://mcp.notion.com/mcp }, guru: { type: http, url: https://mcp.api.getguru.com/mcp }, atlassian: { type: http, url: https://mcp.atlassian.com/v1/mcp }, asana: { type: http, url: https://mcp.asana.com/v2/mcp }, google calendar: { type: http, url: }, gmail: { type: http, url: } } }从配置内容可以观察到的实现事实Slack 是唯一带 OAuth 明细的服务器callbackPort: 3118用于本地回环完成授权回调其他服务器大多走云托管 MCPURL 指向各厂商官方 MCP 端点google calendar与gmail的 url 为空字符串表明这两项属于预留占位需要用户在实际环境中填入自己的 MCP 端点后才可使用Atlassian 一个端点覆盖 Jira Confluencehttps://mcp.atlassian.com/v1/mcp同时支撑~~project tracker与~~knowledge base两个类别。占位符在技能层如何被使用~~category占位符不只是文档约定它贯穿了插件的五个技能Skill的搜索编排逻辑具体见各技能目录search-strategy/SKILL.md负责查询分解与多源搜索编排。它把一句自然语言问题拆成每个源各自的子查询例如将 What did we decide about the API migration timeline? 分解为~~chat:、~~knowledge base:、~~project tracker:三条定向查询并提供每类源的过滤器映射表如from:sarah→ chat 语法from:sarah或from:USERIDtype:thread→is:threadtype:file→has:filesource-management/SKILL.md通过检查可用工具前缀判断哪些源已连接If a tool prefix is available, the source is connected and searchable并维护按查询类型划分的源优先级顺序例如决策类查询优先搜~~chat→~~email→~~cloud storage状态类查询优先搜项目跟踪器同时定义速率限制HTTP 429、rate limit、too many requests的检测与降级策略knowledge-synthesis/SKILL.md跨源去重、置信度评分基于新鲜度 × 权威性 × 一致性与引用归属每条结论都带~~category来源标注search/SKILL.md 与 digest/SKILL.md两个用户可触发的命令入口前者负责单查询全源搜索后者负责按--daily/--weekly生成跨源汇总。这些技能文件头部均通过相对链接指回 CONNECTORS.md说明连接器说明是理解所有技能的前提文档。各连接器类别的搜索能力每个已连接源对应一组 MCP 工具其关键能力依据 source-management/SKILL.md 与 search/SKILL.md 整理源可搜索内容典型 MCP 能力~~chat消息、线程、频道、私信搜索消息、读取频道与线程~~email邮件、附件、会话搜索消息、读取单封邮件~~cloud storage文档、表格、幻灯片、PDF搜索文件、获取文档内容~~project tracker任务、议题、史诗、里程碑任务搜索、typeahead 搜索~~CRM账户、联系人、商机查询记录对象~~knowledge base内部文档、runbook语义搜索、关键词搜索接入原则很简单每个源都是一个 MCP 连接在 MCP 设置中加入更多服务器即可扩大可搜索范围。README 建议从~~chat、~~email、~~cloud storage三类起步再按需加入 wiki、项目管理与 CRM。接入新源的操作流程插件对任何符合 MCP 协议的源都开放。依据 source-management/SKILL.md 中 Adding Custom Sources 一节接入流程为在.mcp.json中新增 MCP 服务器配置type、url必要时加 oauth按提示完成认证search与digest命令会根据可用的工具前缀自动检测并纳入新源无需改动技能代码。对尚未连接的工具插件会给出引导话术Tool name isnt currently connected... Open your MCP settings → Add the MCP server configuration → Authenticate连接后自动进入后续搜索范围。常见问题与实用建议搜索到陌生的~~占位符怎么办这正是类别标记的本意——它们会在运行时解析为实际工具。若不确定当前连接了哪些工具可查阅 CONNECTORS.md 与 README.md未连接任何源时search / digest 命令会提示先接入至少一个源单源也可用即使只连了一个源命令仍会返回该源的可用结果多源必须并行所有技能均强调子查询并行执行总耗时约等于最慢单源而非各源之和。结语~~category占位符机制是enterprise-search插件实现一次提问、全源搜索、合成作答的基石它让插件描述的是类别级工作流而非产品级绑定用户切换或新增工具时无需改动任何技能逻辑只需维护.mcp.json中的服务器清单。对希望扩展企业搜索覆盖面的使用者而言理解连接器对照表、预配置服务器的实际形态以及源的自动发现机制即可快速搭建属于自己的跨工具统一知识检索入口。【免费下载链接】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），仅供参考