
Ein MCP-Server ist ein Programm, das einer KI-Anwendung ausgewählte Daten und Werkzeuge über das Model Context Protocol (MCP) bereitstellt. Damit kann ein Assistent beispielsweise Projektnotizen suchen oder eine freigegebene Funktion ausführen. Welche Inhalte er erreicht und welche Aktionen erlaubt sind, bestimmen der Server, die Anmeldung und die vergebenen Rechte.
Sie suchen eine Entscheidung aus dem letzten Projektmeeting. Ein Teil steht im Protokoll, ein anderer auf dem Whiteboard. Ein angebundener Assistent kann relevante Stellen abrufen und für eine Antwort zusammenführen. Sie sollten anschließend erkennen können, welche Quelle die Aussage trägt. Genau an diesem Ablauf lässt sich MCP sinnvoll erklären und prüfen.
MCP steht für Model Context Protocol. Das offene Protokoll beschreibt den Austausch zwischen einer KI-Anwendung und externen Systemen. Statt für jede Kombination aus Assistent und Fachanwendung eine vollständig eigene Verbindung zu entwickeln, können beide Seiten eine gemeinsame Schnittstelle verwenden.
Der Server ist die Software auf der Seite der Datenquelle oder des Werkzeugs. Er stellt beispielsweise eine Suchfunktion bereit und beschreibt deren Eingaben. Er ist weder das Sprachmodell noch zwingend ein zusätzlicher Computer: Auch ein lokaler Prozess kann ein MCP-Server sein. Die offizielle MCP-Architekturübersicht erläutert diese Aufteilung.
Ein konkretes Beispiel ist der eingebaute MCP Server von AFFiNE (Produktübersicht auf Englisch). Er verbindet unterstützte KI-Clients mit einem AFFiNE-Workspace. Eine gesonderte Community-Erweiterung ist dafür nicht nötig; der eingesetzte AFFiNE-Server muss die Funktion allerdings unterstützen und aktiviert haben.
Wann lohnt sich MCP? Wenn Sie regelmäßig dieselben freigegebenen Quellen für KI-Aufgaben benötigen. Für die einmalige Zusammenfassung eines unkritischen Textes kann das direkte Einfügen ausreichen. Eine zusätzliche Integration bringt immer auch Einrichtung und Rechteverwaltung mit sich.
Drei Rollen gehören zusammen:
| Rolle | Aufgabe | Beispiel |
|---|---|---|
| Host | Die Anwendung, in der Sie mit dem Assistenten arbeiten | Claude Code oder ein KI-Editor |
| MCP-Client | Der Verbindungsteil innerhalb des Hosts | Fragt verfügbare Werkzeuge ab und übermittelt Aufrufe |
| MCP-Server | Stellt zugelassene Funktionen oder Daten bereit | Sucht in einem Workspace und liefert Fundstellen |
Ein typischer Suchablauf besteht aus vier Schritten:
tools/list kann er verfügbare Tools und deren Eingaben abfragen.
Ein Server muss nicht sämtliche Fähigkeiten anbieten. Die Spezifikation unterscheidet unter anderem:
Diese drei Referenzen beziehen sich auf die Spezifikation vom 25. November 2025. Bei einer konkreten Verbindung zählt, welche Protokollversion und Fähigkeiten beide Seiten unterstützen. Ein Suchergebnis kann auch über ein Tool geliefert werden; dafür muss der Server keine eigene Ressourcen-Schnittstelle anbieten.
| Verbindung | Wie sie arbeitet | Was Sie prüfen sollten |
|---|---|---|
| stdio | Der Client startet meist einen lokalen Prozess und kommuniziert über dessen Standardein- und -ausgabe | Herkunft des Programms, Startbefehl, Laufzeitumgebung und Dateirechte |
| Streamable HTTP | Der Client spricht einen laufenden Dienst über einen HTTP-Endpunkt an | HTTPS, Erreichbarkeit, unterstützte Version und Authentifizierung |
Die Transport-Spezifikation beschreibt beide Wege. Ältere Anleitungen nennen noch einen separaten HTTP+SSE-Transport. Prüfen Sie deshalb die aktuelle Dokumentation Ihres Servers, bevor Sie eine Konfiguration übernehmen. Ein lokal laufender MCP-Server bedeutet außerdem nicht, dass das verwendete Sprachmodell lokal läuft.
Besonders nachvollziehbar ist der Nutzen bei klar eingegrenzten Aufgaben:
Bei der Auswahl helfen konkrete Fragen stärker als die Länge einer Serverliste:
| Ausgangslage | Passender Ansatz | Entscheidende Prüfung |
|---|---|---|
| Ihr Team arbeitet mit Notion | Den zum Workspace passenden Notion-MCP-Zugang prüfen | Anmeldung, freigegebene Inhalte und verfügbare Funktionen |
| Ihr Wissen liegt in Dokumenten und Whiteboards von AFFiNE | Den eingebauten Workspace-Endpunkt verwenden | Suchabdeckung, Dokumentrechte und freigeschalteter Funktionsumfang |
| Ihr Wissen liegt in lokalen Dateien | Einen passenden Datei-Server mit engem Verzeichniszugriff wählen | Welche Ordner der Prozess lesen oder verändern darf |
| Sie müssen ein internes Fachsystem anbinden | Einen bestehenden Server prüfen oder eine begrenzte Integration bauen | Wartungsverantwortung, API-Rechte und erlaubte Aktionen |
Die englische AFFiNE-Produktübersicht in der Tabelle beschreibt den Einstieg. Wenn Sie zunächst die Wissensplattform auswählen, vergleichen Sie Wissensmanagement-Tools für Unternehmen. MCP allein löst weder veraltete Inhalte noch unklare Zuständigkeiten. Für die Bewertung von Hosting und Zusammenarbeit hilft außerdem unser Vergleich der Notion-Alternativen für Teams und Datenhoheit.
| Begriff | Beantwortet vor allem diese Frage | Beispiel im Wissensmanagement |
|---|---|---|
| API | Wie spricht Software einen bestimmten Dienst an? | Eine Anwendung ruft ein Dokument über eine Dienstschnittstelle ab |
| MCP | Wie stellt ein System einem kompatiblen KI-Client Funktionen und Kontext bereit? | Der Client entdeckt ein Such-Tool und ruft es auf |
| RAG | Wie werden relevante Informationen vor der Antwort beschafft und als Kontext genutzt? | Eine Suche liefert passende Absätze für eine belegte Antwort |
Die Ansätze können zusammenarbeiten: Eine API liefert Inhalte, eine Suchkomponente wählt relevante Passagen aus, und ein MCP-Tool macht diese Suche für den Assistenten erreichbar. MCP ersetzt weder Ihre Fachschnittstellen noch die Qualität der Suche. Ein schlecht gepflegtes Dokument bleibt auch über eine standardisierte Verbindung eine schlechte Quelle.
Prüfstand: 23. September 2026. Für diesen Abschnitt wurde der öffentliche AFFiNE-Quellcode im Canary-Stand ca0ffc52f7 geprüft. Das belegt die Implementierung dieses Stands, nicht die Auslieferung jeder Funktion in jeder Cloud- oder Self-Hosting-Version. Die folgenden Aussagen sind eine Quellcodeprüfung, kein durchgeführter Produktbenchmark.
Der MCP-Provider dieses Repository-Stands definiert zwei grundlegende Lesewerkzeuge:
| Werkzeug | Was es bereitstellt | Grenze |
|---|---|---|
doc_search | Begrenzte Textpassagen mit Dokument-ID, Titel und gegebenenfalls Block-, Element- oder Frame-ID | Durchsucht gespeicherte Workspace-Dokumente; keine Dateien, Blobs, Anhänge oder Webseiten |
read_document | Markdown-Inhalt eines Dokuments anhand seiner ID | Prüft die Leseberechtigung für dieses Dokument |
Für Whiteboards ist die Unterscheidung wichtig: Texttreffer mit Canvas-Position sind keine allgemeine Bilderkennung und keine vollständige Interpretation eines Diagramms. Öffnen Sie die betreffende Stelle, wenn Anordnung, Pfeile oder visuelle Details für die Aussage entscheidend sind.
Die Suchimplementierung kombiniert lexikalische und vektorbasierte Suche, soweit diese verfügbar sind. Die Antwort kann einen eingeschränkten Suchmodus und einen Ausfallgrund ausweisen. „Semantische Suche“ sollte daher nicht als Garantie verstanden werden, dass jede Formulierung jeden Inhalt findet.
Für verlässliche Ergebnisse lohnt sich bereits bei der Erstellung eine klare technische Dokumentation mit Kontext und Zuständigkeiten. Ein eindeutiger Titel, ein Datum und nachvollziehbare Entscheidungen erleichtern Menschen und Suchsystemen die Arbeit.
Die Verbindung ist an einen Workspace und einen Benutzer gebunden. Die Implementierung prüft Workspace- und Dokumentrechte; ein MCP-Zugang ist kein pauschaler Zugriff auf alle Workspaces. Neue Zugangsdaten verwenden standardmäßig den Modus Read only.
Im geprüften Stand sind create_document, update_document und update_document_meta nur verfügbar, wenn der Zugang Schreibrechte hat und die Umgebung als Entwicklung oder Canary läuft. Auch die Erstellung eines Schreibzugangs wird außerhalb dieser Umgebungen abgewiesen. Das ist in Provider und Freigabeprüfung nachvollziehbar. Planen Sie einen produktiven Ablauf deshalb zunächst mit Suche und Lesen; maßgeblich sind die Werkzeuge, die Ihr eigener Server tatsächlich anbietet.
Auf einer selbst gehosteten Instanz (Informationen auf Englisch) liegt der Endpunkt unter Ihrer Serveradresse. Der MCP-Controller verwendet POST /api/workspaces/{workspace-id}/mcp und ist an aktivierte Copilot-Funktionen gebunden. Self-Hosting braucht somit eine passende Version und Konfiguration. Abgerufene Texte können anschließend trotzdem an den Modellanbieter Ihres Clients gelangen.
Für diesen Einstieg benötigen Sie einen unterstützten AFFiNE-Workspace, Zugriff auf dessen Integrationseinstellungen und einen Client, der den Endpunkt samt Bearer-Authentifizierung unterstützt. Verwenden Sie für den ersten Versuch unkritische Testinhalte.
Für Claude Code sieht das Befehlsmuster so aus. Die Werte in spitzen Klammern sind Platzhalter:
claude mcp add --transport http affine \
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp" \
--header "Authorization: Bearer <mcp-zugangstoken>"
In einer Claude-Code-Sitzung zeigt /mcp den Verbindungsstatus. Die offizielle Claude-Code-Dokumentation beschreibt HTTP-Verbindungen und die Verwaltung der Server. Beachten Sie, dass ein direkt eingegebenes Token in der Shell-Historie landen kann. Für gemeinsam genutzte Konfigurationen sollten Sie die vom Client unterstützte Übergabe über Umgebungsvariablen nutzen.
Weitere Befehle, Konfigurationsbereiche und Diagnosewege finden Sie in unserer deutschen Anleitung zur MCP-Einrichtung in Claude Code. Prüfen Sie bei anderen Clients gesondert die Authentifizierung: Eine Oberfläche, die ausschließlich OAuth anbietet, akzeptiert nicht automatisch einen beliebigen Bearer-Header.
Die folgende Testvorlage ist zum eigenen Nachvollziehen gedacht; sie beschreibt keine bereits gemessenen Ergebnisse:
Dieser kleine Ablauf prüft mehr als eine grüne Verbindungsanzeige: Er macht Suchabdeckung, Quellenbezug und den Entzug des Zugriffs sichtbar. Für sensible Projekte sollten Sie zusätzlich mit getrennten Testkonten kontrollieren, dass nicht freigegebene Dokumente unerreichbar bleiben.
| Beobachtung | Was Sie zuerst prüfen sollten |
|---|---|
| Der Server verbindet sich nicht | URL, Netzwerkzugriff, HTTPS, Transport und eine von beiden Seiten unterstützte Protokollversion |
| Die Anmeldung schlägt fehl | Vollständiger Bearer-Header, richtiger Workspace sowie Ablauf oder Widerruf des Tokens |
| Der Endpunkt zeigt beim Öffnen im Browser „Method not allowed“ | Ein Browseraufruf verwendet gewöhnlich GET. Der geprüfte AFFiNE-Endpunkt verarbeitet MCP über POST; ein GET-Fehler allein beweist keinen Defekt |
| Die Verbindung steht, aber es fehlen Treffer | Inhalt gespeichert, richtiges Dokument beziehungsweise Workspace, Leserechte, genauer Suchbegriff und Suchindex verfügbar? |
| Dokumente werden gefunden, Anhänge nicht | doc_search deckt im geprüften Stand keine Anhänge ab |
| Lesen funktioniert, Schreiben nicht | Zugangsmodus und Serverumgebung prüfen; die geprüften Schreibwerkzeuge sind auf Entwicklung und Canary begrenzt |
Der GET-/POST-Unterschied und die Protokollversionen lassen sich im oben verlinkten Controller nachprüfen. Installieren Sie nicht wahllos weitere Server, wenn die eigentliche Ursache ein abgelaufener Zugang oder eine fehlende Berechtigung ist.
MCP ist kein Datenschutzsiegel. Bewerten Sie den gesamten Datenweg: Quelle → MCP-Server → Client → Modellanbieter. Auch bei einem selbst gehosteten Wissensspeicher können abgerufene Inhalte an einen externen KI-Dienst übermittelt werden.
Vor dem Einsatz mit personenbezogenen Daten sollten Verantwortliche insbesondere Zweck und Rechtsgrundlage, notwendige Daten, Empfänger, Speicherfristen, erforderliche Auftragsverarbeitungsverträge und gegebenenfalls Drittlandübermittlungen prüfen. Die Orientierungshilfe „Künstliche Intelligenz und Datenschutz“ der Datenschutzkonferenz bietet dafür eine deutsche behördliche Grundlage. Die konkrete Bewertung hängt von Ihrem Einsatz und den beteiligten Diensten ab.
Für die technische Einrichtung sind vier Maßnahmen besonders relevant:
Das OWASP MCP Security Cheat Sheet erläutert diese technischen Risiken und Schutzmaßnahmen. Die Herkunft vom offiziellen Anbieter erleichtert die Prüfung der Verantwortlichkeiten; sie ersetzt keine Prüfung der konkreten Integration.
Ein MCP-Server verbindet eine KI-Anwendung über eine gemeinsame Schnittstelle mit bestimmten Daten oder Funktionen. Er kann beispielsweise ein Werkzeug zum Durchsuchen von Notizen bereitstellen. Welche Inhalte erreichbar sind, hängt von der Implementierung und den Zugriffsrechten ab.
Nur wenn Sie einen lokalen Server selbst betreiben möchten. Bei einem gehosteten oder bereits im Produkt eingebauten Endpunkt konfigurieren Sie normalerweise Adresse und Anmeldung im Client. Ob zusätzliche Software nötig ist, hängt vom unterstützten Transport und Anmeldeverfahren ab.
MCP ist ein offenes Protokoll. Daraus folgt kein kostenloser Gesamtbetrieb: Kosten können für die KI-Anwendung, Modellnutzung, verbundene Dienste oder das Hosting entstehen. Prüfen Sie die aktuellen Konditionen Ihrer Kombination, statt vom Protokoll auf den Preis zu schließen.
Ja, wenn der Server entsprechende Werkzeuge anbietet und die nötigen Rechte erteilt sind. Im hier geprüften AFFiNE-Quellcode ist Lesen der Standard; Schreibwerkzeuge sind zusätzlich auf Entwicklungs- und Canary-Umgebungen begrenzt. Ein vorhandener MCP-Zugang bedeutet daher nicht automatisch Schreibzugriff.
Das lässt sich nicht pauschal zusagen. Der Client muss den verwendeten Transport, eine passende Protokollversion und die Authentifizierung unterstützen. Insbesondere ist ein Bearer-Header nicht mit einer OAuth-Anmeldung gleichzusetzen. Prüfen Sie die Dokumentation Ihrer konkreten Client-Version.
Nein. Self-Hosting bestimmt, wo der betreffende Dienst betrieben wird. Für die datenschutzrechtliche Bewertung zählt der gesamte Verarbeitungsvorgang, einschließlich der an Client und Modellanbieter übermittelten Daten, Verträge und Zugriffsrechte.
Die geprüfte Suche kann textliche Whiteboard-Inhalte mit Element- oder Frame-Verweisen zurückgeben. Dateien und Anhänge sind ausdrücklich nicht Teil von doc_search. Rechnen Sie deshalb nicht mit einer vollständigen Durchsuchung hochgeladener PDFs oder mit einer automatischen Interpretation aller Bilder und Diagramme.
Beginnen Sie mit einem überschaubaren Workspace und einer Frage, deren Antwort Sie nachprüfen können. Kontrollieren Sie Fundstellen, Berechtigungen und den Widerruf, bevor Sie die Anbindung im Team ausweiten. Liegt Ihr Projektwissen bereits in Dokumenten und auf Whiteboards, verbinden Sie zuerst Ihre Wissensbasis (Einrichtungshinweise auf Englisch).
Redaktioneller Hinweis: Dieser Beitrag wird von AFFiNE veröffentlicht und verwendet das eigene Produkt als Praxisbeispiel. Produktangaben wurden am 23. September 2026 anhand der verlinkten, auf einen Commit festgelegten Quellcodedateien geprüft. Die Testvorlage ist eine Anleitung zur eigenen Überprüfung; Ergebnisse, Erfolgsquoten oder eine unabhängige Zertifizierung werden damit nicht behauptet.