Hubity

官方

面向咨询、建筑和工程公司的月末计费：您的AI助手根据已批准工时、预聘费和进度计费预览每张发票，然后起草供您审阅。

你可以用 Hubity MCP 做什么？

预览月度账单 — 让您的助手运行 preview_month_billing，在起草账单前查看一个月的发票大致情况。
起草月度发票 — 让您的助手使用 create_month_invoice_drafts 准备所有已批准的发票，供您审阅和发送。
记录时间条目 — 指示您的助手通过 log_time_entry 记录您的时间，需在同意屏幕上批准写入权限。
将提案转换为发票 — 请您的助手使用 create_invoice_from_proposal 将已接受的提案转为发票草稿。
搜索公司知识 — 让您的助手查询 search_knowledge，在公司的内部文档中查找答案。

托管 MCP 服务器

npx add-mcp 'https://hubity.io/api/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Hubity MCP 服务器：连接任意助手

最常见的任务是按月计费：助手根据已批准的时间、费用、预付款和合同进度预览每张发票，然后起草发票供人员在 Hubity 中审核和发送。读取操作需要你的登录和批准，并遵循你的角色权限；三个更改数据的操作需要你批准写访问权限。

Starter 计划最多 3 人免费使用。无需银行卡。

概述

Hubity 在 https://hubity.io/api/mcp 运行远程模型上下文协议（MCP）服务器。已连接的助手可以按月计费（预览每张发票，然后起草供审核）、读取项目、任务、人员、客户和交易、提案和发票、会议以及休假信息，并搜索公司知识库，始终限于已登录人员可查看的内容。

三个工具会更改数据：log_time_entry 记录时间，create_invoice_from_proposal 将已接受的提案转换为发票草稿，create_month_invoice_drafts 起草一个月的发票供审核。它们都不会向客户发送任何内容。这三个工具都需要写访问权限（mcp:write），只有在连接人员在 Hubity 同意屏幕上批准时才授予。其他所有工具仅读取。

服务器通过 Streamable HTTP 实现 MCP 2026-07-28（无状态请求，server/discover），并且仍然接受以 2025-11-25 initialize 握手方式打开的客户端。OAuth 2.1 与 PKCE 是主要登录方式，每次连接都会显示 Hubity 同意屏幕，列出助手可以执行的确切操作。在 The Hub 的 Integrations 下创建的只读访问代码适用于命令行客户端和脚本。

连接

支持的客户端：Claude、Claude Desktop、Claude Code、ChatGPT、Microsoft Copilot（通过 Copilot Studio）、Grok、Gemini、Cursor、VS Code 和 Windsurf。每个客户端都会让你通过 OAuth 登录 Hubity 并显示同意屏幕，你可以在其中选择 允许访问 或拒绝。

Claude 和 Claude Desktop

在 Claude 中，打开 Customize → Connectors → Add → Add custom connector 并粘贴 https://hubity.io/api/mcp（在 Team 和 Enterprise 计划中，所有者需要先在 Organization settings → Connectors 下添加）。Claude Desktop 使用相同的连接器。Claude 会让你登录 Hubity 并显示同意屏幕；允许访问后工具即可使用。

要在 Claude Desktop 中使用只读访问代码，请向 claude_desktop_config.json 添加桥接条目（需要 Node.js）：

{
  "mcpServers": {
    "hubity": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hubity.io/api/mcp",
               "--header", "Authorization: Bearer <access code>"]
    }
  }
}

Claude Code

Claude Code（CLI）通过单个命令注册服务器。要使用浏览器登录连接（无需管理代码）：

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 <access code>"

添加 --scope user 以使连接在你的所有项目中可用，或提交项目 .mcp.json 与团队共享。使用 claude mcp list 验证。

ChatGPT

在 ChatGPT 的设置中，打开 开发者模式。在 Business、Enterprise 或 Edu 工作区中，管理员可能需要先允许。
创建新应用或连接器，命名为 Hubity，粘贴 https://hubity.io/api/mcp 作为 MCP 服务器 URL，并选择 OAuth 进行身份验证。
ChatGPT 会让你登录 Hubity 并显示同意屏幕。允许访问后工具即可在你的聊天中使用。

ChatGPT 首先以读取访问权限连接。当你第一次要求它记录时间或起草发票时，Hubity 会要求你允许写访问权限；在同意屏幕上批准后操作即可执行。

Microsoft Copilot

在 Copilot Studio 中，打开代理，然后选择 Tools → Add a tool → New tool → Model Context Protocol。命名为 Hubity，粘贴 https://hubity.io/api/mcp 作为服务器 URL，并选择 OAuth 2.0 和 动态发现。创建新连接，登录 Hubity，允许访问，然后将工具添加到代理。逐步操作：Hubity for Copilot。

