Composio Fathom 会议转录 Toolkit 支持与 OAuth 授权 URL 排查指南【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio本篇指南围绕 Composio 官方知识库文档docs/kb/articles/toolkits-fathom.md展开系统梳理 Composio 对fathom与granola_mcp两个会议转录工具包的支持范围、Fathom 的两种接入认证方式OAuth2 / API Key以及排查授权 URL 报错时的核心原则授权 URL 是 provider 特定的必须依据实际解析到的连接流程来判断对错。读完本文你将掌握如何确认某个会议转录工具是否受支持、如何为不支持的转录工具提交接入请求、Fathom 工具包的完整工具清单与认证配置字段、以及如何避免在 OAuth 重定向排查中把provider 特有域名误判为配置错误。支持的会议转录工具包fathom 与 granola_mcpComposio 目前明确支持的会议转录meeting transcription工具包有两个工具包 slug定位认证方式工具数量fathomAI 会议助手可录制、转录并总结会议OAuth2Composio 托管、API Key7granola_mcp基于 Granola 官方 MCP server 的会议笔记工具DCR_OAUTH6以上信息可在仓库的 docs/public/data/toolkits.json 中逐条核对也可通过npx composio add fathom/npx composio add granola_mcp将对应工具包安装到你的 Agent 工作区工具包 slug 同时出现在 ts/packages/cli/src/generated/toolkit-slugs.ts 中。遇到不支持的转录工具怎么办知识库原文明确指出如果客户请求的会议转录器不在支持列表中例如 Otter应引导其前往https://request.composio.dev/提交接入请求。这是一个独立于主仓库的官方需求收集入口用于把新工具包的接入优先级交由用户投票/提交来决定而不是在本地自行绕过认证体系去对接第三方 API。需要区分的是Composio 平台支持的工具包远不止转录类本文所述支持范围仅针对会议转录/会议笔记这一类别。判断一个具体工具是否可用最可靠的依据是 docs/public/data/toolkits-list.json 与 docs/public/data/toolkits.json 中的条目而不是印象中的热门工具一定支持。granola_mcp元数据来自上游 MCP server与 Fathom 这种由 Composio 直接维护的工具不同granola_mcp走的是 MCP 镜像路线。仓库另一份知识库文档 docs/content/kb/guide/toolkits-granola-mcp.mdx 对此有明确说明Granola MCP 工具包使用的是Granola 官方 MCP server工具名、描述、输入定义与响应元数据全部受限于上游 server 暴露的内容如果 Granola 上游只提供了工具名和描述Composio 能暴露的元数据就只有这些如果上游没有声明响应/输出 schemaComposio 也无法凭空补造因此空的输出 schema 本身并不能证明 Composio 目录数据过期当发现元数据不一致时应记录确切的工具名与缺失字段与当前 Granola 官方 MCP server 的行为对比后再下结论若确认官方已暴露而 Composio 缺失再带着对比细节联系 Composio 支持。这一点与 TS SDK 源码中 ts/packages/core/src/models/Tools.ts 的注释相互印证MCP 背书的工具包granola_mcp、apify_mcp、tavily_mcp等没有本地维护的完整工具目录工具集合以运行时抓取的上游 MCP 定义为准。Fathom 工具包全量工具清单根据 docs/public/data/toolkits.json 中fathom条目的tools字段该工具包版本20260724_00共暴露 7 个工具覆盖会议列表 → 转录 → 总结 → Webhook 通知的完整链路工具 slug名称关键行为FATHOM_CREATE_WEBHOOKCreate webhook for meeting content创建 Webhook 接收新会议内容payload 中至少包含 transcript、CRM matches、summary、action items 中的一项FATHOM_DELETE_WEBHOOKDelete Webhook按 Webhook ID 删除不再需要的 WebhookFATHOM_GET_RECORDING_SUMMARYGet Recording Summary获取指定录音的 AI 摘要支持同步返回也支持异步投递到destination_url参数指定的 WebhookFATHOM_GET_RECORDING_TRANSCRIPTGet Recording Transcript获取完整会议转录含说话人与时间戳支持同步/异步两种模式响应中speaker是对象应读取speaker.display_name而非当作字符串FATHOM_LIST_MEETINGSList Meetings分页列出当前用户/组织的会议录音可按日期、域名、会议类型、录制人过滤并通过include_*参数做数据富化FATHOM_LIST_TEAM_MEMBERSList Team Members分页列出组织内团队成员可按团队名过滤或使用 cursor 分页FATHOM_LIST_TEAMSList Teams分页列出组织内所有团队值得注意的工程细节官方对FATHOM_GET_RECORDING_TRANSCRIPT的指引是优先用它直接拉取转录而不是通过list-meetings加include_transcripttrue来批量取因为后者在会议数量较多时会产生极大的响应体——这直接关系到你在 Agent 工作流中如何设计取转录这一步以避免 token 与内存浪费。Fathom 的两种认证接入方式fathom工具包在 docs/public/data/toolkits.json 中声明了两种认证方案OAUTH2与API_KEY其中 Composio 托管composio-managed的认证方案是OAUTH2。方式一OAuth2推荐Composio 托管OAuth2 模式对应的 auth config 名为fathom_oauth其创建字段如下字段必填默认值说明client_id是—你在 Fathom 开发者平台创建的应用 Client IDclient_secret是—对应的 Client Secretoauth_redirect_uri否https://backend.composio.dev/api/v1/auth-apps/add需加入 Fathom 应用 OAuth 白名单的回调地址scopes否public_api向用户请求的权限范围逗号分隔在默认托管模式下你无需关心client_id/client_secret直接发起连接即可只有当你需要自定义 OAuth 应用如白标、独立配额、自定义 scope时才需要在 dashboard 创建自定义 auth config 并填写上述字段。仓库文档 docs/content/docs/auth-configuration/custom-auth-configs.mdx 给出了何时该自定义 OAuth 的决策表工具包无托管认证、需要白标展示自有应用名、共享配额触顶、需要额外 scope、或需要连接自建实例/子域。白标场景的具体做法见 docs/content/docs/auth-configuration/white-labeling.mdx。方式二API KeyAPI Key 模式对应的 auth config 名为fathom_api_key。此模式下创建 auth config 本身不需要任何字段真正的凭据在发起连接connected account initiation阶段提供字段必填说明generic_api_key是允许 Composio 读取你的 Fathom 会议与转录的密钥在 Fathom 后台Settings → API Accessfathom.video/customize中创建两种模式二选一即可。API Key 模式适合不想走完整 OAuth 流程、仅需读取会议内容的场景OAuth2 托管模式则更适合需要 Webhook 订阅、多用户授权等完整能力的生产级使用。OAuth 授权 URL 是 provider 特定的排查核心原则这是本知识库文章最重要的排障结论授权 URLauthorization URL取决于连接流程中所涉及的具体 provider/toolkit。不同供应商的 OAuth 授权端点域名各不相同例如 Fathom、Granola 各自的授权域名是不同的。因此先确认 auth config 与连接流程实际解析到了哪个 provider检查你创建的 auth config 所用的认证模式fathom_oauth/fathom_api_key/ 自定义 OAuth 应用以及该 toolkit 声明支持的 auth scheme再对照该 provider 的授权域名如果跳转到的授权域名与该 provider 的官方域名一致即使它看起来与你预期中的通用域名不同也不应直接判定为错误不要以域名眼生为由臆断配置错误把 provider 特有授权域名当作异常是 OAuth 重定向排查中最常见的误判来源。正确做法是核对 auth config 中配置的client_id/client_secret/oauth_redirect_uri默认https://backend.composio.dev/api/v1/auth-apps/add是否与 Fathom 侧 OAuth 应用白名单一致再结合实际落地的授权 URL 判断问题出在配置还是 provider 侧。排查建议清单在 dashboard 的Authentication management中查看该连接的 auth config确认 mode 是OAUTH2还是API_KEY并核对 provider 名称若使用自定义 OAuth 应用确认oauth_redirect_uri已加入 Fathom 应用的回调白名单该字段默认值即 Composio 后端回调地址若使用托管managedOAuth确认连接流程中的授权域名属于对应 provider 官方域不要与 API Key 模式混用对granola_mcp这类 MCP 镜像工具包认证走DCR_OAUTH动态客户端注册排查时优先对照上游 Granola MCP server 行为参见 docs/content/kb/guide/toolkits-granola-mcp.mdx。延伸阅读本知识库原文与元数据docs/kb/articles/toolkits-fathom.md、docs/kb/source/toolkits/fathom/public.mdFathom 公开知识库指南页docs/content/kb/guide/toolkits-fathom.mdxGranola MCP 上游镜像说明docs/content/kb/guide/toolkits-granola-mcp.mdx工具包目录数据含认证字段与工具清单docs/public/data/toolkits.json、docs/public/data/toolkits-list.json自定义 OAuth 认证配置docs/content/docs/auth-configuration/custom-auth-configs.mdx连接connected account管理docs/content/docs/auth-configuration/connected-accounts.mdx【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考