Fathom 插件 1.0.0 深度解读Cursor Agent 通过远程 MCP 与 OAuth 接入 Fathom 会议记录与摘要【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/pluginsFathom 是plugins125/plugins仓库third_party目录下的一个 Cursor 插件其核心价值在于让编辑器内的 Agent 直接读取 Fathom 的会议录制、转写文本与 AI 摘要进而起草跟进邮件、提取决策要点。本篇以该插件 CHANGELOG.md 中 1.0.0 初始版本的三条变更记录为骨架结合同目录 README.md 与 mcp.json 展开并对照仓库内 Zoom、X、GitHub 等同类第三方插件完整梳理其 MCP 接入方式、OAuth 认证模型、能力边界与使用前提。读完本文你将掌握该插件从安装、鉴权到实际调用的完整链路也能理解零密钥配置的远程 MCP 插件在 Cursor 生态中的落地形态。一、1.0.0 版本变更全景三条记录背后的完整架构CHANGELOG.md 是这份插件的版本档案其 1.0.0 初始发布仅包含三条变更但每一条都对应插件的一个关键设计决策Added thefathomMCP server pointing athttps://api.fathom.ai/mcp.Auth uses OAuth — no API key or client ID to configure.Logo: Fathoms official mark, from thefathom-videoGitHub organization.逐条拆解接入方式是远程 MCP 服务器而非本地桥接插件声明了一个名为fathom的 MCP 服务器地址指向https://api.fathom.ai/mcp。这意味着 Agent 与 Fathom 之间的通信完全走 Fathom 官方托管的 HTTP MCP 端点插件本身不需要携带任何会议数据抓取、转写或摘要逻辑也不需要在本地启动代理进程。认证走 OAuth零密钥配置这是该插件与仓库内大多数第三方插件最显著的区别——不需要 API Key、不需要 Client ID/Secret用户只需在连接时完成 Fathom 账号的 OAuth 授权即可。品牌资产遵循官方来源Logo 采用 Fathom 官方标志来源于fathom-videoGitHub 组织避免使用非官方或仿冒图标。从仓库目录结构看该插件全部文件仅包含 assets/logo.png、CHANGELOG.md、LICENSE、README.md 和 mcp.json 五个文件是一个纯声明式、无代码的插件——这正是远程 MCP 服务器 官方托管运行时这类插件形态的典型特征接入成本被压缩到一份配置。二、插件核心配置一份 mcp.json 完成全部接入插件的实际接入配置保存在 mcp.json 中全文如下{ mcpServers: { fathom: { type: http, url: https://api.fathom.ai/mcp } } }关键字段说明mcpServersMCP 服务器集合键名fathom即该服务器在 Cursor 内的唯一标识。type: http声明这是一个基于 HTTP 传输的远程 MCP 服务器区别于 stdio 本地进程型服务器。url服务器端点。注意此处是fathom.ai域名而非品牌名fathom.videoREADME 明确指出 Fathom 品牌为 fathom.video但 API 与 MCP 服务统一由fathom.ai提供详见后文易混淆点澄清。值得注意该配置块中没有任何auth字段。对比同仓库 third_party/zoom/mcp.jsonZoom 插件需要在auth块中显式提供CLIENT_ID与CLIENT_SECRET而 Fathom 的配置保持最简因为其服务端自身实现了 OAuth 授权流程客户端无需预置任何凭据。从仓库级规范看Cursor 插件清单 schemas/plugin.schema.json 定义了mcpServers字段其$defs.mcpServersschemas/plugin.schema.json允许声明为字符串路径、内联对象或二者的数组说明以 MCP 配置驱动插件能力是本仓库插件体系中一等公民的接入方式Fathom 正是其中纯内联对象 远程托管的代表。README 还补充了一个重要原则托管运行时是工具名与 Schema 的唯一事实来源。也就是说Agent 实际能调用哪些工具、每个工具的参数结构均由 Fathom 官方 MCP 服务器在运行时动态暴露插件本身不维护工具清单这保证了 Agent 拿到的永远是服务端最新定义的接口。三、安装与首次连接按照 README.md 的指引安装该插件有两种途径插件市场安装打开Cursor Settings → Plugins搜索Fathom点击Install随后按提示完成 Fathom 账号登录。聊天指令安装在 Cursor 聊天中直接运行/add-plugin fathom。连接过程中的关键节点是登录提示当插件建立连接时Cursor 会弹出 Fathom 的 OAuth 登录流程用户完成授权后连接即建立。由于采用 OAuth整个过程无需手动粘贴任何 Token、API Key 或客户端凭据。四、OAuth 认证模型为什么它是零配置的Fathom 插件选择 OAuth 而非密钥注入是其 1.0.0 版本最核心的设计差异。理解这一点可以从仓库内其他第三方插件的认证演进对照来看插件认证方式配置成本Fathom服务端 OAuth无任何客户端凭据零配置连接时登录即可Zoom手动注册 OAuth 客户端插件声明CLIENT_ID/CLIENT_SECRET变量并透传给 MCP auth需要管理员在 Zoom 市场创建应用、配置回调地址X2.0.0 起从X_BEARER_TOKEN演进为 OAuth 用户登录见 third_party/x/CHANGELOG.md需要声明 Client ID 与 scopesGitHubGITHUB_PERSONAL_ACCESS_TOKEN经 Authorization 头透传见 third_party/github/CHANGELOG.md用户自备 Token从 third_party/x/mcp.json 可以看到X 插件在 OAuth 模式下需要在auth块中携带CLIENT_ID并声明tweet.read、users.read、offline.access等一长串 scopes而 Fathom 的 mcp.json 完全没有这些字段。这说明 Fathom 官方服务器将客户端注册环节内置到了授权流程中用户侧感知为零配置。一个需要明确的语义OAuth 授权后工具调用以授权用户的 Fathom 身份执行——也就是说 Agent 能看到的会议、转写与摘要范围等同于该 Fathom 账号的可见范围权限边界由账号本身决定。README 还提示Fathom 帮助中心提供按工具粒度的开关管理员可以收窄连接器暴露的工具面。五、Agent 能力矩阵连接之后能做什么连接建立后Agent 可获得的能力在 README 中以表格形式给出类别能力Meetings列出与搜索会议可按会议类型过滤Recordings查询录制文件及其元数据Transcripts summaries拉取完整转写文本与 AI 生成的摘要Teams团队与会议类型配置典型的实战闭环是Agent 通过 Meetings 工具定位目标会议 → 拉取 Transcripts/Summaries 提取关键决策与行动项 → 基于这些内容在编辑器中起草跟进邮件或会议纪要。整个流程的数据源完全来自 Fathom 官方 MCP 服务器插件不落地任何本地数据。六、连接前的准备与权限说明README 对使用前提给出了明确的边界说明属于连接前的必备知识API 访问对所有套餐开放包括免费档基础能力会议、录制、转写、摘要不额外收费但CRM 关联的联系人与商机数据需要 Business 套餐。团队/组织场景需要管理员放行在团队或组织上下文中可能需要所有者先启用连接器成员才能使用。身份绑定工具调用以完成授权的 Fathom 用户身份执行见前文。这些前提决定了该插件的适用场景个人用户安装后即可体验全部基础能力若团队需要打通 CRM 数据做商机级分析则需升级套餐并由管理员配置。七、易混淆点澄清fathom.video、fathom.ai 与 usefathomREADME 专门用一节澄清品牌与域名易混淆问题这对排查连接异常、避免误用第三方包至关重要Fathom 会议记录产品品牌为fathom.video但其 API 与 MCP 服务统一托管在fathom.ai域名下——所以 MCP 地址是https://api.fathom.ai/mcp这并非拼写错误。GitHub 组织Fathom-AI与网页分析产品usefathom是两家不同的公司注意区分。npm 上存在社区维护的fathom-mcp包它们读取FATHOM_API_KEY环境变量属于非官方实现本插件走的是 Fathom 自己的托管服务器不依赖任何社区包。这节内容对实际使用有直接价值如果用户按fathom.video去猜 API 域名、或误装了社区 npm 包都会造成连接失败或数据不一致。八、仓库级佐证MCP 配置在插件生态中的规范位置Fathom 插件的接入方式并非孤例而是契合了本仓库对插件 元数据 MCP 配置的整体设计插件清单规范 schemas/plugin.schema.json 将mcpServers列为插件的一等属性可指向路径、内联对象或数组仓库根目录的校验脚本 scripts/validate-plugins.mjs 使用 Ajv 加载plugin.schema.json与marketplace.schema.json两个 Schema并逐插件校验清单文件的合法性scripts/validate-plugins.mjs同时校验 marketplace 中的插件名与清单name一致。从源码结构可以推断本仓库对第三方插件的质量管控重点放在配置合法性与命名一致性上而 Fathom 这种以mcp.json为核心交付物的远程 MCP 插件恰好把配置复杂度压到最低使其成为零密钥、零代码接入路径的代表样本。九、开源许可该插件以 MIT 协议发布见 LICENSE声明版权归属 Cursor2026允许自由使用、修改与分发包含商用场景前提是保留原始版权声明。小结Fathom 插件 1.0.0 用一份最简配置回答了如何让 Agent 安全访问第三方 SaaS 数据远程托管 MCP 服务器负责接口定义与数据读取OAuth 负责免密钥授权插件本体只保留 mcp.json 与说明文档。它的实战路径清晰——列出/搜索会议、取录制、拉转写与摘要、起草跟进与决策提取它的边界同样清晰——能力取决于 Fathom 套餐、账号权限与管理员开关。对于希望在 Cursor 中直接消费会议智能数据的开发者这是一条零成本即可验证的接入路线。【免费下载链接】pluginsCursor plugin specification and official plugins项目地址: https://gitcode.com/GitHub_Trending/plugins125/plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考