Hubity

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

MCP-сервер Hubity: подключите любого ассистента

Самая частая задача — выставление счетов за месяц: ассистент просматривает каждый счет на основе одобренного времени, расходов, ретейнеров и прогресса по контрактам, затем формирует их для проверки и отправки человеком в Hubity. Чтение требует вашего входа и одобрения и зависит от вашей роли; три действия, изменяющие данные, требуют доступа на запись, который вы одобряете.

Бесплатно на тарифе Starter для групп до 3 человек. Карта не нужна.

Обзор

Hubity запускает удаленный сервер Model Context Protocol (MCP) по адресу https://hubity.io/api/mcp. Подключенный ассистент может выставлять счета за месяц (предварительно просматривая каждый счет, затем формируя их для проверки), читать проекты, задачи, сотрудников, клиентов и сделки, предложения и счета, встречи и отпуска, а также искать в базе знаний компании — всегда в пределах того, что может видеть вошедший пользователь.

Три инструмента изменяют данные: log_time_entry записывает время, create_invoice_from_proposal превращает принятое предложение в черновик счета, а create_month_invoice_drafts формирует черновики счетов за месяц для проверки. Ни один из них ничего не отправляет клиенту. Все три требуют доступ на запись (mcp:write), который предоставляется только после одобрения пользователем на экране согласия Hubity. Все остальные инструменты только читают.

Сервер реализует MCP 2026-07-28 через Streamable HTTP (запросы без сохранения состояния, 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. Каждый из них выполняет вход в Hubity через OAuth и показывает экран согласия, где вы выбираете Разрешить доступ или Запретить.

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

Затем выполните /mcp внутри Claude Code и одобрите вход в 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

1. В настройках ChatGPT включите Developer mode. В рабочей области Business, Enterprise или Edu администратор может сначала разрешить это.
2. Создайте новое приложение или коннектор, назовите его Hubity, вставьте https://hubity.io/api/mcp как URL MCP-сервера и выберите OAuth для аутентификации.
3. 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 с Dynamic discovery. Создайте новое подключение, войдите в Hubity, разрешите доступ, затем добавьте инструмент агенту. Пошаговая инструкция: Hubity для 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: запись в Official MCP Registry.
• /.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, предпочтительно) или регистрация 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: три инструмента записи (записи времени, счета из принятых предложений, черновики счетов за месяц)

Инструменты

Авторитетный список инструментов со схемами ввода каждого — это tools/list через живой протокол MCP или массив 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)

Промпты и ресурсы

Помимо инструментов, сервер предлагает готовые промпты для типовых задач фирмы (например, выставление счетов за месяц, незавершенное производство на конец месяца, сбор платежей, кто перегружен или стендап) и ресурсы, которые ассистент может читать напрямую для контекста, такие как сегодняшние встречи, документ базы знаний или отдельный проект. Оба следуют тем же разрешениям, что и инструменты.

Текущие списки — это prompts/list, resources/list и resources/templates/list через живой протокол MCP, а также массивы prompts, resources и resourceTemplates в карточке сервера.

Безопасность

• Каждый ответ содержит согласованный заголовок MCP-Protocol-Version (2026-07-28 или 2025-11-25).
• Каждая запись фиксируется в журнале активности компании с указанием авторизовавшего лица.
• Изоляция арендаторов: каждое подключение ограничено одной компанией; межкомпанийные чтения отклоняются на уровне разрешений.
• Шифрование: данные шифруются при хранении (AES-256) и при передаче (TLS).
• Конфиденциальный контент (архивированный, личной видимости, зашифрованный на уровне полей) никогда не возвращается через MCP.
• Ограничения скорости: 1 000 запросов в час на подключение по умолчанию, с более высокими согласованными лимитами для корпоративных компаний. Анонимные конечные точки обнаружения и OAuth имеют собственные более низкие лимиты на IP для предотвращения злоупотреблений.