Hubity MCP Server已验证已精选

什么是 Hubity MCP Server？

Hubity MCP Server 是 Hubity 的官方远程 MCP 服务器。Hubity 是为咨询、建筑、工程和代理公司提供项目、工时、计费和利用率管理的应用。你的 AI 助手可以根据已批准的工时、预付费（retainer）和进度计费，预览每张月末发票，然后起草发票供你审核。

服务器由 Hubity 托管在 https://hubity.io/api/mcp（Streamable HTTP），无需安装任何东西。你通过 Hubity 授权页面以 OAuth 2.1 + PKCE 登录，助手只能看到你在 Hubity 中的角色所允许的内容。它在 MCP Registry 中的名称是 io.hubity/hubity。

如何使用 Hubity MCP Server？

你需要一个 Hubity 账号。Hubity 表示 Starter 计划对最多 3 人免费。把这个 URL 添加为远程 MCP 服务器，然后在浏览器中登录 Hubity，并在授权页面选择 Allow access。

Claude Code

通过浏览器登录连接：

claude mcp add --transport http hubity https://hubity.io/api/mcp

然后在 Claude Code 中运行 /mcp 并批准 Hubity 登录。在脚本和 CI 中，可以改用只读访问码：

claude mcp add --transport http hubity https://hubity.io/api/mcp \
  --header "Authorization: Bearer YOUR_HUBITY_ACCESS_CODE"

加上 --scope user 可在所有项目中使用，并用 claude mcp list 检查连接。

Claude Desktop / claude.ai

打开 Customize → Connectors → Add → Add custom connector，粘贴 https://hubity.io/api/mcp。在 Team 和 Enterprise 计划中，需要所有者先在 Organization settings → Connectors 中添加。之后 Claude 会引导你登录 Hubity。

Cursor

把以下内容添加到 ~/.cursor/mcp.json，然后在 Cursor 提示时登录：

{
  "mcpServers": {
    "hubity": { "url": "https://hubity.io/api/mcp" }
  }
}

VS Code

把以下内容添加到 .vscode/mcp.json，然后在 VS Code 提示时登录：

{
  "servers": {
    "hubity": { "type": "http", "url": "https://hubity.io/api/mcp" }
  }
}

Windsurf

在 ~/.codeium/windsurf/mcp_config.json 的 mcpServers.hubity 下添加 "serverUrl": "https://hubity.io/api/mcp"。Hubity 还提供了 ChatGPT（Developer mode）、Microsoft Copilot Studio、Grok 和 Gemini 的接入说明。

Hubity MCP Server 的主要功能

• 月末计费：根据已批准的工时、费用、预付费以及按合同计算的进度计费（包括保留金）预览每张发票，并在起草之前列出需要你决定的事项。
• 不会向客户发送任何内容。草稿会标记为由你的助手起草，留在 Hubity 中等待人工审核和发送。
• 访问权限跟随你在 Hubity 中的角色。员工隐私信息会按角色排除，敏感文档永远不会返回。
• 分级权限：knowledge:read、mcp:read，以及三个写入工具所需的 mcp:write，后者只能在授权页面上授予。
• 每次写入都会记入公司活动日志，并记录授权人。
• 内置提示词包括 bill_the_month、month_end_wip、whos_over_capacity、projects_losing_money、collections、standup、meeting_prep 和 weekly_report。

Hubity MCP Server 工具

• 计费：preview_month_billing 预览当月发票；create_month_invoice_drafts 起草这些发票（写入）。
• 财务与 CRM：list_invoices、list_proposals、create_invoice_from_proposal（写入，根据已接受的提案起草发票）、list_deals、forecast_cash_flow（按账龄统计未结发票的预期回款，以及未开票工时的价值）。
• 项目与人员：list_projects、get_project_profitability、list_tasks、list_staff、get_utilization_report、list_pto_requests。
• 会议、工时与知识库：list_meetings、log_time_entry（写入）、search_knowledge。

除 list_pto_requests 外，每个列表工具在传入先前结果中的 id 时，也可以返回单条记录的完整内容。

Hubity MCP Server 的使用场景

• 月末结账：“给上个月开票：先让我看看每张发票会是什么样。”
• 项目健康度：“哪些在进行的项目有风险？它们赚钱吗？”
• 催收：“未付时间最长的发票是哪一张？”
• 在制品：“我们上个月的 WIP 是多少？”
• 资源安排：“上个月谁超负荷了？”

Hubity MCP Server 常见问题排查

• ChatGPT 无法记录工时或起草发票：ChatGPT 首次连接时只有读取权限。第一次发起写入请求时，Hubity 会请你在授权页面上允许写入权限。
• 团队成员在 Claude 中看不到该连接器：在 Team 和 Enterprise 计划中，需要所有者在 Organization settings → Connectors 中添加。
• 脚本返回 401：在 The Hub → Integrations → Connect an AI assistant 中创建只读访问码，并以 Authorization: Bearer 请求头发送。访问码可能已过期或被关闭。
• 请求被限流：默认限制是每个连接每小时 1,000 次请求。