Famly MCP by usefulapi

usefulapi 提供的 Famly MCP

托管于 https://famly.usefulapi.io/mcp。

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://famly.usefulapi.io/mcp。
• **Claude Code：**运行 claude mcp add --transport http famly https://famly.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code：添加到 VS Code。
• **Cursor 和其他客户端：**将该 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "famly": {
      "url": "https://famly.usefulapi.io/mcp"
    }
  }
}

只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Famly 凭据。

分步设置指南、凭据查找方式和常见问题解答：https://usefulapi.io/famly/

在 Famly 的 Manage API tokens 设置中创建一个有范围限制且会过期的 API 令牌，并选择对应的 General 或 DACH 区域。API 访问权限取决于你的 Famly 套餐。授予所需站点和资源的读取权限。使用量和计费按区域和 API 令牌计算。

工具

工具	类型	功能
famly_list_sites	read	列出站点
famly_list_groups	read	列出组
famly_list_employees	read	列出员工
famly_list_invoices	read	列出发票
famly_get_invoices	read	按 ID 获取发票
famly_list_payments	read	列出付款
famly_list_purchases	read	列出采购记录
famly_list_account_codes	read	列出账户代码
famly_list_bill_payers	read	列出付款人
famly_list_work_tags	read	列出工作标签
famly_get_staff_hours_totals	read	获取员工工时总计
famly_list_employee_checkins	read	列出员工签到记录
famly_usage_status	meta	使用状态（免费套餐用量计数）
famly_request_feature	meta	请求添加缺失功能
famly_upgrade	meta	升级到 Pro（不限量*）
famly_cancel_subscription	meta	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前确认）；meta 工具用于报告使用情况、管理订阅或提交功能请求。

定价

套餐	价格	限额
Free	$0	每月 50 次工具调用
Pro（按区域和 API 令牌计费）	$9/mo 或 $90/yr（免费 2 个月）	不限量*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 famly_upgrade 订阅（该工具会返回 Stripe Checkout 链接）。你可随时使用 famly_cancel_subscription 取消：Pro 将持续到付费周期结束，当前周期不予退款；在此之前运行 famly_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT。