Bill4Time MCP by usefulapi

Name: Bill4Time MCP by usefulapi
Author: usefulapi.io

远程服务

usefulapi.io金融数据0今天更新

代码仓库访问官网

关于 Bill4Time MCP by usefulapi

Bill4Time MCP by usefulapi 是一个托管的 MCP 服务，让 MCP 客户端读取 Bill4Time 记录。它覆盖计费与工时数据，支持类型化筛选和排序，并排除机密字段。

主要功能

01读取客户和项目
02读取工时条目和费用
03读取发票和付款
04读取用户和联系人
05筛选和排序结果
06排除机密字段

适用场景

01查看客户和项目记录
02检查记录的工时与费用
03核对发票和付款记录
04在排除敏感字段的情况下获取记录

MCP 相关

它向 MCP 客户端提供只读的 Bill4Time 记录，并支持类型化筛选和排序。使用时需要 Bill4Time v1 API key。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://bill4time.usefulapi.io/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http io-usefulapi-bill4time https://bill4time.usefulapi.io/mcp

Cursor.cursor/mcp.json{"mcpServers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"io-usefulapi-bill4time":{"serverUrl":"https://bill4time.usefulapi.io/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
id	integer	否	仅返回此 ID 对应的记录。
top	integer	否	要返回的记录数，范围为 1-100（默认值：25）。
skip	integer	否	要跳过的记录数（默认值：0）。传入上一条回复中的 next_skip 以读取下一页。
sort	enum	否	用于排序的字段（默认：Bill4Time 自身的顺序）。id \| clientName \| creationDate
status	enum	否	Active \| Disabled
descending	boolean	否	按降序排序（最新或最高优先）。默认升序。
client_name	string	否	精确的客户端名称（大小写规则遵循 Bill4Time 的规则）。
created_after	string	否	在此日期或之后创建的客户端。
created_before	string	否	在此日期或之前创建的客户端。
include_custom_fields	boolean	否	同时返回自定义字段（默认值为 false）。

详细介绍

usefulapi 提供的 Bill4Time MCP

通过 Claude、Cursor 或任何 MCP 客户端使用 Bill4Time——读取客户、项目、时间条目、费用、发票、付款、用户和联系人，并使用类型化筛选条件和排序。仅支持读取；地址、税号和薪酬等机密字段绝不会返回。需要 Bill4Time v1 API 密钥。托管服务，无需本地安装：使用你自己的 Bill4Time 凭据连接。

在线端点： https://bill4time.usefulapi.io/mcp · 主页： https://usefulapi.io/bill4time

连接

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

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

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

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

工具

工具	类型	功能
`bill4time_list_clients`	read	列出客户
`bill4time_list_projects`	read	列出项目（事项）
`bill4time_list_time_entries`	read	列出时间条目
`bill4time_list_expenses`	read	列出费用
`bill4time_list_invoices`	read	列出发票
`bill4time_list_payments`	read	列出付款
`bill4time_list_users`	read	列出用户（计时人员）
`bill4time_list_contacts`	read	列出联系人
`bill4time_usage_status`	meta	使用情况状态（免费套餐计量）
`bill4time_request_feature`	meta	请求添加缺失功能
`bill4time_upgrade`	meta	升级到 Pro（不限量*）
`bill4time_cancel_subscription`	meta	取消 Pro 订阅

read 工具仅支持读取；write 工具会修改数据（客户端应先征得确认）；meta 工具用于报告使用情况、管理订阅或发送功能请求。

定价

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

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

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