Hubity

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

Hubity MCP-Server: Beliebigen Assistenten anbinden

Die häufigste Aufgabe ist die monatliche Abrechnung: Ein Assistent erstellt eine Vorschau jeder Rechnung aus genehmigten Zeiten, Auslagen, Retainern und Vertragsfortschritt und entwirft sie dann zur Überprüfung und zum Versand in Hubity für eine Person. Das Lesen erfordert Ihre Anmeldung und Zustimmung und folgt Ihrer Rolle; die drei Aktionen, die Daten ändern, benötigen Schreibzugriff, den Sie genehmigen.

Kostenlos im Starter-Plan für bis zu 3 Personen. Keine Kreditkarte erforderlich.

Übersicht

Hubity betreibt einen entfernten Model Context Protocol (MCP)-Server unter https://hubity.io/api/mcp. Ein verbundener Assistent kann den Monat abrechnen (Vorschau jeder Rechnung, dann Entwürfe zur Überprüfung), Projekte, Aufgaben, Personen, Kunden und Deals, Angebote und Rechnungen, Besprechungen und Abwesenheiten lesen sowie die Unternehmens-Wissensdatenbank durchsuchen – immer begrenzt auf das, was die angemeldete Person sehen darf.

Drei Tools ändern Daten: log_time_entry erfasst Zeiten, create_invoice_from_proposal wandelt ein akzeptiertes Angebot in eine Rechnungsentwurf um, und create_month_invoice_drafts erstellt Entwürfe für die Rechnungen eines Monats zur Überprüfung. Keines davon sendet etwas an einen Kunden. Alle drei benötigen Schreibzugriff (mcp:write), der nur gewährt wird, wenn die verbindende Person ihn auf dem Hubity-Zustimmungsbildschirm genehmigt. Alle anderen Tools lesen nur.

Der Server implementiert MCP 2026-07-28 über Streamable HTTP (zustandslose Anfragen, server/discover) und akzeptiert weiterhin Clients, die mit dem 2025-11-25-initialize-Handshake beginnen. OAuth 2.1 mit PKCE ist die primäre Anmeldung, und jede Verbindung zeigt einen Hubity-Zustimmungsbildschirm, der genau auflistet, was der Assistent tun darf. Schreibgeschützte Zugangscodes, die im Hub unter Integrationen erstellt werden, funktionieren für Befehlszeilen-Clients und Skripte.

Verbinden

Unterstützte Clients: Claude, Claude Desktop, Claude Code, ChatGPT, Microsoft Copilot (über Copilot Studio), Grok, Gemini, Cursor, VS Code und Windsurf. Jeder meldet Sie mit OAuth bei Hubity an und zeigt den Zustimmungsbildschirm, auf dem Sie Zugriff erlauben oder Ablehnen wählen.

Claude und Claude Desktop

Öffnen Sie in Claude Customize → Connectors → Add → Add custom connector und fügen Sie https://hubity.io/api/mcp ein (bei Team und Enterprise fügt ein Eigentümer es zuerst unter Organization settings → Connectors hinzu). Claude Desktop verwendet dieselben Konnektoren. Claude meldet Sie bei Hubity an und zeigt den Zustimmungsbildschirm; erlauben Sie den Zugriff und die Tools erscheinen.

Um stattdessen einen schreibgeschützten Zugangscode in Claude Desktop zu verwenden, fügen Sie einen Brückeneintrag zu claude_desktop_config.json hinzu (erfordert Node.js):

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

Claude Code

Claude Code (die CLI) registriert Server mit einem einzigen Befehl. Für die Verbindung mit Browser-Anmeldung (kein Code zu verwalten):

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

Führen Sie dann /mcp in Claude Code aus und genehmigen Sie die Hubity-Anmeldung. Um stattdessen einen schreibgeschützten Zugangscode zu verwenden (praktisch für Skripte und CI), übergeben Sie ihn als Header:

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

Fügen Sie --scope user hinzu, um die Verbindung projektübergreifend verfügbar zu machen, oder committen Sie ein Projekt-.mcp.json, um es mit Ihrem Team zu teilen. Überprüfen Sie mit claude mcp list.

