Hubity

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

Máy chủ MCP Hubity: kết nối mọi trợ lý

Công việc phổ biến nhất là chốt hóa đơn theo tháng: một trợ lý xem trước từng hóa đơn từ thời gian đã duyệt, chi phí, khoản giữ trước và tiến độ hợp đồng, sau đó soạn thảo chúng để một người xem xét và gửi trong Hubity. Việc đọc cần đăng nhập và phê duyệt của bạn và tuân theo vai trò của bạn; ba hành động thay đổi dữ liệu cần quyền ghi mà bạn phê duyệt.

Miễn phí trên gói Starter cho tối đa 3 người. Không cần thẻ.

Tổng quan

Hubity chạy một máy chủ Giao thức Ngữ cảnh Mô hình (MCP) từ xa tại https://hubity.io/api/mcp. Một trợ lý được kết nối có thể chốt hóa đơn theo tháng (xem trước từng hóa đơn, sau đó soạn thảo chúng để xem xét), đọc dự án, nhiệm vụ, nhân sự, khách hàng và thương vụ, đề xuất và hóa đơn, cuộc họp, và thời gian nghỉ, cũng như tìm kiếm cơ sở tri thức công ty, luôn giới hạn trong phạm vi người đăng nhập được phép xem.

Ba công cụ thay đổi dữ liệu: log_time_entry ghi lại thời gian, create_invoice_from_proposal chuyển một đề xuất được chấp nhận thành hóa đơn nháp, và create_month_invoice_drafts soạn thảo hóa đơn của một tháng để xem xét. Không công cụ nào trong số đó gửi bất cứ điều gì đến khách hàng. Cả ba đều cần quyền ghi (mcp:write), chỉ được cấp khi người kết nối phê duyệt trên màn hình đồng ý của Hubity. Mọi công cụ khác chỉ đọc.

Máy chủ triển khai MCP 2026-07-28 qua HTTP Streamable (yêu cầu không trạng thái, server/discover) và vẫn chấp nhận các máy khách mở bằng bắt tay 2025-11-25 initialize. OAuth 2.1 với PKCE là phương thức đăng nhập chính, và mọi kết nối đều hiển thị màn hình đồng ý của Hubity liệt kê chính xác những gì trợ lý được phép làm. Mã truy cập chỉ đọc, được tạo trong Hub dưới mục Tích hợp, hoạt động cho các máy khách dòng lệnh và tập lệnh.

Kết nối

Các máy khách được hỗ trợ: Claude, Claude Desktop, Claude Code, ChatGPT, Microsoft Copilot (qua Copilot Studio), Grok, Gemini, Cursor, VS Code, và Windsurf. Mỗi máy khách đăng nhập bạn vào Hubity bằng OAuth và hiển thị màn hình đồng ý, nơi bạn chọn Cho phép truy cập hoặc Từ chối.

Claude và Claude Desktop

Trong Claude, mở Customize → Connectors → Add → Add custom connector và dán https://hubity.io/api/mcp (trên gói Team và Enterprise, chủ sở hữu thêm nó dưới Organization settings → Connectors trước). Claude Desktop sử dụng cùng các bộ kết nối. Claude đăng nhập bạn vào Hubity và hiển thị màn hình đồng ý; cho phép truy cập và các công cụ sẽ xuất hiện.

Để sử dụng mã truy cập chỉ đọc trong Claude Desktop thay vào đó, thêm một mục cầu nối vào claude_desktop_config.json (yêu cầu 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) đăng ký máy chủ bằng một lệnh duy nhất. Để kết nối bằng đăng nhập trình duyệt (không cần quản lý mã):

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

Sau đó chạy /mcp bên trong Claude Code và phê duyệt đăng nhập Hubity. Để sử dụng mã truy cập chỉ đọc thay vào đó (tiện cho tập lệnh và CI), truyền nó dưới dạng tiêu đề:

claude mcp add --transport http hubity https://hubity.io/api/mcp \
 --header "Authorization: Bearer <access code>"

