Kollektiv | Your private LLM knowledgebase

Kollektiv MCP

🧠 Ihre persönliche LLM-Wissensdatenbank

Mit Kollektiv MCP können Sie in Sekundenschnelle eine persönliche LLM-Wissensdatenbank erstellen und diese von Ihrem bevorzugten Editor/Client aus nutzen. Kein Infrastrukturaufbau, Chunking oder Synchronisieren mehr – laden Sie einfach Ihre Daten hoch und starten Sie den Chat. Unterstützt alle gängigen MCP-Clients – Cursor, Windsurf, Claude Desktop usw.

🧪 Kollektiv befindet sich in der frühen Betaphase. Sollten Sie Probleme bei der Verbindung zum MCP-Client haben, versuchen Sie zunächst , diese Schritte auszuführen. Sollte dies weiterhin nicht funktionieren, melden Sie bitte hier Ihr Problem.

💿 Verbindung

Die einfachste Möglichkeit, sich mit Kollektiv MCP zu verbinden, besteht darin, die folgende Konfiguration in mcp.json Datei Ihres Editors zu kopieren und einzufügen. Alle Clients (Cursor, Windsurf, Claude Desktop, VSCode, PyCharm) unterstützen dieses json Format.

• Name:
  • kollektiv - Sie können dem Server einen beliebigen beschreibenden Namen geben
• Befehl:
  • npx - stellen Sie sicher, dass Sie node.js installiert haben, bevor Sie diesen Befehl ausführen
• Argumente:
  • -y – dies ermöglicht Ihrer Shell die Installation mcp-remote , das derzeit für die Verbindung mit Remote-Servern erforderlich ist
  • mcp-remote - dies ermöglicht Ihrem Client die Verbindung zu einem Remote-MCP-Server (in diesem Fall Kollektiv)
  • https://mcp.thekollektiv.ai/mcp – ist der Endpunkt, mit dem Sie eine Verbindung herstellen

Sehen Sie sich unten eine kurze Demo an oder lesen Sie kundenspezifische Anweisungen.

Cursor

Öffnen Sie Cursor und gehen Sie zu Cursor Settings > MCP > Add new global MCP Server . Fügen Sie die obige Konfiguration ein und speichern Sie (Strg/Cmd+S).

Wenn die Konfiguration erfolgreich war und Sie sich noch nicht authentifiziert haben, sollte sich ein Browserfenster öffnen, das Sie zur Anmeldeseite führt.

💡Nach dem Speichern der json kann es eine Weile dauern, bis Cursor eine Verbindung zum MCP herstellt. Möglicherweise müssen Sie Cursor neu starten oder ihm etwas Zeit geben. Wenn „Client ist geschlossen“ oder andere Fehler angezeigt werden, können diese Schritte zur Fehlerbehebung hilfreich sein.

Wenn die Verbindung erfolgreich ist, sollte Kollektiv MCP auf der Einstellungsseite grün angezeigt werden:

Windsurf

Öffnen Sie Windsurf und gehen Sie zu Settings -> Windsurf Settings > MCP Servers > View raw config . Fügen Sie die obige Konfiguration ein und speichern Sie (Strg/Cmd+S).

Wenn die Konfiguration erfolgreich war und Sie sich noch nicht authentifiziert haben, sollte sich ein Browserfenster öffnen, das Sie zur Anmeldeseite führt.

💡Windsurf erfordert meiner Erfahrung nach im Gegensatz zu anderen Clients einen Neustart der App, um eine ordnungsgemäße Verbindung herzustellen. Sollte der Server nach einiger Zeit nicht grün werden, versuchen Sie es mit den folgenden Schritten zur Fehlerbehebung .

Wenn die Verbindung erfolgreich hergestellt wurde, sollte Kollektiv MCP auf der Einstellungsseite grün angezeigt werden:

Claude für Desktop

Öffnen Sie Claude Desktop und gehen Sie zu Settings -> Developer > Edit config . Öffnen Sie json Datei in einem beliebigen Text-/Code-Editor, fügen Sie die obige Konfiguration ein und speichern Sie (Strg/Cmd+S).

Wenn die Konfiguration erfolgreich war und Sie sich noch nicht authentifiziert haben, sollte sich ein Browserfenster öffnen, das Sie zur Anmeldeseite führt.

💡Claude für Desktop erfordert einen Neustart der App, um eine ordnungsgemäße Verbindung herzustellen. Sollte der Server nach einiger Zeit nicht grün werden, führen Sie die folgenden Schritte zur Fehlerbehebung durch.

Wenn die Verbindung erfolgreich hergestellt wurde, sollte Kollektiv MCP auf der Einstellungsseite grün angezeigt werden:

VS Code

Öffnen Sie VS Code und gehen Sie zu Settings -> MCP: Add server > Command (stdio) :

• Befehl:
  • npx -y mcp-remote https://mcp.thekollektiv.ai/mcp