ChatGPT

1. Aktivieren Sie in den Einstellungen von ChatGPT den Entwicklermodus. In einem Business-, Enterprise- oder Edu-Arbeitsbereich muss ein Administrator dies möglicherweise zuerst erlauben.
2. Erstellen Sie eine neue App oder einen Konnektor, nennen Sie sie Hubity, fügen Sie https://hubity.io/api/mcp als MCP-Server-URL ein und wählen Sie OAuth für die Authentifizierung.
3. ChatGPT meldet Sie bei Hubity an und zeigt den Zustimmungsbildschirm. Erlauben Sie den Zugriff und die Tools erscheinen in Ihren Chats.

ChatGPT verbindet sich zunächst mit Lesezugriff. Wenn Sie es zum ersten Mal bitten, Zeiten zu erfassen oder eine Rechnung zu entwerfen, fordert Hubity Sie auf, Schreibzugriff zu erlauben; genehmigen Sie dies auf dem Zustimmungsbildschirm und die Aktion wird ausgeführt.

Microsoft Copilot

Öffnen Sie in Copilot Studio den Agenten und dann Tools → Add a tool → New tool → Model Context Protocol. Nennen Sie ihn Hubity, fügen Sie https://hubity.io/api/mcp als Server-URL ein und wählen Sie OAuth 2.0 mit Dynamischer Erkennung. Erstellen Sie eine neue Verbindung, melden Sie sich bei Hubity an, erlauben Sie den Zugriff und fügen Sie dann das Tool zum Agenten hinzu. Schritt für Schritt: Hubity für Copilot.

Grok

Gehen Sie zu grok.com/connectors, wählen Sie Neuer Konnektor, dann Benutzerdefiniert, und fügen Sie https://hubity.io/api/mcp ein. Grok meldet Sie bei Hubity an und zeigt den Zustimmungsbildschirm. In einem Grok Business- oder Enterprise-Team fügt ein Administrator zuerst Konnektoren hinzu.

Gemini

Öffnen Sie unter gemini.google.com Settings → Connected Apps, wählen Sie Benutzerdefinierte App hinzufügen, fügen Sie https://hubity.io/api/mcp ein und wählen Sie Weiter. Hubity registriert Gemini automatisch, sodass keine Client-Anmeldeinformationen erforderlich sind; melden Sie sich an und erlauben Sie den Zugriff. Google bietet benutzerdefinierte Apps derzeit nur auf Englisch an, für Personen ab 18 Jahren in den USA mit einem persönlichen Google-Konto.

Cursor

Fügen Sie Hubity zu ~/.cursor/mcp.json hinzu und melden Sie sich an, wenn Cursor dazu auffordert:

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

VS Code

Fügen Sie Hubity zu .vscode/mcp.json hinzu und melden Sie sich an, wenn VS Code dazu auffordert:

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

Windsurf

Fügen Sie Hubity zu ~/.codeium/windsurf/mcp_config.json hinzu und melden Sie sich an, wenn Windsurf dazu auffordert:

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

Endpunkt

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

Erkennung

• /.well-known/mcp/server-card.json: die Serverkarte mit jedem Tool und seinem Eingabeschema sowie den Prompts und Ressourcen. Auch verfügbar unter /.well-known/mcp.
• /api/mcp/server.json: der Eintrag im offiziellen MCP-Registry.
• /.well-known/oauth-authorization-server: OAuth 2.1-Autorisierungsserver-Metadaten (RFC 8414).
• /.well-known/oauth-protected-resource/api/mcp: Metadaten der geschützten Ressource für den MCP-Endpunkt (RFC 9728).

Authentifizierung

OAuth 2.1 (empfohlen)

• Autorisierungsendpunkt: https://hubity.io/api/mcp/oauth/authorize
• Token-Endpunkt: https://hubity.io/api/mcp/token
• Client-Registrierung: Client-ID-Metadatendokumente (ein HTTPS-client_id, bevorzugt) oder RFC 7591-Registrierung für öffentliche Clients unter https://hubity.io/api/mcp/oauth/register
• Jede Autorisierung zeigt einen Zustimmungsbildschirm; Schreibzugriff (mcp:write) wird nur dort gewährt
• PKCE ist erforderlich; code_challenge_method muss S256 sein
• Aktualisierungstokens rotieren bei jeder Verwendung

