Hubity

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

Hubity MCP sunucusu: herhangi bir asistana bağlanın

En yaygın iş, ayı faturalamaktır: bir asistan, onaylanan süre, giderler, avanslar ve sözleşme ilerlemesinden her faturayı önizler, ardından bunları bir kişinin incelemesi ve Hubity'de göndermesi için taslak haline getirir. Okuma, oturum açmanızı ve onayınızı gerektirir ve rolünüzü takip eder; verileri değiştiren üç eylem, onayladığınız yazma erişimini gerektirir.

Starter'da 3 kişiye kadar ücretsizdir. Kart gerekmez.

Genel Bakış

Hubity, https://hubity.io/api/mcp adresinde uzak bir Model Context Protocol (MCP) sunucusu çalıştırır. Bağlı bir asistan, ayı faturalayabilir (her faturayı önizler, ardından inceleme için taslak haline getirir), projeleri, görevleri, personeli, müşterileri ve anlaşmaları, teklifleri ve faturaları, toplantıları ve izinleri okuyabilir ve şirket bilgi tabanında arama yapabilir; her zaman oturum açan kişinin görebilecekleriyle sınırlıdır.

Üç araç verileri değiştirir: log_time_entry süreyi kaydeder, create_invoice_from_proposal kabul edilen bir teklifi taslak faturaya dönüştürür ve create_month_invoice_drafts bir ayın faturalarını inceleme için taslak haline getirir. Hiçbiri bir müşteriye hiçbir şey göndermez. Üçü de yazma erişimi gerektirir (mcp:write), bu yalnızca bağlanan kişi Hubity onay ekranında onayladığında verilir. Diğer her araç yalnızca okur.

Sunucu, Streamable HTTP üzerinden MCP 2026-07-28 uygular (durumsuz istekler, server/discover) ve 2025-11-25 initialize el sıkışmasıyla açılan istemcileri kabul etmeye devam eder. PKCE ile OAuth 2.1 birincil oturum açma yöntemidir ve her bağlantı, asistanın tam olarak ne yapabileceğini listeleyen bir Hubity onay ekranı gösterir. Entegrasyonlar altında The Hub'da oluşturulan salt okunur erişim kodları, komut satırı istemcileri ve betikler için çalışır.

Bağlanma

Desteklenen istemciler: Claude, Claude Desktop, Claude Code, ChatGPT, Microsoft Copilot (Copilot Studio aracılığıyla), Grok, Gemini, Cursor, VS Code ve Windsurf. Her biri sizi OAuth ile Hubity'de oturum açtırır ve Erişime İzin Ver veya Reddet seçeneklerini seçtiğiniz onay ekranını gösterir.

Claude ve Claude Desktop

Claude'da Customize → Connectors → Add → Add custom connector öğesini açın ve https://hubity.io/api/mcp öğesini yapıştırın (Team ve Enterprise'da, bir sahip önce Organization settings → Connectors altında ekler). Claude Desktop aynı bağlayıcıları kullanır. Claude sizi Hubity'de oturum açtırır ve onay ekranını gösterir; erişime izin verin ve araçlar görünür.

Bunun yerine Claude Desktop'ta salt okunur bir erişim kodu kullanmak için claude_desktop_config.json öğesine bir köprü girişi ekleyin (Node.js gerektirir):

{
  "mcpServers": {
    "hubity": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hubity.io/api/mcp",
               "--header", "Authorization: Bearer <access code>"]
    }
  }
}

Claude Code

Claude Code (CLI), sunucuları tek bir komutla kaydeder. Tarayıcı oturum açma ile bağlanmak için (yönetilecek kod yok):

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

Ardından Claude Code içinde /mcp komutunu çalıştırın ve Hubity oturum açmayı onaylayın. Bunun yerine salt okunur bir erişim kodu kullanmak için (betikler ve CI için kullanışlıdır), bunu bir başlık olarak iletin:

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

