Hubity

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

Server MCP Hubity: hubungkan asisten apa pun

Tugas yang paling umum adalah penagihan bulanan: asisten mempratinjau setiap faktur dari waktu yang disetujui, pengeluaran, retainer, dan progres kontrak, lalu menyusunnya untuk ditinjau dan dikirim oleh seseorang di Hubity. Membaca memerlukan masuk dan persetujuan Anda serta mengikuti peran Anda; tiga tindakan yang mengubah data memerlukan akses tulis yang Anda setujui.

Gratis di paket Starter untuk hingga 3 orang. Tanpa kartu.

Ringkasan

Hubity menjalankan server Model Context Protocol (MCP) jarak jauh di https://hubity.io/api/mcp. Asisten yang terhubung dapat menagih bulanan (membuat pratinjau setiap faktur, lalu menyusunnya untuk ditinjau), membaca proyek, tugas, orang, klien dan deal, proposal dan faktur, rapat, dan cuti, serta mencari basis pengetahuan perusahaan, selalu dibatasi pada apa yang boleh dilihat oleh orang yang masuk.

Tiga alat mengubah data: log_time_entry mencatat waktu, create_invoice_from_proposal mengubah proposal yang diterima menjadi faktur draf, dan create_month_invoice_drafts menyusun faktur bulanan untuk ditinjau. Tidak ada satu pun yang mengirim apa pun ke klien. Ketiganya memerlukan akses tulis (mcp:write), yang hanya diberikan saat orang yang terhubung menyetujuinya di layar persetujuan Hubity. Semua alat lain hanya membaca.

Server mengimplementasikan MCP 2026-07-28 melalui Streamable HTTP (permintaan tanpa status, server/discover) dan masih menerima klien yang membuka dengan jabat tangan 2025-11-25 initialize. OAuth 2.1 dengan PKCE adalah masuk utama, dan setiap koneksi menampilkan layar persetujuan Hubity yang mencantumkan dengan tepat apa yang boleh dilakukan asisten. Kode akses khusus-baca, yang dibuat di The Hub di bawah Integrations, berfungsi untuk klien baris perintah dan skrip.

Menghubungkan

Klien yang didukung: Claude, Claude Desktop, Claude Code, ChatGPT, Microsoft Copilot (melalui Copilot Studio), Grok, Gemini, Cursor, VS Code, dan Windsurf. Masing-masing memasukkan Anda ke Hubity dengan OAuth dan menampilkan layar persetujuan, tempat Anda memilih Izinkan akses atau Tolak.

Claude dan Claude Desktop

Di Claude, buka Customize → Connectors → Add → Add custom connector dan tempel https://hubity.io/api/mcp (di paket Team dan Enterprise, pemilik menambahkannya di bawah Organization settings → Connectors terlebih dahulu). Claude Desktop menggunakan konektor yang sama. Claude memasukkan Anda ke Hubity dan menampilkan layar persetujuan; izinkan akses dan alat-alat akan muncul.

Untuk menggunakan kode akses khusus-baca di Claude Desktop sebagai gantinya, tambahkan entri jembatan ke claude_desktop_config.json (memerlukan 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) mendaftarkan server dengan satu perintah. Untuk terhubung dengan masuk melalui browser (tanpa kode yang perlu dikelola):

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

Lalu jalankan /mcp di dalam Claude Code dan setujui masuk Hubity. Untuk menggunakan kode akses khusus-baca sebagai gantinya (praktis untuk skrip dan CI), teruskan sebagai header:

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

Tambahkan --scope user untuk membuat koneksi tersedia di semua proyek Anda, atau lakukan commit .mcp.json proyek untuk membagikannya dengan tim Anda. Verifikasi dengan claude mcp list.

ChatGPT

1. Di pengaturan ChatGPT, aktifkan Developer mode. Di workspace Business, Enterprise, atau Edu, admin mungkin perlu mengizinkannya terlebih dahulu.
2. Buat aplikasi atau konektor baru, beri nama Hubity, tempel https://hubity.io/api/mcp sebagai URL server MCP, dan pilih OAuth untuk autentikasi.
3. ChatGPT memasukkan Anda ke Hubity dan menampilkan layar persetujuan. Izinkan akses dan alat-alat akan muncul di obrolan Anda.

ChatGPT terhubung dengan akses baca terlebih dahulu. Pertama kali Anda memintanya mencatat waktu atau menyusun faktur, Hubity meminta Anda mengizinkan akses tulis; setujui di layar persetujuan dan tindakan akan berjalan.

Microsoft Copilot

Di Copilot Studio, buka agen, lalu Tools → Add a tool → New tool → Model Context Protocol. Beri nama Hubity, tempel https://hubity.io/api/mcp sebagai URL server, dan pilih OAuth 2.0 dengan Dynamic discovery. Buat koneksi baru, masuk ke Hubity, izinkan akses, lalu tambahkan alat ke agen. Langkah demi langkah: Hubity untuk Copilot.

Grok

Buka grok.com/connectors, pilih New Connector, lalu Custom, dan tempel https://hubity.io/api/mcp. Grok memasukkan Anda ke Hubity dan menampilkan layar persetujuan. Di tim Grok Business atau Enterprise, admin menambahkan konektor terlebih dahulu.

Gemini

