Nexian MCP Hub

Nexian MCP Hub ist eine Multi-Mandanten-MSP-Integrationsplattform, die es jedem Mandanten ermöglicht, Drittanbietersysteme zu verbinden und normalisierte, KI-sichere Tools über einen einzigen Remote-MCP-Server bereitzustellen.

Monorepo-Struktur

• apps/web: Next.js Admin- und Endbenutzer-App

• apps/api: Backend-API für Authentifizierung, Mandantenverwaltung, Konnektoren, OAuth-Callbacks und Audit-APIs

• apps/mcp: Remote-MCP-Server mit durch Bearer-Token geschützten HTTP-Endpunkten

• packages/core: Gemeinsame Domänentypen, Sicherheitsprimitive, MCP-Modelle, Validierungshilfen

• packages/connectors: Anbieter-Adapter und Implementierungen normalisierter Tools

• prisma: Postgres-Schema und Modelle für Seed-Daten

• docker: Lokale Container-Assets

• docs: Architektur-, Bereitstellungs- und Sicherheitshinweise

Lokale Einrichtung

1. Installieren Sie Node.js 22+ und pnpm.

2. Kopieren Sie .env.example nach .env und tragen Sie die Anmeldedaten der Anbieter ein.

3. Starten Sie die Infrastruktur:

docker compose up -d

4. Installieren Sie die Abhängigkeiten:

pnpm install

5. Generieren Sie den Prisma-Client und führen Sie die Migrationen aus:

pnpm db:generate
pnpm db:migrate

6. Starten Sie den Stack:

pnpm dev

Vercel-Bereitstellung

Stellen Sie die apps/web Next.js-App als Vercel-Projekt bereit.

Empfohlene Vercel-Einstellungen:

• Root-Verzeichnis: apps/web

• Installationsbefehl: pnpm install

• Build-Befehl: pnpm build

• Ausgabeverzeichnis: leer lassen für die automatische Erkennung durch Next.js

In Vercel zu setzende Umgebungsvariablen:

• NEXT_PUBLIC_API_URL

• NEXT_PUBLIC_MCP_URL

• API_URL

• APP_URL

Dieses Repository hält apps/api und apps/mcp als separate Node-Dienste. Für die Produktion stellen Sie diese auf einem Container-Host bereit und verweisen das Vercel-Frontend über Umgebungsvariablen darauf.

Railway-Bereitstellung

Verwenden Sie Railway für die Backend-Aufteilung:

• apps/api auf Railway

• apps/mcp auf Railway

• apps/web auf Vercel

Der praktische Einrichtungsleitfaden befindet sich unter:

• docs/railway-vercel-deploy.md

Wichtige Beziehungen der Produktionsumgebung:

• APP_URL sollte Ihre Vercel-Web-URL sein

• API_URL sollte Ihre Railway-API-URL sein

• MCP_URL sollte Ihre Railway-MCP-URL sein

• HALOPSA_REDIRECT_URI sollte auf die Callback-URL der Railway-API zeigen

• NEXT_PUBLIC_API_URL in Vercel sollte auf die Railway-API-URL zeigen

• NEXT_PUBLIC_MCP_URL in Vercel sollte auf die Railway-MCP-Endpunkt-URL zeigen

• SESSION_SECRET muss zwischen den API- und MCP-Diensten übereinstimmen

Produktarchitektur

• Web-Benutzer authentifizieren sich bei der Plattform und agieren innerhalb eines Mandanten-Arbeitsbereichs.

• Verbundene Konten werden pro Mandant und Benutzer gespeichert, wobei Zugriffs- und Aktualisierungs-Token im Ruhezustand verschlüsselt sind.

• Die API ist zuständig für die Handhabung von OAuth-Callbacks, Token-Aktualisierung, Richtlinienprüfungen, Audit-Logging und den Konnektor-Lebenszyklus.

• Der MCP-Server validiert Authorization: Bearer <token> bei jeder HTTP-Anfrage und leitet jeden Tool-Aufruf durch mandantenbezogene Richtlinien.

• Anbieterspezifische Logik verbleibt in den Adaptern; nur normalisierte Tools werden extern bereitgestellt.

Umfang der Version 1 Konnektoren

• HaloPSA

• Microsoft 365 / SharePoint

• HubSpot als CRM

• IT Glue als Dokumentation / KB

Leitplanken

• Zuerst leselastige Tools

• Sichere Schreibvorgänge nur für Workflows mit geringem Risiko, wie das Erstellen von Ticket-Entwürfen und internen Notizen

• Keine destruktiven Schreibvorgänge in v1

• Alle Tool-Aufrufe generieren Audit-Ereignisse

Nächste Implementierungsmeilensteine

1. Echte Authentifizierung und Persistenz in die API-Modul-Skelette integrieren.

2. Prisma-Migrationen und Datenbank-Client-Bootstrapping hinzufügen.

3. Konnektor-Platzhalter durch Live-Anbieter-SDKs oder REST-Integrationen ersetzen.

4. Integrationstests für OAuth, Token-Aktualisierung und MCP-Tool-Ausführung hinzufügen.