Bağlantıyı tüm projelerinizde kullanılabilir yapmak için --scope user ekleyin veya ekibinizle paylaşmak için bir proje .mcp.json işleyin. claude mcp list ile doğrulayın.

ChatGPT

1. ChatGPT'nin ayarlarında Geliştirici modunu açın. Business, Enterprise veya Edu çalışma alanında, bir yöneticinin önce buna izin vermesi gerekebilir.
2. Yeni bir uygulama veya bağlayıcı oluşturun, adını Hubity olarak belirleyin, MCP sunucu URL'si olarak https://hubity.io/api/mcp öğesini yapıştırın ve kimlik doğrulama için OAuth seçeneğini seçin.
3. ChatGPT sizi Hubity'de oturum açtırır ve onay ekranını gösterir. Erişime izin verin ve araçlar sohbetlerinizde görünür.

ChatGPT önce okuma erişimiyle bağlanır. İlk kez süre kaydetmesini veya fatura taslağı oluşturmasını istediğinizde, Hubity yazma erişimine izin vermenizi ister; onay ekranında onaylayın ve işlem çalışır.

Microsoft Copilot

Copilot Studio'da aracı açın, ardından Tools → Add a tool → New tool → Model Context Protocol öğesini seçin. Adını Hubity olarak belirleyin, sunucu URL'si olarak https://hubity.io/api/mcp öğesini yapıştırın ve Dinamik keşif ile OAuth 2.0 seçeneğini seçin. Yeni bir bağlantı oluşturun, Hubity'de oturum açın, erişime izin verin, ardından aracı aracıya ekleyin. Adım adım: Hubity for Copilot.

Grok

grok.com/connectors adresine gidin, Yeni Bağlayıcı, ardından Özel seçeneğini seçin ve https://hubity.io/api/mcp öğesini yapıştırın. Grok sizi Hubity'de oturum açtırır ve onay ekranını gösterir. Grok Business veya Enterprise ekibinde, bir yönetici önce bağlayıcıları ekler.

Gemini

gemini.google.com adresinde Settings → Connected Apps öğesini açın, Özel uygulama ekle seçeneğini seçin, https://hubity.io/api/mcp öğesini yapıştırın ve İleri seçeneğini seçin. Hubity, Gemini'yi otomatik olarak kaydeder, bu nedenle istemci kimlik bilgileri gerekmez; oturum açın ve erişime izin verin. Google şu anda özel uygulamaları yalnızca İngilizce olarak, ABD'de kişisel bir Google Hesabı kullanan 18 yaş ve üzeri kişilere sunmaktadır.

Cursor

Hubity'yi ~/.cursor/mcp.json öğesine ekleyin, ardından Cursor istediğinde oturum açın:

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

VS Code

Hubity'yi .vscode/mcp.json öğesine ekleyin, ardından VS Code istediğinde oturum açın:

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

Windsurf

Hubity'yi ~/.codeium/windsurf/mcp_config.json öğesine ekleyin, ardından Windsurf istediğinde oturum açın:

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

Uç Nokta

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

Keşif

• /.well-known/mcp/server-card.json: her araç ve giriş şeması ile sunucu kartı, ayrıca istemler ve kaynaklar. Ayrıca /.well-known/mcp adresinde sunulur.
• /api/mcp/server.json: Resmi MCP Kayıt Defteri girişi.
• /.well-known/oauth-authorization-server: OAuth 2.1 yetkilendirme sunucusu meta verileri (RFC 8414).
• /.well-known/oauth-protected-resource/api/mcp: MCP uç noktası için korumalı kaynak meta verileri (RFC 9728).

Kimlik Doğrulama

OAuth 2.1 (önerilir)