Di gemini.google.com, buka Settings → Connected Apps, pilih Add a custom app, tempel https://hubity.io/api/mcp, dan pilih Next. Hubity mendaftarkan Gemini secara otomatis, jadi tidak diperlukan kredensial klien; masuk dan izinkan akses. Google saat ini menawarkan aplikasi kustom hanya dalam bahasa Inggris, untuk orang berusia 18 tahun ke atas di AS yang menggunakan Akun Google pribadi.

Cursor

Tambahkan Hubity ke ~/.cursor/mcp.json, lalu masuk saat Cursor meminta:

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

VS Code

Tambahkan Hubity ke .vscode/mcp.json, lalu masuk saat VS Code meminta:

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

Windsurf

Tambahkan Hubity ke ~/.codeium/windsurf/mcp_config.json, lalu masuk saat Windsurf meminta:

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

Endpoint

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

Penemuan

• /.well-known/mcp/server-card.json: kartu server, dengan setiap alat dan skema inputnya, plus prompt dan sumber daya. Juga disajikan di /.well-known/mcp.
• /api/mcp/server.json: entri Official MCP Registry.
• /.well-known/oauth-authorization-server: metadata server otorisasi OAuth 2.1 (RFC 8414).
• /.well-known/oauth-protected-resource/api/mcp: metadata sumber daya yang dilindungi untuk endpoint MCP (RFC 9728).

Autentikasi

OAuth 2.1 (disarankan)

• Endpoint otorisasi: https://hubity.io/api/mcp/oauth/authorize
• Endpoint token: https://hubity.io/api/mcp/token
• Pendaftaran klien: Client ID Metadata Documents (HTTPS client_id, lebih disukai), atau pendaftaran RFC 7591 untuk klien publik di https://hubity.io/api/mcp/oauth/register
• Setiap otorisasi menampilkan layar persetujuan; akses tulis (mcp:write) hanya diberikan di sana
• PKCE wajib; code_challenge_method harus S256
• Token refresh berputar pada setiap penggunaan

Kode akses

Untuk skrip dan penggunaan baris perintah, admin membuat kode akses khusus-baca yang terbatas pada perusahaan di The Hub → Integrations → Connect an AI assistant. Kode dapat diberi cakupan dan masa berlaku saat dibuat, dan dapat dimatikan kapan saja. Setiap permintaan dicatat dalam log aktivitas perusahaan.

Cakupan

• knowledge:read: mencari dan membaca dokumen pengetahuan perusahaan
• mcp:read: akses baca di seluruh proyek, tugas, staf, penagihan, CRM, rapat, dan cuti
• mcp:write: tiga alat tulis (entri waktu, faktur dari proposal yang diterima, draf faktur bulanan)

Alat

Daftar alat yang otoritatif, dengan skema input setiap alat, adalah tools/list melalui protokol MCP langsung atau array tools di kartu server. Kategori:

Setiap alat daftar kecuali list_pto_requests juga membaca satu catatan secara lengkap saat diberi id dari hasil sebelumnya, dan search_knowledge melakukan hal yang sama untuk satu dokumen.

Pengetahuan

• search_knowledge

Proyek & tugas

• list_projects, get_project_profitability
• list_tasks

Staf & organisasi

• list_staff, termasuk kepada siapa setiap orang melapor
• list_pto_requests

Keuangan & CRM

• list_invoices
• list_proposals, create_invoice_from_proposal (tulis, memerlukan mcp:write)
• list_deals
• forecast_cash_flow, get_utilization_report
• preview_month_billing, apa yang akan disusun oleh penagihan bulanan; create_month_invoice_drafts (tulis, memerlukan mcp:write)

Rapat

• list_meetings

Waktu

• log_time_entry (tulis, memerlukan mcp:write)

Prompt dan sumber daya

Selain alat, server menawarkan prompt siap pakai untuk pekerjaan yang dijalankan firma (misalnya, penagihan bulanan, pekerjaan dalam proses akhir bulan, penagihan, siapa yang melebihi kapasitas, atau standup) dan sumber daya yang dapat dibaca asisten secara langsung untuk konteks, seperti rapat hari ini, dokumen pengetahuan, atau satu proyek. Keduanya mengikuti izin yang sama dengan alat.

Daftar saat ini adalah prompts/list, resources/list, dan resources/templates/list melalui protokol MCP langsung, dan array prompts, resources, dan resourceTemplates di kartu server.

Keamanan

• Setiap respons membawa header MCP-Protocol-Version yang dinegosiasikan (2026-07-28 atau 2025-11-25).
• Setiap penulisan dicatat dalam log aktivitas perusahaan dengan orang yang mengotorisasinya.
• Isolasi penyewa: setiap koneksi dibatasi pada satu perusahaan; pembacaan lintas perusahaan ditolak di lapisan izin.
• Enkripsi: data dienkripsi saat disimpan (AES-256) dan saat transit (TLS).
• Konten sensitif (diarsipkan, visibilitas pribadi, terenkripsi di tingkat bidang) tidak pernah dikembalikan melalui MCP.
• Batas kecepatan: 1.000 permintaan per jam per koneksi secara default, dengan anggaran lebih tinggi yang dinegosiasikan untuk perusahaan enterprise. Endpoint penemuan anonim dan OAuth memiliki batas per-IP yang lebih rendah untuk mencegah penyalahgunaan.