• Name:
  • Geben Sie Ihrem Server einen aussagekräftigen Namen, z. B. kollektiv

Ihre settings.json sollten ungefähr so aussehen:

Nächste Schritte:

• Klicken Sie auf „Start“ , um eine Verbindung zum MCP-Server herzustellen
  • Wenn Sie nicht authentifiziert sind, werden Sie zur Authentifizierungsseite weitergeleitet
• Denken Sie daran, "chat.mcp.enabled": true, in Ihrer settings.json hinzuzufügen.
• Wechseln Sie in den Agentenmodus

💡VS Code erfordert, dass Sie Ihren Server manuell starten , chat.mcp.enabled hinzufügen und in den Agentenmodus wechseln, um MCP zu verwenden. Sollten Sie im Agentenmodus keine MCP-Tools sehen, führen Sie die folgenden Schritte zur Fehlerbehebung durch.

Wenn die Verbindung erfolgreich ist, sollten Sie die von Kollektiv MCP angezeigten Tools sehen.

Cline

Öffnen Sie Cline, klicken Sie auf MCP Servers > Edit Configuration und fügen Sie die folgende Konfiguration zu Ihrer cline_mcp_settings.json hinzu:

Hinweis: Direkte Verbindungen zu Remote-Servern, die Autorisierung unterstützen, werden von Cline noch nicht unterstützt.

Wenn die Verbindung erfolgreich hergestellt wurde, werden Sie zum Authentifizierungsprozess weitergeleitet. Nach der Anmeldung sollte Kollektiv MCP in Cline aktiviert sein.

Andere (PyCharm, Claude Code)

Die meisten MCP-Clients folgen demselben .json Format und sollten mit ähnlichen Konfigurationsschritten wie die zuvor erwähnten Clients funktionieren:

1. Kopieren Sie die Konfiguration und fügen Sie sie in die json -Konfiguration Ihres Clients ein
2. Starten Sie die App neu
3. Authentifizieren, falls noch nicht geschehen
4. Kollektiv MCP sollte grün werden und im Chat-/Agentenmodus verfügbar sein

Der Erfolg Ihrer Verbindung hängt von vielen Faktoren ab, unter anderem:

• wie stark Entwickler eines bestimmten Clients MCP-Verbindungen unterstützen wollten
• ob der Client die neueste MCP-Spezifikation mit OAuth-Unterstützung unterstützt

Wenn bei Ihnen Probleme auftreten, kann es hilfreich sein, diese einfachen Schritte zur Fehlerbehebung durchzuführen.

Unterstützte Clients

Ich habe bestätigt, dass die Verbindung zu den folgenden MCP-Clients funktioniert:

• Cursor ✅
• Windsurfen ✅
• Claude Desktop ✅
• VS Code ✅
• Cline ✅

Andere MCP-Clients sollten theoretisch unterstützt werden, in der Praxis kann es aber etwas anders aussehen. Wenn Sie einen Client haben, mit dem Sie sich unbedingt verbinden möchten, lassen Sie es mich wissen!

🎮 Verwendung

Verfügbare Tools

• /query_documents – Stellen Sie eine Frage zu den Dokumenten, die Sie bei Kollektiv hochgeladen haben, und erhalten Sie eine Antwort basierend auf den Quellen aus Ihren Dokumenten.
• /list_documents – Gibt eine Liste Ihrer synchronisierten Dokumente zusammen mit grundlegenden Metadaten zurück.
• Profi-Tipp: Fügen Sie den Satz „Kollektiv MCP verwenden“ ein, damit der Kunde weiß, dass er diese Tools aufrufen muss.

Nutzungstipps

• Fügen Sie immer „use Kollektiv MCP“ hinzu – Dadurch wird dem Client mitgeteilt, welcher MCP-Server verwendet werden soll.
• Warten Sie, bis das Dokument verfügbar ist – Nach dem Hochladen dauert es 1–2 Minuten, bis das Dokument abgefragt werden kann.
• Formulieren Sie Abfragen bei Bedarf um – Wenn der Client eine schlechte Abfrage generiert, bearbeiten oder schreiben Sie sie selbst neu.

❓ Fehlerbehebung und Support

Dieser MCP-Server nutzt das Cloudflare Agents SDK sowie weitere Bibliotheken, um Benutzern die modernste Möglichkeit zur Verbindung mit MCP-Servern und deren Nutzung zu bieten. MCP-Clients hingegen müssen die Unterstützung für die beiden wichtigsten Komponenten noch implementieren:

• Remote-MCP-Server
• MCP-Serverautorisierung

Falls Verbindungsprobleme auftreten, führen Sie bitte die folgenden Schritte zur Fehlerbehebung durch, die Ihnen bei der Verbindung mit dem MCP-Server helfen sollten.

Unterstützung

Wenn Sie zusätzliche Unterstützung benötigen, öffnen Sie bitte ein GitHub-Problem oder wenden Sie sich an support@thekollektiv.ai