Thêm --scope user để kết nối khả dụng trên tất cả các dự án của bạn, hoặc cam kết một .mcp.json dự án để chia sẻ với nhóm của bạn. Xác minh bằng claude mcp list.

ChatGPT

1. Trong cài đặt ChatGPT, bật Chế độ nhà phát triển. Trên không gian làm việc Business, Enterprise hoặc Edu, quản trị viên có thể cần cho phép trước.
2. Tạo một ứng dụng hoặc bộ kết nối mới, đặt tên là Hubity, dán https://hubity.io/api/mcp làm URL máy chủ MCP, và chọn OAuth để xác thực.
3. ChatGPT đăng nhập bạn vào Hubity và hiển thị màn hình đồng ý. Cho phép truy cập và các công cụ xuất hiện trong cuộc trò chuyện của bạn.

ChatGPT kết nối với quyền đọc trước. Lần đầu tiên bạn yêu cầu nó ghi thời gian hoặc soạn hóa đơn, Hubity yêu cầu bạn cho phép quyền ghi; phê duyệt trên màn hình đồng ý và hành động sẽ chạy.

Microsoft Copilot

Trong Copilot Studio, mở tác nhân, sau đó Tools → Add a tool → New tool → Model Context Protocol. Đặt tên là Hubity, dán https://hubity.io/api/mcp làm URL máy chủ, và chọn OAuth 2.0 với Khám phá động. Tạo một kết nối mới, đăng nhập vào Hubity, cho phép truy cập, sau đó thêm công cụ vào tác nhân. Từng bước: Hubity cho Copilot.

Grok

Đi đến grok.com/connectors, chọn Bộ kết nối mới, sau đó Tùy chỉnh, và dán https://hubity.io/api/mcp. Grok đăng nhập bạn vào Hubity và hiển thị màn hình đồng ý. Trên nhóm Grok Business hoặc Enterprise, quản trị viên thêm bộ kết nối trước.

Gemini

Tại gemini.google.com, mở Settings → Connected Apps, chọn Thêm ứng dụng tùy chỉnh, dán https://hubity.io/api/mcp, và chọn Tiếp theo. Hubity đăng ký Gemini tự động, vì vậy không cần thông tin xác thực máy khách; đăng nhập và cho phép truy cập. Google hiện chỉ cung cấp ứng dụng tùy chỉnh bằng tiếng Anh, cho người từ 18 tuổi trở lên tại Hoa Kỳ sử dụng Tài khoản Google cá nhân.

Cursor

Thêm Hubity vào ~/.cursor/mcp.json, sau đó đăng nhập khi Cursor nhắc:

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

VS Code

Thêm Hubity vào .vscode/mcp.json, sau đó đăng nhập khi VS Code nhắc:

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

Windsurf

Thêm Hubity vào ~/.codeium/windsurf/mcp_config.json, sau đó đăng nhập khi Windsurf nhắc:

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

Điểm cuối

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

Khám phá

• /.well-known/mcp/server-card.json: thẻ máy chủ, với mọi công cụ và lược đồ đầu vào của nó, cùng các lời nhắc và tài nguyên. Cũng được phục vụ tại /.well-known/mcp.
• /api/mcp/server.json: mục nhập Sổ đăng ký MCP chính thức.
• /.well-known/oauth-authorization-server: siêu dữ liệu máy chủ ủy quyền OAuth 2.1 (RFC 8414).
• /.well-known/oauth-protected-resource/api/mcp: siêu dữ liệu tài nguyên được bảo vệ cho điểm cuối MCP (RFC 9728).

Xác thực

OAuth 2.1 (khuyến nghị)

• Điểm cuối ủy quyền: https://hubity.io/api/mcp/oauth/authorize
• Điểm cuối mã thông báo: https://hubity.io/api/mcp/token
• Đăng ký máy khách: Tài liệu Siêu dữ liệu ID Máy khách (một HTTPS client_id, được ưu tiên), hoặc đăng ký RFC 7591 cho máy khách công khai tại https://hubity.io/api/mcp/oauth/register
• Mọi ủy quyền đều hiển thị màn hình đồng ý; quyền ghi (mcp:write) chỉ được cấp ở đó
• PKCE là bắt buộc; code_challenge_method phải là S256
• Mã thông báo làm mới xoay vòng trên mỗi lần sử dụng

