关于 Follow Up Boss Mcp Server
Follow Up Boss CRM 的 MCP 服务,通过自然语言读取和管理联系人、交易、管道、任务等数据。项目由房地产经纪人开发,声称覆盖官方 API 的全部接口,共 157 个工具。
主要功能
- 01覆盖官方 API 的大部分接口
- 02联系人、交易与管道管理
- 03任务、预约与邮件模板
- 04智能列表与行动计划
- 05安全模式可禁用删除类工具
适用场景
- 01用自然语言查询和更新 FUB 联系人
- 02跟进管道中的交易并调整阶段
- 03批量安排任务与行动计划
MCP 相关
该项目是 MCP 服务,向 Claude 等 MCP 客户端暴露 FUB 的工具,使其可以读取、创建和修改 CRM 数据。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Follow Up Boss MCP 服务 — 为房地产经纪人打造
通过 Claude AI(或任何兼容 MCP 的工具)用通俗英语与 Follow Up Boss CRM 对话。提供 160 个工具,覆盖官方 API 的 100%,另有
about/help元工具。由一位在职房地产经纪人打造,而非开发公司。
由 Ed Neuhaus 打造——Neuhaus Realty Group 的经纪人兼所有者,位于德克萨斯州奥斯汀。 自 2009 年起持有房地产经纪人执照,拥有 19 年以上从业经验。我打造这个项目,是因为我想用通俗英语与自己的 FUB 账户对话。根据 Elastic License 2.0,可免费自托管使用。
我正在做的其他项目
- EdNeuhaus.com — 我的开发者档案,了解更多关于这个项目的构建方式:edneuhaus.com/projects/fub-mcp/
- NeuhausRE.com — 我们经纪公司的网站,支持 AI 的房屋搜索
- StaySTRA.com — 短期租赁投资分析工具
- Austin MLS MCP — 托管的 MLS MCP 服务(通过 Claude、ChatGPT、Perplexity 等获取实时 MLS 数据)
- Kendall Creek Properties — 姊妹经纪公司
想感谢我?
- 有房地产转介吗? 我接受来自任何州持牌经纪人的转介,服务对象是迁入或迁出 Texas 的客户。请通过 neuhausre.com/contact 联系我。
- 写篇文章介绍一下。 博客文章、LinkedIn、X 都可以——提及我并链接到 neuhausre.com。
- 发现 Bug 或做出有用的东西? 欢迎提交 issue 或 PR。
警告:此工具拥有对你的 Follow Up Boss 账户的完整读写权限。 它可以在你的 CRM 中创建、更新和删除联系人、交易、任务、备注及其他数据。强烈建议:在启用此工具前备份 FUB 数据,除非你非常清楚自己在做什么。 确认对线上数据的更改前,请务必检查 AI 建议的操作。作者不对 FUB 账户中的任何数据丢失或意外修改负责。
⚠️ 设置
FUB_SYSTEM/FUB_SYSTEM_KEY前请阅读——服务条款风险FUB 的多个 API 端点标记为 “Restricted - Registered Systems Only”,需要
X-System+X-System-Key请求头(此 MCP 将其作为FUB_SYSTEM+FUB_SYSTEM_KEY环境变量提供)。这些端点包括:webhook、收件箱应用、自动化(2.0)、短信记录、人员/交易附件。这些凭据由 FUB 发放给获批的第三方集成合作伙伴,而非 FUB 的终端用户。 设置这些环境变量是为已在 FUB 注册真正的第三方应用并获得专属
X-System名称和密钥的开发者准备的。请勿:
- 复用你在网上找到的其他应用或集成的
X-System凭据。- 随意编造系统名称,寄希望于 FUB 接受。
- 借用合作伙伴的凭据。
若通过上述任何方式访问受限端点,可能违反 Follow Up Boss 的服务条款,并导致你的 FUB 账户被暂停或封禁,且不会收到通知。 FUB 的速率限制与身份识别政策见 https://docs.followupboss.com/reference#identification。
如果你没有自己合法注册的系统凭据,请勿设置这些环境变量。每次调用受限工具时,MCP 都会给出清晰且可采取行动的错误提示(“requires X-System + X-System-Key …”),而不会悄悄绕过限制。超过 130 个不受限的工具均可使用常规 FUB API 密钥正常运行。
使用风险自负。对于因你使用受限端点而导致的任何服务条款违规、账户暂停、封禁或数据丢失,本项目作者概不负责。
许可证说明: 此项目从 v1.1.2 起由 MIT 许可证改为 Elastic License 2.0。你可以免费将其用于自己的业务、修改并自托管。你不得将其作为托管式/管理式服务提供给第三方。如需商业托管权利,请通过 neuhausre.com/contact 联系我们。≤ v1.1.1 的版本仍采用 MIT 许可证。
功能介绍
此服务可充当你的 Follow Up Boss 账户与 Claude 等 AI 工具之间的桥梁。连接后,你可以用通俗的英语与 Claude 对话,它会直接读取、创建、更新和管理你的 FUB 数据。
你可以执行的操作:
- 联系人与人员 -- 搜索联系人、创建新潜在客户、更新阶段、管理标签、检查重复项、查看关系
- 交易与销售管道 -- 创建和管理交易,推动交易在销售管道阶段间流转,跟踪金额和成交日期
- 任务与预约 -- 创建跟进任务、安排预约、设置提醒、跟踪结果
- 沟通 -- 查看通话记录和短信历史记录。注意:API 的“创建短信”端点仅用于记录(FUB 不会通过 API 发送短信);此端点也仅供注册系统使用——请参阅上方的警告。
- 电子邮件模板 -- 创建、编辑模板,并将联系人数据合并到电子邮件模板中
- 智能列表与行动计划 -- 查看智能列表,将人员分配到行动计划和自动化流程
- 自定义字段 -- 为联系人和交易创建和管理自定义字段
- 团队、群组与线索池 -- 管理团队结构、轮转分配群组和线索池
- Webhook -- 设置和管理 Webhook 集成
- 更多功能 -- 收件箱应用、回应、串接回复、电子邮件营销活动、时间范围
所需条件
- Follow Up Boss 账户,并拥有 API 访问权限(大多数付费套餐都包含此权限)
- Claude Desktop、Claude Code 或任何兼容 MCP 的 AI 工具
- Node.js 18 或更高版本——这是一个免费工具,可用于运行 JavaScript。如果你尚未安装,可从 nodejs.org 下载(请选择 LTS 版本)
设置(5 分钟)
第 1 步:获取 FUB API 密钥
你的 API 密钥就像密码,可让此服务与你的 FUB 账户通信。
- 登录 Follow Up Boss
- 前往 Admin(顶部菜单)> API
- 复制你的 API 密钥(它是一串由字母和数字组成的长字符串)
第 2 步:下载并安装
如果你会使用 git:
git clone https://github.com/mindwear-capitian/followupboss-mcp-server.git
cd followupboss-mcp-server
npm install
如果你不会使用 git:
- 点击本页面顶部的绿色 “Code” 按钮
- 选择 “Download ZIP”
- 解压下载的文件
- 打开终端(Mac)或命令提示符(Windows)
- 切换到解压后的文件夹:
cd path/to/followupboss-mcp-server - 安装依赖项:
npm install
第 3 步:运行设置程序
npm run setup
此程序会:
- 提示你输入 API 密钥
- 测试连接,确保一切正常
- 让你选择安全模式或完全访问模式
- 将设置保存在本地
.env文件中 - 准确显示如何将其连接到 Claude
安全模式与完全访问模式
| 安全模式(默认) | 完全访问 | |
|---|---|---|
| 读取数据(联系人、交易等) | 是 | 是 |
| 创建新记录 | 是 | 是 |
| 更新现有记录 | 是 | 是 |
| 删除记录 | 否 | 是 |
| 可用工具 | 136 | 160 |
安全模式为默认模式,也是大多数用户的推荐选择。该模式会禁用 24 个发出 HTTP DELETE 请求的工具,包括停用收件箱应用的工具。创建、更新和批量更新工具仍然可用,也仍可能造成重要影响。你可以随时通过更改 .env 文件或 AI 工具配置中的 FUB_SAFE_MODE 来切换模式。
快速验证(可选)
连接到 Claude 之前,你可以验证一切是否正常:
npm test
你应该会看到:
PASS Server starts and MCP handshake succeeds
PASS Lists 136 tools
PASS Read-only API call works (account: ok)
3 passed, 0 failed
如果 3 项检查全部通过,就可以继续了。如果有任何一项失败,请仔细检查 .env 文件中的 API 密钥。
第 4 步:连接到你的 AI 工具
选择你在下方使用的工具。每种工具都需要编辑一个小型配置文件——设置向导(npm run setup)会显示适用于你电脑的确切路径和 JSON 配置,以下是各工具的手动说明。
什么是配置文件? 这是一个设置文件,用来告诉你的 AI 工具在哪里找到此服务。你只需将一小段文本复制并粘贴到文件中即可。
Claude Desktop
- 打开 Finder(Mac)或文件资源管理器(Windows)
- 前往此文件:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Mac:
- 如果文件不存在,请创建它
- 粘贴以下内容(将两个占位值替换为你自己的值):
{
"mcpServers": {
"followupboss": {
"command": "node",
"args": ["/full/path/to/followupboss-mcp-server/index.js"],
"env": {
"FUB_API_KEY": "your_api_key_here"
}
}
}
}
- 将
/full/path/to/替换为你下载此项目的位置 - 将
your_api_key_here替换为你的 FUB API 密钥 - 重启 Claude Desktop(完全退出后重新打开)
Claude Code(CLI)
在终端中运行以下命令(替换路径):
claude mcp add followupboss -- node /full/path/to/followupboss-mcp-server/index.js
然后重启 Claude Code。
Cursor
- 打开 Cursor
- 前往 Settings > Developer > 点击 "Edit Config"(这会打开
~/.cursor/mcp.json) - 粘贴以下内容:
{
"mcpServers": {
"followupboss": {
"command": "node",
"args": ["/full/path/to/followupboss-mcp-server/index.js"],
"env": {
"FUB_API_KEY": "your_api_key_here"
}
}
}
}
- 将路径和 API 密钥替换为你自己的值
- 重启 Cursor
Windsurf
- 打开 Windsurf
- 前往 Settings > Cascade > MCP Servers
- 或手动编辑此文件:
- Mac:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- Mac:
- 粘贴以下内容:
{
"mcpServers": {
"followupboss": {
"command": "node",
"args": ["/full/path/to/followupboss-mcp-server/index.js"],
"env": {
"FUB_API_KEY": "your_api_key_here"
}
}
}
}
- 将路径和 API 密钥替换为你自己的值
- 完全退出并重启 Windsurf
VS Code 与 GitHub Copilot
需要 VS Code 1.99 或更高版本,以及 GitHub Copilot 扩展。
- 打开 VS Code
- 按
Cmd+Shift+P(Mac)或Ctrl+Shift+P(Windows) - 输入 "MCP: Open User Configuration" 并选择它
- 粘贴以下内容:
{
"servers": {
"followupboss": {
"type": "stdio",
"command": "node",
"args": ["/full/path/to/followupboss-mcp-server/index.js"],
"env": {
"FUB_API_KEY": "your_api_key_here"
}
}
}
}
- 将路径和 API 密钥替换为你自己的值
- 在 Copilot 的 Agent mode 中使用这些工具
注意: VS Code 使用
"servers",并且需要"type": "stdio"——与其他工具略有不同。
Cline(VS Code 扩展)
- 打开已安装 Cline 的 VS Code
- 点击 Cline 侧边栏中的 MCP Servers 图标
- 点击 "Configure MCP Servers"
- 粘贴以下内容:
{
"mcpServers": {
"followupboss": {
"command": "node",
"args": ["/full/path/to/followupboss-mcp-server/index.js"],
"env": {
"FUB_API_KEY": "your_api_key_here"
}
}
}
}
- 将路径和 API 密钥替换为你自己的值
Gemini CLI(Google)
此配置适用于 Google 的 Gemini CLI 工具,而非 Gemini 网站。
- 编辑(或创建)此文件:
- Mac:
~/.gemini/settings.json - Windows:
%USERPROFILE%\.gemini\settings.json
- Mac:
- 粘贴以下内容:
{
"mcpServers": {
"followupboss": {
"command": "node",
"args": ["/full/path/to/followupboss-mcp-server/index.js"],
"env": {
"FUB_API_KEY": "your_api_key_here"
}
}
}
}
- 将路径和 API 密钥替换为你自己的值
Continue.dev(VS Code 扩展)
- 在你的项目中,如果
.continue/mcpServers/文件夹不存在,请创建它 - 在该文件夹中创建名为
followupboss.json的文件 - 粘贴以下内容:
{
"mcpServers": {
"followupboss": {
"command": "node",
"args": ["/full/path/to/followupboss-mcp-server/index.js"],
"env": {
"FUB_API_KEY": "your_api_key_here"
}
}
}
}
- 将路径和 API 密钥替换为你自己的值
- 在 Continue 的 Agent mode 中使用这些工具
ChatGPT、OpenAI API 和 Grok
这些工具仅支持远程 MCP 服务(托管在互联网上),不支持本地服务。这意味着设置过程会更复杂——你需要将此服务托管在支持 HTTPS 的云服务上。
如果有足够多的人感兴趣,我们未来可能会添加托管版本。目前,我们建议使用上面列出的支持本地 MCP 服务的工具之一。
使用示例
连接后,只需像平常一样与 AI 工具对话。你可以这样提问:
"显示我本周的所有潜在客户"
"创建一项任务,明天下午 2 点跟进 John Smith"
"我的销售管道中有哪些金额超过 50 万美元的交易?"
"在 Jane Doe 的个人资料中添加备注:电话聊得很愉快,她对 Oak Park 房源感兴趣"
"列出我本周即将举行的所有预约"
"有哪些潜在客户还未联系?"
"将 Smith 交易移至 'Under Contract' 阶段"
"显示所有标记为 'hot lead' 的联系人"
"创建一个名为 'Open House Follow Up' 的新邮件模板"
"我设置了哪些行动计划?"
所有 160 个可用工具
点击展开完整工具列表
活动(3 个工具)
| 工具 | 描述 |
|---|---|
listEvents | 列出活动,可按人员、类型和房产筛选 |
createEvent | 创建新活动(潜在客户活动、房产咨询等) |
getEvent | 按 ID 获取单个活动 |
人员 / 联系人(8 个工具)
| 工具 | 描述 |
|---|---|
listPeople | 全面搜索和筛选联系人 |
createPerson | 创建新联系人 |
getPerson | 按 ID 获取联系人 |
updatePerson | 更新联系人详细信息、阶段、标签等 |
deletePerson | 删除(移至回收站)联系人 |
checkDuplicate | 检查联系人是否已存在(通过电子邮件或电话) |
listUnclaimed | 列出池中的未认领潜在客户 |
claimPerson | 认领未认领的潜在客户 |
人员附件(4 个工具)
| 工具 | 描述 |
|---|---|
createPersonAttachment | 为联系人附加文件 |
getPersonAttachment | 按 ID 获取附件 |
updatePersonAttachment | 更新附件 |
deletePersonAttachment | 删除附件 |
关系(5 个工具)
| 工具 | 描述 |
|---|---|
listRelationships | 列出联系人的关系 |
createRelationship | 在两个联系人之间创建关系 |
getRelationship | 按 ID 获取关系 |
updateRelationship | 更新关系 |
deleteRelationship | 删除关系 |
身份(2 个工具)
| 工具 | 描述 |
|---|---|
getIdentity | 获取 API 密钥对应的账户信息 |
getCurrentUser | 获取当前已通过身份验证的用户 |
备注(5 个工具)
| 工具 | 描述 |
|---|---|
listNotes | 列出备注,可按 personId 筛选 |
createNote | 为联系人创建备注 |
getNote | 按 ID 获取备注 |
updateNote | 更新备注 |
deleteNote | 删除备注 |
通话(4 个工具)
| 工具 | 描述 |
|---|---|
listCalls | 列出通话记录 |
createCall | 记录通话 |
getCall | 按 ID 获取通话 |
updateCall | 更新通话记录 |
短信(3 个工具)
| 工具 | 描述 |
|---|---|
listTextMessages | 列出短信 |
createTextMessage | 发送短信 |
getTextMessage | 按 ID 获取短信 |
用户(3 个工具)
| 工具 | 描述 |
|---|---|
listUsers | 列出所有用户 / Agent |
getUser | 按 ID 获取用户 |
deleteUser | 删除用户 |
智能列表(2 个工具)
| 工具 | 描述 |
|---|---|
listSmartLists | 列出所有智能列表 |
getSmartList | 按 ID 获取智能列表 |
行动计划(4 个工具)
| 工具 | 描述 |
|---|---|
listActionPlans | 列出所有行动计划 |
listActionPlansPeople | 列出行动计划中的人员 |
addPersonToActionPlan | 将联系人添加到行动计划 |
updateActionPlanPerson | 更新联系人的行动计划状态 |
自动化(6 个工具)
| 工具 | 描述 |
|---|---|
listAutomations | 列出所有自动化 |
getAutomation | 按 ID 获取自动化 |
listAutomationsPeople | 列出自动化中的人员 |
getAutomationPerson | 获取自动化-人员条目 |
addPersonToAutomation | 将联系人添加到自动化 |
updateAutomationPerson | 更新联系人的自动化状态 |
电子邮件模板(6 个工具)
| 工具 | 描述 |
|---|---|
listTemplates | 列出电子邮件模板 |
createTemplate | 创建电子邮件模板 |
getTemplate | 按 ID 获取模板 |
updateTemplate | 更新模板 |
mergeTemplate | 将模板与联系人数据合并(邮件合并) |
deleteTemplate | 删除模板 |
短信模板(6 个工具)
| 工具 | 描述 |
|---|---|
listTextMessageTemplates | 列出短信模板 |
createTextMessageTemplate | 创建短信模板 |
getTextMessageTemplate | 按 ID 获取模板 |
updateTextMessageTemplate | 更新模板 |
mergeTextMessageTemplate | 将模板与联系人数据合并 |
deleteTextMessageTemplate | 删除模板 |
邮件营销(5 个工具)
| 工具 | 描述 |
|---|---|
listEmEvents | 列出邮件营销事件 |
createEmEvent | 创建邮件营销事件 |
listEmCampaigns | 列出邮件营销活动 |
createEmCampaign | 创建营销活动 |
updateEmCampaign | 更新营销活动 |
自定义字段(5 个工具)
| 工具 | 描述 |
|---|---|
listCustomFields | 列出所有自定义字段 |
createCustomField | 创建自定义字段 |
getCustomField | 根据 ID 获取自定义字段 |
updateCustomField | 更新自定义字段 |
deleteCustomField | 删除自定义字段 |
阶段(5 个工具)
| 工具 | 描述 |
|---|---|
listStages | 列出所有销售管道阶段 |
createStage | 创建阶段 |
getStage | 根据 ID 获取阶段 |
updateStage | 更新阶段 |
deleteStage | 删除阶段 |
任务(5 个工具)
| 工具 | 描述 |
|---|---|
listTasks | 列出任务 |
createTask | 创建任务 |
getTask | 根据 ID 获取任务 |
updateTask | 更新任务 |
deleteTask | 删除任务 |
预约(5 个工具)
| 工具 | 描述 |
|---|---|
listAppointments | 列出预约 |
createAppointment | 创建预约 |
getAppointment | 根据 ID 获取预约 |
updateAppointment | 更新预约 |
deleteAppointment | 删除预约 |
预约类型(5 个工具)
| 工具 | 描述 |
|---|---|
listAppointmentTypes | 列出预约类型 |
createAppointmentType | 创建类型 |
getAppointmentType | 根据 ID 获取类型 |
updateAppointmentType | 更新类型 |
deleteAppointmentType | 删除类型 |
预约结果(5 个工具)
| 工具 | 描述 |
|---|---|
listAppointmentOutcomes | 列出结果 |
createAppointmentOutcome | 创建结果 |
getAppointmentOutcome | 根据 ID 获取结果 |
updateAppointmentOutcome | 更新结果 |
deleteAppointmentOutcome | 删除结果 |
Webhook(6 个工具)
| 工具 | 描述 |
|---|---|
listWebhooks | 列出所有 Webhook |
createWebhook | 创建 Webhook |
getWebhook | 根据 ID 获取 Webhook |
updateWebhook | 更新 Webhook |
deleteWebhook | 删除 Webhook |
getWebhookEvents | 获取 Webhook 的事件 |
销售管道(5 个工具)
| 工具 | 描述 |
|---|---|
listPipelines | 列出所有销售管道 |
createPipeline | 创建销售管道 |
getPipeline | 根据 ID 获取销售管道 |
updatePipeline | 更新销售管道 |
deletePipeline | 删除销售管道 |
交易(5 个工具)
| 工具 | 描述 |
|---|---|
listDeals | 列出交易并进行筛选 |
createDeal | 创建交易 |
getDeal | 根据 ID 获取交易 |
updateDeal | 更新交易 |
deleteDeal | 删除交易 |
交易附件(4 个工具)
| 工具 | 描述 |
|---|---|
createDealAttachment | 将文件附加到交易 |
getDealAttachment | 根据 ID 获取附件 |
updateDealAttachment | 更新附件 |
deleteDealAttachment | 删除附件 |
交易自定义字段(5 个工具)
| 工具 | 描述 |
|---|---|
listDealCustomFields | 列出交易自定义字段 |
createDealCustomField | 创建交易自定义字段 |
getDealCustomField | 根据 ID 获取字段 |
updateDealCustomField | 更新字段 |
deleteDealCustomField | 删除字段 |
群组(6 个工具)
| 工具 | 描述 |
|---|---|
listGroups | 列出所有群组 |
listRoundRobinGroups | 列出轮询群组 |
createGroup | 创建群组 |
getGroup | 根据 ID 获取群组 |
updateGroup | 更新群组 |
deleteGroup | 删除群组 |
团队(5 个工具)
| 工具 | 描述 |
|---|---|
listTeams | 列出所有团队 |
createTeam | 创建团队 |
getTeam | 根据 ID 获取团队 |
updateTeam | 更新团队 |
deleteTeam | 删除团队 |
团队收件箱(1 个工具)
| 工具 | 描述 |
|---|---|
listTeamInboxes | 列出所有团队收件箱 |
池塘(5 个工具)
| 工具 | 描述 |
|---|---|
listPonds | 列出所有池塘 |
createPond | 创建池塘 |
getPond | 根据 ID 获取池塘 |
updatePond | 更新池塘 |
deletePond | 删除池塘 |
时间范围(1 个工具)
| 工具 | 描述 |
|---|---|
listTimeframes | 列出所有时间范围 |
收件箱应用(10 个工具)
| 工具 | 描述 |
|---|---|
inboxAppAddMessage | 向对话添加消息 |
inboxAppUpdateMessage | 更新消息 |
inboxAppAddNote | 向对话添加备注 |
inboxAppUpdateConversation | 更新对话状态 |
inboxAppGetParticipants | 获取对话参与者 |
inboxAppCreateParticipant | 添加参与者 |
inboxAppDeleteParticipant | 移除参与者 |
inboxAppInstall | 安装收件箱应用 |
inboxAppDeactivate | 停用收件箱应用 |
listInboxAppInstallations | 列出安装项 |
表情回应(3 个工具)
| 工具 | 描述 |
|---|---|
getReactions | 获取某项的表情回应 |
createReaction | 添加表情回应 |
deleteReaction | 移除表情回应 |
线程回复(1 个工具)
| 工具 | 描述 |
|---|---|
getThreadedReplies | 获取某项的线程回复 |
便捷工具
| 工具 | 描述 |
|---|---|
removeTagFromPerson | 移除单个标签且不影响其他标签(内部处理读取-修改-写入) |
getPersonByEmail | 按电子邮件查找人员;多个联系人匹配时会报告候选 ID,避免静默选择 |
searchPeopleByTag | 查找具有指定标签的所有人员(逗号分隔,采用 OR 逻辑) |
bulkUpdatePeople | 一次更新多个人员,并自动限制速率 |
listAvailableTags | 扫描联系人,发现账户中的所有标签 |
元工具(2 个工具,v1.1.2 新增)
| 工具 | 描述 |
|---|---|
about | 作者简介、相关项目、贡献者、“如何感谢我” |
help | 使用技巧、常见工具示例、错误报告链接 |
速率限制
当达到 FUB 的速率限制(HTTP 429)时,服务会自动重试请求。它会读取 Retry-After 标头并逐渐延长等待时间,每个请求最多重试 3 次。FUB 的限制如下:
- 全局: 每 10 秒 250 个请求
- 人员更新: 每 10 秒 25 个请求
- 备注: 每 10 秒 10 个请求
bulkUpdatePeople 工具还会每执行 20 次操作自动暂停一次,以避免超过 PUT 限制。
故障排查
“无法连接”或“连接被拒绝”
- 确保已安装 Node.js:在终端中运行
node --version(应显示 v18 或更高版本) - 确保已在项目文件夹中运行
npm install - 仔细检查 Claude 配置中的文件路径
“API 密钥无效”或“401 未授权”
- 在 FUB 中重新检查 API 密钥:Admin > API
- 确保复制/粘贴时没有多余的空格
- 再次运行
npm run setup以测试密钥
Claude 中提示“找不到工具”
- 添加服务配置后,重启 Claude Desktop
- 检查配置文件中的 JSON 是否有效(没有缺少逗号或方括号)
Claude 似乎不了解 FUB
- 确保配置中的服务名称完全匹配
- 在 Claude Desktop 的开发者控制台中检查错误消息
- 尝试询问 Claude:“你有哪些 MCP 工具可用?”
常见问题
我的数据安全吗?
是的。此服务完全在你的计算机上运行。你的 API 密钥保存在本机的本地文件中,绝不会发送到任何地方,唯一例外是直接发送到 Follow Up Boss 的官方 API。不会有任何数据经过第三方服务。
这需要付费吗?
此服务免费且开源。你只需要拥有一个可访问 API 的 Follow Up Boss 账户(大多数付费套餐都包含此权限)。
Claude 能修改我的 FUB 数据吗?
可以,Claude 能在你的 FUB 账户中创建、更新和删除记录。Claude 通常会在进行更改前确认,尤其是删除操作。如果你希望仅有只读访问权限,可以在 FUB 中创建受限 API 密钥。
通话录音 URL 在哪里?
没有,而且也不是此服务把它们藏起来了。Follow Up Boss 会在 API 层面为所有集成屏蔽 recordingUrl——无论使用什么请求头或权限,原始 API 返回的内容都是 * Recording URL is hidden for privacy reasons *;FUB 也已直接确认,API 永远不会公开录音 URL。写入 recordingUrl 同样不起作用(FUB 会在读取时再次将其屏蔽),因此通话工具现在不再接受此字段。如果你需要通话音频,请在拨号器端录制;你可以使用 updateCall(备注字段)将转录文本保存到通话记录中。详情请参阅 issue #2。
什么是 MCP?
MCP(Model Context Protocol)是由 Anthropic 创建的一项开放标准,可让 Claude 等 AI 工具连接外部服务。你可以把它想象成一个通用插头,让 Claude 能与各种应用通信。详细了解 MCP。
这个项目是谁创建的?
由 Ed Neuhaus 创建。他是 Neuhaus Realty Group 的经纪人,也是 StaySTRA 的创始人;两家公司都位于德克萨斯州奥斯汀。我们每天都在使用 Follow Up Boss,创建此项目是为了加快自己的工作流。
参与贡献
欢迎贡献!参与方式如下:
- Fork 此仓库
- 创建功能分支:
git checkout -b my-feature - 进行更改
- 测试更改:
node -c index.js(语法检查) - 提交更改:
git commit -m "Add my feature" - 推送更改:
git push origin my-feature - 创建 Pull Request
请保持代码风格一致,并确保全部 160 个工具继续正常运行。
许可证
Elastic License 2.0——可免费自托管,不得转售 SaaS。≤ v1.1.1 的版本仍采用 MIT 许可证;这些版本的现有分支不受影响。完整条款和署名信息请参阅 LICENSE 和 NOTICE。
由 Ed Neuhaus 创建
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。