Verbindungsfehlerbehebung

Wenn Sie die Fehlermeldung „Ungültige Autorisierungsanforderung“ wie unten angezeigt erhalten oder aus einem anderen Grund keine Verbindung herstellen können, versuchen Sie, die folgenden Schritte auszuführen, um das Problem zu beheben.

1. Stellen Sie sicher, dass Sie eine Verbindung zum richtigen Endpunkt herstellen :
   • Verwenden Sie https://mcp.thekollektiv.ai/mcp als MCP-Endpunkt.
2. MCP-Remote-Cache leeren :
   • Was dies bewirkt:
     • Entfernt den Cache der mcp-remote -Bibliothek, die zum Herstellen einer Verbindung mit dem Remote-Server von einem Client aus verwendet wird, der keine Remote-Verbindungen unterstützt.
   • Wie:
     • Führen Sie den folgenden Befehl in Ihrem Terminal aus

3. Löschen Sie Ihre Browserdaten und Cookies :
   • Was dies bewirkt:
     • Entfernt Browser-Cookies, die zum Speichern von Authentifizierungsinformationen beim Anmelden bei Kollektiv verwendet werden.
   • Wie:
     • Öffnen Sie Ihre Browsereinstellungen und löschen Sie die Browserdaten der letzten Stunden

⚠️ Hinweis: Dadurch werden Sie von allen aktiven Sitzungen abgemeldet, einschließlich Kollektiv. Tun Sie dies nur, wenn Sie in einem unterbrochenen Anmeldevorgang feststecken.

4. Starten Sie Ihren MCP-Client neu und versuchen Sie, die Verbindung zum MCP-Server wiederherzustellen:
   • Was dies bewirkt:
     • MCP-Clients (Cursor, Windsurf usw.) speichern häufig Verbindungs-/Konfigurationseinstellungen aus vorherigen Ausführungen im Cache, was die Authentifizierung beeinträchtigen könnte.
   • Wie:
     • Starten Sie Ihren Editor/Client neu
     • Versuchen Sie, die Verbindung zum MCP-Server wiederherzustellen

Verwenden des MCP-Inspektors

Zu Debugzwecken können Sie den MCP Inspector verwenden, um eine Verbindung zum Kollektiv MCP-Server herzustellen.

Wählen Sie entweder SSE oder Streamable HTTP-Transport

• SSE: Verbinden Sie sich mit dem Server unter https://mcp.thekollektiv.ai/sse
• Streambares HTTP: Verbindung zum Server unter https://mcp.thekollektiv.ai/mcp

🛠️ Implementierungsdetails (für das 🤓)

Wenn Sie nur wegen Kollektiv hier sind, überspringen Sie diesen Abschnitt. Dieser Abschnitt richtet sich an Entwickler und Entwickler, die wissen möchten, wie es funktioniert.

Kollektiv MCP ist Teil eines modularen Systems, das es Benutzern ermöglicht, RAG in Sekundenschnelle über ihre Daten einzurichten – ohne dass sie Infrastruktur, Pipelines oder Modellkonfigurationen verwalten müssen.

Es besteht aus drei unabhängig voneinander bereitgestellten Diensten:

• MCP-Server (Cloudflare Worker)
  https://mcp.thekollektiv.ai
  Fungiert als sicheres Gateway für Clients zur Interaktion mit indizierten Daten über das Model Context Protocol. Unterstützt OAuth.
• Frontend (React + Vite Worker)
  https://thekollektiv.ai
  Eine übersichtliche, minimalistische Benutzeroberfläche zum Hochladen und Verwalten Ihrer Inhalte.
• Backend (FastAPI)
  https://api.thekollektiv.ai
  Behandelt die Quellenaufnahme, Validierung und Orchestrierung einer RAG-Pipeline.

🔐 Sicherheit

Kollektiv MCP implementiert mehrere Sicherheitsmaßnahmen:

• Die Anmeldung erfolgt über den standardmäßigen OAuth 2.1 „Authorization Code“-Flow von Supabase. Es werden nur kurzlebige, Secure``HttpOnly -Cookies gespeichert – Passwörter kommen nie mit diesem Server in Berührung.
• Der gesamte Datenverkehr wird ausschließlich über HTTPS über Cloudflares Edge abgewickelt und jede sensible POST-Anfrage enthält ein einmaliges CSRF-/Transaktionstoken.
• Das Backend läuft innerhalb der Cloudflare Workers-Sandbox (kein lokales Dateisystem, keine lang laufenden Prozesse), wodurch die Angriffsfläche drastisch reduziert wird.Ausführliche Offenlegungsrichtlinien finden Sie unter SECURITY.md .

🪪 Lizenz

Veröffentlicht unter der Apache-Lizenz 2.0 – kommerzieller Support oder alternative Lizenzierung: azuev@outlook.com