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（無狀態請求，server/discover）實作 MCP 2026-07-28，並仍接受以 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，選擇 New Connector，然後選擇 Custom，並貼上 https://hubity.io/api/mcp。Grok 會將您登入 Hubity 並顯示同意畫面。在 Grok Business 或 Enterprise 團隊中，管理員會先新增連接器。

Gemini

在 gemini.google.com，開啟 Settings → Connected Apps，選擇 Add a custom app，貼上 https://hubity.io/api/mcp，然後選取 Next。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
用戶端註冊：Client ID Metadata Documents（HTTPS client_id，較佳），或公開用戶端在 https://hubity.io/api/mcp/oauth/register 的 RFC 7591 註冊
每次授權都會顯示同意畫面；寫入權限（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 限制，以防止濫用。