Zugangscodes

Für Skripte und Befehlszeilenverwendung erstellt ein Administrator einen schreibgeschützten, unternehmensweiten Zugangscode unter The Hub → Integrations → Connect an AI assistant. Ein Code kann bei der Erstellung eingeschränkt und mit einem Ablaufdatum versehen und jederzeit deaktiviert werden. Jede Anfrage wird im Unternehmensaktivitätsprotokoll aufgezeichnet.

Bereiche

• knowledge:read: Suche und Lesen von Unternehmenswissensdokumenten
• mcp:read: Lesezugriff auf Projekte, Aufgaben, Personal, Rechnungsstellung, CRM, Besprechungen und Abwesenheiten
• mcp:write: die drei Schreib-Tools (Zeiteinträge, Rechnungen aus akzeptierten Angeboten, Rechnungsentwürfe für einen Monat)

Tools

Die maßgebliche Tool-Liste mit dem Eingabeschema jedes Tools ist tools/list über das Live-MCP-Protokoll oder das tools-Array in der Serverkarte. Kategorien:

Jedes Listentool außer list_pto_requests liest auch einen Datensatz vollständig, wenn seine ID aus einem früheren Ergebnis angegeben wird, und search_knowledge macht dasselbe für ein Dokument.

Wissen

• search_knowledge

Projekte & Aufgaben

• list_projects, get_project_profitability
• list_tasks

Personal & Organisation

• list_staff, einschließlich der Berichtsstruktur jeder Person
• list_pto_requests

Finanzen & CRM

• list_invoices
• list_proposals, create_invoice_from_proposal (Schreiben, benötigt mcp:write)
• list_deals
• forecast_cash_flow, get_utilization_report
• preview_month_billing, was die Abrechnung eines Monats entwerfen würde; create_month_invoice_drafts (Schreiben, benötigt mcp:write)

Besprechungen

• list_meetings

Zeit

• log_time_entry (Schreiben, benötigt mcp:write)

Prompts und Ressourcen

Über Tools hinaus bietet der Server vorgefertigte Prompts für die Aufgaben einer Kanzlei (z. B. monatliche Abrechnung, Monatsend-Arbeitsfortschritt, Inkasso, wer überlastet ist oder ein Stand-up) und Ressourcen, die ein Assistent direkt für Kontext lesen kann, wie heutige Besprechungen, ein Wissensdokument oder ein einzelnes Projekt. Beide folgen denselben Berechtigungen wie die Tools.

Die aktuellen Listen sind prompts/list, resources/list und resources/templates/list über das Live-MCP-Protokoll sowie die prompts-, resources- und resourceTemplates-Arrays in der Serverkarte.

Sicherheit

• Jede Antwort trägt den ausgehandelten MCP-Protocol-Version-Header (2026-07-28 oder 2025-11-25).
• Jeder Schreibvorgang wird im Unternehmensaktivitätsprotokoll mit der Person aufgezeichnet, die ihn autorisiert hat.
• Mandantenisolierung: Jede Verbindung ist auf ein einzelnes Unternehmen beschränkt; unternehmensübergreifende Lesevorgänge werden auf der Berechtigungsebene abgelehnt.
• Verschlüsselung: Daten werden bei der Speicherung (AES-256) und während der Übertragung (TLS) verschlüsselt.
• Sensible Inhalte (archiviert, persönliche Sichtbarkeit, feldebene Verschlüsselung) werden niemals über MCP zurückgegeben.
• Ratenbegrenzung: Standardmäßig 1.000 Anfragen pro Stunde und Verbindung, mit höheren ausgehandelten Budgets für Unternehmenskunden. Anonyme Erkennungs- und OAuth-Endpunkte haben eigene niedrigere Pro-IP-Limits, um Missbrauch zu verhindern.