• Yetkilendirme uç noktası: https://hubity.io/api/mcp/oauth/authorize
• Belirteç uç noktası: https://hubity.io/api/mcp/token
• İstemci kaydı: İstemci Kimliği Meta Veri Belgeleri (HTTPS client_id, tercih edilen) veya https://hubity.io/api/mcp/oauth/register adresinde genel istemciler için RFC 7591 kaydı
• Her yetkilendirme bir onay ekranı gösterir; yazma erişimi (mcp:write) yalnızca orada verilir
• PKCE gereklidir; code_challenge_method değeri S256 olmalıdır
• Yenileme belirteçleri her kullanımda döndürülür

Erişim Kodları

Betikler ve komut satırı kullanımı için, bir yönetici The Hub → Integrations → Connect an AI assistant adresinde salt okunur, şirket kapsamlı bir erişim kodu oluşturur. Bir kod, oluşturulduğunda kapsamlandırılabilir ve bir son kullanma tarihi verilebilir ve istediği zaman kapatılabilir. Her istek şirket etkinlik günlüğüne kaydedilir.

Kapsamlar

• knowledge:read: şirket bilgi belgelerini arama ve okuma
• mcp:read: projeler, görevler, personel, faturalandırma, CRM, toplantılar ve izinler genelinde okuma erişimi
• mcp:write: üç yazma aracı (zaman girişleri, kabul edilen tekliflerden faturalar, bir ayın fatura taslakları)

Araçlar

Yetkili araç listesi, her aracın giriş şemasıyla birlikte, canlı MCP protokolü üzerinden tools/list veya sunucu kartındaki tools dizisidir. Kategoriler:

list_pto_requests dışındaki her liste aracı, daha önceki bir sonuçtan kimliği verildiğinde bir kaydı tam olarak da okur ve search_knowledge bir belge için aynısını yapar.

Bilgi

• search_knowledge

Projeler ve görevler

• list_projects, get_project_profitability
• list_tasks

Personel ve organizasyon

• list_staff, her kişinin kime rapor verdiği dahil
• list_pto_requests

Finans ve CRM

• list_invoices
• list_proposals, create_invoice_from_proposal (yazma, mcp:write gerektirir)
• list_deals
• forecast_cash_flow, get_utilization_report
• preview_month_billing, bir ayın faturalandırmasının ne taslaklayacağı; create_month_invoice_drafts (yazma, mcp:write gerektirir)

Toplantılar

• list_meetings

Zaman

• log_time_entry (yazma, mcp:write gerektirir)

İstemler ve Kaynaklar

Araçların ötesinde, sunucu bir firmanın yürüttüğü işler için hazır istemler (örneğin, ayı faturalama, ay sonu devam eden işler, tahsilatlar, kapasiteyi aşanlar veya bir stand-up) ve bir asistanın bağlam için doğrudan okuyabileceği kaynaklar (bugünün toplantıları, bir bilgi belgesi veya tek bir proje gibi) sunar. Her ikisi de araçlarla aynı izinleri takip eder.

Güncel listeler, canlı MCP protokolü üzerinden prompts/list, resources/list ve resources/templates/list ve sunucu kartındaki prompts, resources ve resourceTemplates dizileridir.

Güvenlik

• Her yanıt, müzakere edilen MCP-Protocol-Version başlığını taşır (2026-07-28 veya 2025-11-25).
• Her yazma, onu yetkilendiren kişiyle birlikte şirket etkinlik günlüğüne kaydedilir.
• Kiracı yalıtımı: her bağlantı tek bir şirketle sınırlıdır; şirketler arası okumalar izin katmanında reddedilir.
• Şifreleme: veriler depolandığında (AES-256) ve aktarım sırasında (TLS) şifrelenir.
• Hassas içerik (arşivlenmiş, kişisel görünürlük, alan düzeyinde şifrelenmiş) MCP üzerinden asla döndürülmez.
• Hız sınırları: varsayılan olarak bağlantı başına saatte 1.000 istek; kurumsal şirketler için daha yüksek müzakere edilmiş bütçelerle. Anonim keşif ve OAuth uç noktaları, kötüye kullanımı caydırmak için kendi daha düşük IP başına sınırlarını taşır.