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에서 원격 Model Context Protocol(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 with 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로 지정하고, MCP 서버 URL로 https://hubity.io/api/mcp을 붙여넣고, 인증으로 OAuth를 선택합니다.
ChatGPT가 Hubity에 로그인하고 동의 화면을 표시합니다. 액세스를 허용하면 도구가 채팅에 나타납니다.

ChatGPT는 먼저 읽기 액세스로 연결됩니다. 시간 기록이나 인보이스 초안 작성을 처음 요청하면 Hubity가 쓰기 액세스를 허용할지 묻습니다. 동의 화면에서 승인하면 작업이 실행됩니다.

Microsoft Copilot

Copilot Studio에서 에이전트를 열고 Tools → Add a tool → New tool → Model Context Protocol을 선택합니다. 이름을 Hubity로 지정하고, 서버 URL로 https://hubity.io/api/mcp을 붙여넣고, 동적 검색과 함께 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은 현재 미국에서 개인 Google 계정을 사용하는 18세 이상 사용자에게만 영어로 사용자 지정 앱을 제공합니다.

Cursor

~/.cursor/mcp.json에 Hubity를 추가한 다음 Cursor가 프롬프트를 표시할 때 로그인합니다:

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

VS Code

.vscode/mcp.json에 Hubity를 추가한 다음 VS Code가 프롬프트를 표시할 때 로그인합니다:

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

Windsurf

~/.codeium/windsurf/mcp_config.json에 Hubity를 추가한 다음 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당 더 낮은 자체 제한이 있습니다.