使用说明
Fathom MCP服务器
将克劳德连接到您的 父亲AI 会议记录。问克劳德一些事情,比如“我们上周决定了什么定价?”或者“给我看看我所有的行动项目”,它就会搜索你真正的Fathom数据——使用可选的人工智能语义搜索。
它能做什么?
- 按主题搜索会议 --“我们讨论了第四季度预算的什么?”即使没有使用这些确切的单词(通过语义搜索),也能找到相关的会议
- 每周摘要 --所有会议的压缩概述,而不是原始数据转储
- 动作项提取 --跨会议拉取所有待办事项,按分配给谁进行筛选
- 深入了解任何会议 --完整摘要、行动项目和按需记录
- 浏览和筛选 --按日期、团队、录制者或受邀者域
- 团队和成员 --看看谁在你的Fathom工作区
- 网络钩子 --在处理新会议时收到通知
两种搜索模式
| 模式 | 需要 | 工作原理 |
|---|---|---|
| 关键字搜索 | 只需您的Fathom API键 | 搜索会议标题、摘要和行动项目以查找完全匹配的关键字 |
| 语义搜索 | Fathom+OpenAI API密钥 | 使用AI嵌入来查找概念相关的内容-“预算问题”找到关于“成本结构”或“费率卡”的会议 |
语义搜索是可选的。没有它,一切都能正常工作——它只是让搜索更智能。
选择您的设置
| 选项 | 最适合 | 您需要什么 |
|---|---|---|
| A.使用托管服务器 | 非技术用户,快速入门 | 只需您的API密钥 |
| B.在本地运行 | 开发人员,完全控制 | 已安装Node.js+Git |
选项A:使用托管服务器(最简单)
如果有人与您共享了托管URL(如 https://fathom-mcp.up.railway.app/mcp),你不需要安装任何东西。您所需要的只是您的Fathom API密钥。
步骤1:获取API密钥
-
Fathom API密钥(必需):
- 登录 英寻.视频
- 首选 设置 > 集成 > API
- 点击 生成API密钥 并复制它
-
OpenAI API密钥(可选-启用语义搜索):
- 首选 platform.openai.com/api-keys
- 创建新密钥并复制它
- 费用:几乎免费(每次搜索会议约0.0002美元)
第二步:添加到Claude
Claude Desktop (the app)
打开您的Claude Desktop配置文件:
在Mac上:
- 打开查找器
- 点击 去 在菜单栏中,然后 转到文件夹。..
- 粘贴此内容并按Enter键:
~/Library/Application Support/Claude/ - 寻找
claude_desktop_config.json--用TextEdit打开它,或用该名称创建一个新文件
在Windows上:
- 按
Windows key + R,类型%APPDATA%\Claude然后按Enter键 - 寻找
claude_desktop_config.json--用记事本打开它,或用该名称创建一个新文件
将此内容粘贴到文件中:
{
"mcpServers": {
"fathom": {
"type": "streamable-http",
"url": "PASTE_SERVER_URL_HERE/mcp",
"headers": {
"x-fathom-api-key": "PASTE_YOUR_FATHOM_KEY_HERE",
"x-openai-api-key": "PASTE_YOUR_OPENAI_KEY_HERE"
}
}
}
}
替换三个 PASTE_... 如果你没有OpenAI密钥,只需完全删除那一行——一切仍然正常。
保存文件。
Claude Code (the terminal/CLI tool)
打开 ~/.claude.json 在任何文本编辑器中添加:
{
"mcpServers": {
"fathom": {
"type": "streamable-http",
"url": "PASTE_SERVER_URL_HERE/mcp",
"headers": {
"x-fathom-api-key": "PASTE_YOUR_FATHOM_KEY_HERE",
"x-openai-api-key": "PASTE_YOUR_OPENAI_KEY_HERE"
}
}
}
}
移除 x-openai-api-key 行,如果你没有一个。保存文件。
第三步:重启克劳德
- 克劳德桌面: 完全退出应用程序(而不仅仅是关闭窗口)并重新打开它
- 克劳德代码: 关闭终端,打开一个新终端,重新启动Claude Code
够了,你完了。
选项B:在本地运行
这将在您自己的计算机上安装服务器。克劳德会在需要时自动启动它。
先决条件(如果您已经拥有Node.js和Git,请跳过)
How to check if you already have them
打开终端:
- 雨衣: 打开 终端 应用程序(在Spotlight中搜索“终端”)
- 窗户: 打开 命令提示符 (在“开始”菜单中搜索“cmd”)
键入以下各项,然后按Enter键:
node --version
git --version
如果两者都显示版本号(如 v20.11.0),跳到步骤1。
Install Node.js
- 首选 https://nodejs.org
- 点击大绿色 长期支持 下载按钮
- 打开下载的文件并按照安装程序进行操作
- 关闭并重新打开终端,然后键入
node --version确认
Install Git
- 雨衣: 类型
git --version在终端。如果未安装,您的Mac将提示您--单击 安装. - 窗户: 首选 https://git-scm.com,下载并安装默认值。
步骤1:获取API密钥
与上述步骤1的选项A相同——获取Fathom密钥(必需)和可选的OpenAI密钥。
第二步:下载并构建
运行这些 一次一个 在您的终端中:
git clone https://github.com/aaronb458/Fathom_MCP.git
cd Fathom_MCP
npm install
npm run build
然后获取此文件夹的完整路径:
- Mac/Linux:
pwd - 窗户:
cd
复制结果(例如。, /Users/yourname/Fathom_MCP).
第三步:告诉克劳德这台服务器
Claude Desktop (the app)
打开配置文件(有关如何查找它,请参阅选项A,步骤2)并粘贴:
{
"mcpServers": {
"fathom": {
"command": "node",
"args": ["PASTE_YOUR_PATH_HERE/dist/index.js"],
"env": {
"FATHOM_API_KEY": "PASTE_YOUR_FATHOM_KEY_HERE",
"OPENAI_API_KEY": "PASTE_YOUR_OPENAI_KEY_HERE"
}
}
}
}
更换 PASTE_... 价值观。移除 OPENAI_API_KEY 行,如果你没有一个。保存。
Claude Code (the terminal/CLI tool)
打开 ~/.claude.json 并添加:
{
"mcpServers": {
"fathom": {
"command": "node",
"args": ["PASTE_YOUR_PATH_HERE/dist/index.js"],
"env": {
"FATHOM_API_KEY": "PASTE_YOUR_FATHOM_KEY_HERE",
"OPENAI_API_KEY": "PASTE_YOUR_OPENAI_KEY_HERE"
}
}
}
}
移除 OPENAI_API_KEY 行,如果你没有一个。保存。
第四步:重启克劳德
- 克劳德桌面: 完全退出并重新打开
- 克劳德代码: 关闭终端,打开新终端,启动Claude Code
完成。
试试看
一旦设置好,只需自然地与克劳德交谈:
- “我本周的会议发生了什么?”
- “在上周的会议上,我们对定价做出了什么决定?”
- “显示过去7天的所有操作项”
- “获取我上次客户电话的完整记录”
- “分配给Sarah的行动项目是什么?”
- “总结昨天的脱口秀”
工具参考
| 工具 | 它做什么 |
|---|---|
fathom_search_meetings |
按主题/关键字在摘要(语义或关键字)中搜索 |
fathom_meeting_digest |
按日期范围压缩的会议概述 |
fathom_get_meeting_detail |
一次特定会议的完整摘要+记录 |
fathom_action_items |
跨会议的行动项目,可由受让人选择 |
fathom_list_meetings |
按日期、团队、记录者浏览/筛选会议 |
fathom_list_teams |
列出工作区团队 |
fathom_list_team_members |
列出团队成员 |
fathom_create_webhook |
创建会议事件webhook |
fathom_delete_webhook |
删除webhook |
托管自己的服务器
部署它,这样朋友/队友就可以在不安装任何东西的情况下使用它。
铁路(推荐)
- 在GitHub上分叉此仓库
- 首选 railway应用程序,创建新项目
- 选择 从GitHub仓库部署 然后选择你的叉子
- Railway自动检测Dockerfile并进行部署
与朋友分享网址——他们关注 选项A 每个人都有自己的API密钥。服务器从不存储密钥。
码头工人
npm run build
docker build -t fathom-mcp .
docker run -p 3000:3000 fathom-mcp
什么不起作用?
“FATHOM_API_KEY环境变量是必需的”
打开配置文件,检查API密钥是否在正确的位置。
“Fathom API错误:401未经授权”
API密钥错误或已过期。在Fathom设置中生成一个新的。
“缺少Fathom API密钥” (远程模式)
您的配置需要
x-fathom-api-key头球
工具未显示
- 当地人:你跑了吗
npm run build这条路是否以…结束/dist/index.js?- Remote:是以结尾的URL
/mcp?- 你重启克劳德了吗?
搜索结果不好
为语义搜索添加一个OpenAI API键。没有它,只有精确的关键字匹配才能工作。
对于开发者
# Local stdio mode
FATHOM_API_KEY=your-key npm run dev
# Local with semantic search
FATHOM_API_KEY=your-key OPENAI_API_KEY=your-key npm run dev
# Remote HTTP mode
npm run dev:remote
# Build for production
npm run build
许可证
麻省理工学院