Grok

转到 grok.com/connectors，选择 新建连接器，然后选择 自定义，并粘贴 https://hubity.io/api/mcp。Grok 会让你登录 Hubity 并显示同意屏幕。在 Grok Business 或 Enterprise 团队中，管理员需要先添加连接器。

Gemini

在 gemini.google.com，打开 Settings → Connected Apps，选择 添加自定义应用，粘贴 https://hubity.io/api/mcp，然后选择 下一步。Hubity 会自动注册 Gemini，因此无需客户端凭据；登录并允许访问。Google 目前仅向美国 18 岁及以上使用个人 Google 账户的用户提供英文版自定义应用。

Cursor

将 Hubity 添加到 ~/.cursor/mcp.json，然后在 Cursor 提示时登录：

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

VS Code

将 Hubity 添加到 .vscode/mcp.json，然后在 VS Code 提示时登录：

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

Windsurf

将 Hubity 添加到 ~/.codeium/windsurf/mcp_config.json，然后在 Windsurf 提示时登录：

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

端点

POST https://hubity.io/api/mcp
Content-Type: application/json
Authorization: Bearer <access code>
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: search_knowledge

发现

/.well-known/mcp/server-card.json：服务器卡片，包含每个工具及其输入模式，以及提示和资源。也可在 /.well-known/mcp 获取。
/api/mcp/server.json：官方 MCP 注册表条目。
/.well-known/oauth-authorization-server：OAuth 2.1 授权服务器元数据（RFC 8414）。
/.well-known/oauth-protected-resource/api/mcp：MCP 端点的受保护资源元数据（RFC 9728）。

身份验证

OAuth 2.1（推荐）

授权端点：https://hubity.io/api/mcp/oauth/authorize
令牌端点：https://hubity.io/api/mcp/token
客户端注册：客户端 ID 元数据文档（HTTPS client_id，首选），或公共客户端的 RFC 7591 注册，位于 https://hubity.io/api/mcp/oauth/register
每次授权都会显示同意屏幕；写访问权限（mcp:write）仅在此处授予
需要 PKCE；code_challenge_method 必须为 S256
刷新令牌在每次使用时轮换

访问代码

对于脚本和命令行使用，管理员在 The Hub → Integrations → Connect an AI assistant 创建只读、公司范围的访问代码。代码在创建时可以设置范围和过期时间，并可随时关闭。每个请求都会记录在公司活动日志中。

范围

knowledge:read：搜索和读取公司知识文档
mcp:read：跨项目、任务、员工、发票、CRM、会议和休假的读取访问权限
mcp:write：三个写入工具（时间条目、来自已接受提案的发票、一个月的发票草稿）

工具

权威工具列表及每个工具的输入模式，可通过实时 MCP 协议的 tools/list 或服务器卡片中的 tools 数组获取。类别：

除 list_pto_requests 外的每个列表工具，在给定先前结果中的 ID 时，也会完整读取一条记录，search_knowledge 对单个文档执行相同操作。

知识

search_knowledge

项目与任务

list_projects、get_project_profitability
list_tasks

员工与组织

list_staff，包括每个人的汇报对象
list_pto_requests

财务与 CRM

list_invoices
list_proposals、create_invoice_from_proposal（写入，需要 mcp:write）
list_deals
forecast_cash_flow、get_utilization_report
preview_month_billing，按月计费将起草的内容；create_month_invoice_drafts（写入，需要 mcp:write）

会议

list_meetings

时间

log_time_entry（写入，需要 mcp:write）

提示和资源

除工具外，服务器还提供针对公司常见任务的现成提示（例如，按月计费、月末进行中的工作、收款、谁超负荷或每日站会），以及助手可以直接读取的上下文资源，例如今天的会议、知识文档或单个项目。两者遵循与工具相同的权限。

当前列表可通过实时 MCP 协议的 prompts/list、resources/list 和 resources/templates/list 获取，以及服务器卡片中的 prompts、resources 和 resourceTemplates 数组。

安全

每个响应都携带协商的 MCP-Protocol-Version 标头（2026-07-28 或 2025-11-25）。
每次写入都会记录在公司活动日志中，并附有授权人员信息。
租户隔离：每个连接仅限于单个公司；跨公司读取在权限层被拒绝。
加密：数据在存储时加密（AES-256），传输时加密（TLS）。
敏感内容（已归档、个人可见性、字段级加密）永远不会通过 MCP 返回。
速率限制：默认每个连接每小时 1,000 个请求，企业公司可协商更高的预算。匿名发现和 OAuth 端点有自己的较低每 IP 限制以防止滥用。