Mã truy cập

Cho tập lệnh và sử dụng dòng lệnh, quản trị viên tạo một mã truy cập chỉ đọc, phạm vi công ty tại The Hub → Integrations → Connect an AI assistant. Một mã có thể được giới hạn phạm vi và đặt thời hạn khi tạo, và bị tắt bất cứ lúc nào. Mọi yêu cầu được ghi lại trong nhật ký hoạt động công ty.

Phạm vi

• knowledge:read: tìm kiếm và đọc tài liệu tri thức công ty
• mcp:read: quyền đọc trên các dự án, nhiệm vụ, nhân sự, hóa đơn, CRM, cuộc họp, và thời gian nghỉ
• mcp:write: ba công cụ ghi (mục thời gian, hóa đơn từ đề xuất được chấp nhận, hóa đơn nháp của một tháng)

Công cụ

Danh sách công cụ có thẩm quyền, với lược đồ đầu vào của mỗi công cụ, là tools/list qua giao thức MCP trực tiếp hoặc mảng tools trong thẻ máy chủ. Danh mục:

Mọi công cụ danh sách ngoại trừ list_pto_requests cũng đọc một bản ghi đầy đủ khi được cung cấp id từ kết quả trước đó, và search_knowledge làm tương tự cho một tài liệu.

Tri thức

• search_knowledge

Dự án & nhiệm vụ

• list_projects, get_project_profitability
• list_tasks

Nhân sự & tổ chức

• list_staff, bao gồm người mà mỗi nhân viên báo cáo cho
• list_pto_requests

Tài chính & CRM

• list_invoices
• list_proposals, create_invoice_from_proposal (ghi, cần mcp:write)
• list_deals
• forecast_cash_flow, get_utilization_report
• preview_month_billing, những gì chốt hóa đơn một tháng sẽ soạn thảo; create_month_invoice_drafts (ghi, cần mcp:write)

Cuộc họp

• list_meetings

Thời gian

• log_time_entry (ghi, cần mcp:write)

Lời nhắc và tài nguyên

Ngoài các công cụ, máy chủ cung cấp các lời nhắc được chuẩn bị sẵn cho các công việc mà một công ty thực hiện (ví dụ, chốt hóa đơn theo tháng, công việc dở dang cuối tháng, thu hồi nợ, ai đang quá tải, hoặc một cuộc họp đứng) và các tài nguyên mà trợ lý có thể đọc trực tiếp để lấy ngữ cảnh, chẳng hạn như cuộc họp hôm nay, một tài liệu tri thức, hoặc một dự án đơn lẻ. Cả hai tuân theo cùng quyền hạn như các công cụ.

Danh sách hiện tại là prompts/list, resources/list và resources/templates/list qua giao thức MCP trực tiếp, và các mảng prompts, resources và resourceTemplates trong thẻ máy chủ.

Bảo mật

• Mọi phản hồi đều mang tiêu đề MCP-Protocol-Version đã thương lượng (2026-07-28 hoặc 2025-11-25).
• Mọi thao tác ghi đều được ghi lại trong nhật ký hoạt động công ty với người đã ủy quyền.
• Cách ly đối tượng thuê: mỗi kết nối được giới hạn trong một công ty duy nhất; việc đọc chéo công ty bị từ chối ở lớp quyền hạn.
• Mã hóa: dữ liệu được mã hóa khi lưu trữ (AES-256) và khi truyền (TLS).
• Nội dung nhạy cảm (đã lưu trữ, hiển thị cá nhân, mã hóa ở cấp trường) không bao giờ được trả về qua MCP.
• Giới hạn tốc độ: 1.000 yêu cầu mỗi giờ cho mỗi kết nối theo mặc định, với ngân sách cao hơn được thương lượng cho các công ty doanh nghiệp. Khám phá ẩn danh và điểm cuối OAuth mang giới hạn mỗi IP thấp hơn riêng của chúng để ngăn chặn lạm dụng.