Alle Beiträge
AFFiNE
Toeverything·Veröffentlicht 19. Aug. 2026 · Aktualisiert 23. Sept. 2026
Dokumente und Whiteboards, über einen MCP-Anschluss mit einem KI-Assistenten verbunden

Was ist ein MCP-Server? Erklärung, Beispiele & Einrichtung

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.

Das Wichtigste in Kürze

  • MCP ist die gemeinsame Schnittstelle; der MCP-Server stellt konkrete Funktionen bereit. Ein Server kann lokal auf Ihrem Rechner oder bei einem Anbieter laufen.
  • Der Nutzen: weniger Kopieren zwischen Wissensdatenbank und KI-Chat, dafür gezielter Zugriff auf die benötigten Quellen.
  • Die Grenzen: MCP garantiert weder richtige Antworten noch Datenschutz. Protokollversion, Transport und Anmeldung müssen zum Client passen.
  • Das Praxisbeispiel: AFFiNE stellt Suche und Dokumentabruf bereit. Die geprüfte Implementierung begrenzt Schreibwerkzeuge auf Entwicklungs- und Canary-Umgebungen.

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.

Was bedeutet MCP – und wozu braucht man einen Server?

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.

Wie funktioniert MCP? Host, Client und Server

Drei Rollen gehören zusammen:

RolleAufgabeBeispiel
HostDie Anwendung, in der Sie mit dem Assistenten arbeitenClaude Code oder ein KI-Editor
MCP-ClientDer Verbindungsteil innerhalb des HostsFragt verfügbare Werkzeuge ab und übermittelt Aufrufe
MCP-ServerStellt zugelassene Funktionen oder Daten bereitSucht in einem Workspace und liefert Fundstellen

Ein typischer Suchablauf besteht aus vier Schritten:

  1. Verbinden: Der Client verwendet die konfigurierte Serveradresse beziehungsweise den lokalen Startbefehl und die erforderliche Anmeldung.
  2. Werkzeuge ermitteln: Über tools/list kann er verfügbare Tools und deren Eingaben abfragen.
  3. Aufgabe ausführen: Der Assistent schlägt einen passenden Aufruf vor. Der Host übermittelt ihn nach seinen Freigaberegeln; der Server prüft den Zugriff.
  4. Antwort prüfen: Das Ergebnis fließt in die Antwort ein. Die Fundstellen bleiben entscheidend, denn auch mit abgerufenen Daten kann ein Modell etwas falsch zusammenfassen.
Ablauf vom KI-Host über einen MCP-Client und MCP-Server zu getrennten Tools und Datenquellen
MCP vereinheitlicht die Verbindung, während die Zugriffsgrenzen jedes Servers für Tools und Daten bestehen bleiben.

Tools, Ressourcen und Prompts

Ein Server muss nicht sämtliche Fähigkeiten anbieten. Die Spezifikation unterscheidet unter anderem:

  • Tools: aufrufbare Funktionen, etwa „Dokument suchen“. Ein Tool kann nur lesen oder Daten verändern; der Name allein sagt nichts über seine Rechte aus.
  • Ressourcen: Inhalte, die eine Anwendung als Kontext abrufen kann, etwa eine Datei oder ein Schema.
  • Prompts: angebotene Vorlagen für wiederkehrende Aufgaben.

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.

Lokal oder remote: stdio und Streamable HTTP

VerbindungWie sie arbeitetWas Sie prüfen sollten
stdioDer Client startet meist einen lokalen Prozess und kommuniziert über dessen Standardein- und -ausgabeHerkunft des Programms, Startbefehl, Laufzeitumgebung und Dateirechte
Streamable HTTPDer Client spricht einen laufenden Dienst über einen HTTP-Endpunkt anHTTPS, 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.

Beispiele: Wofür sind MCP-Server nützlich?

Besonders nachvollziehbar ist der Nutzen bei klar eingegrenzten Aufgaben:

  • Projektwissen finden: Der MCP Server von AFFiNE (auf Englisch) kann gespeicherte Workspace-Inhalte durchsuchen und Dokumente abrufen. Damit lassen sich beispielsweise ein Meetingprotokoll und textliche Whiteboard-Inhalte gemeinsam recherchieren.
  • Entwicklungsarbeit vorbereiten: Ein Repository-Server kann freigegebene Issues oder Quelltexte für eine Analyse zugänglich machen.
  • Betriebsfragen beantworten: Ein entsprechend eingerichteter Datenbank- oder Monitoring-Server kann ausgewählte Abfragen anbieten. Eine Auswertung benötigt nicht automatisch Schreibrechte.

Bei der Auswahl helfen konkrete Fragen stärker als die Länge einer Serverliste:

AusgangslagePassender AnsatzEntscheidende Prüfung
Ihr Team arbeitet mit NotionDen zum Workspace passenden Notion-MCP-Zugang prüfenAnmeldung, freigegebene Inhalte und verfügbare Funktionen
Ihr Wissen liegt in Dokumenten und Whiteboards von AFFiNEDen eingebauten Workspace-Endpunkt verwendenSuchabdeckung, Dokumentrechte und freigeschalteter Funktionsumfang
Ihr Wissen liegt in lokalen DateienEinen passenden Datei-Server mit engem Verzeichniszugriff wählenWelche Ordner der Prozess lesen oder verändern darf
Sie müssen ein internes Fachsystem anbindenEinen bestehenden Server prüfen oder eine begrenzte Integration bauenWartungsverantwortung, 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.

MCP, API und RAG: Was ist der Unterschied?

BegriffBeantwortet vor allem diese FrageBeispiel im Wissensmanagement
APIWie spricht Software einen bestimmten Dienst an?Eine Anwendung ruft ein Dokument über eine Dienstschnittstelle ab
MCPWie stellt ein System einem kompatiblen KI-Client Funktionen und Kontext bereit?Der Client entdeckt ein Such-Tool und ruft es auf
RAGWie 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.

AFFiNE MCP: Funktionen und Grenzen aus dem Quellcode

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.

Suche und Dokumentabruf

Der MCP-Provider dieses Repository-Stands definiert zwei grundlegende Lesewerkzeuge:

WerkzeugWas es bereitstelltGrenze
doc_searchBegrenzte Textpassagen mit Dokument-ID, Titel und gegebenenfalls Block-, Element- oder Frame-IDDurchsucht gespeicherte Workspace-Dokumente; keine Dateien, Blobs, Anhänge oder Webseiten
read_documentMarkdown-Inhalt eines Dokuments anhand seiner IDPrü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.

Rechte, Schreibzugriff und Self-Hosting

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.

Einen MCP-Server einrichten: Beispiel mit AFFiNE

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.

  1. Den richtigen Workspace öffnen. Wechseln Sie in dessen Einstellungen zu Integrationen und MCP Server. Fehlt der Bereich, prüfen Sie die eingesetzte Version und die aktivierten Serverfunktionen.
  2. Eigene Zugangsdaten erstellen. Vergeben Sie einen eindeutigen Namen, beispielsweise „Claude Code – Arbeitsrechner“. Beginnen Sie mit Read only und wählen Sie eine passende Laufzeit. Ein eigener Zugang pro Client erleichtert später den Widerruf.
  3. Konfiguration übernehmen. Die Oberfläche zeigt das neue Token an und bietet „Copy JSON“. Behandeln Sie die kopierte Konfiguration wie ein Passwort. Teilen Sie sie nicht in Tickets oder einem öffentlichen Repository.
  4. Im Client passend eintragen. Übernehmen Sie URL und Authentifizierungsdaten; prüfen Sie das vom Client erwartete JSON-Format. Ein gemeinsames Protokoll bedeutet nicht, dass alle Clients dieselben Konfigurationsschlüssel oder Anmeldeverfahren akzeptieren.
  5. Verbindung und Werkzeuge prüfen. Kontrollieren Sie den Status und die tatsächlich angebotenen Tools. Erst danach stellen Sie die erste inhaltliche Frage.

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.

Ein nachvollziehbarer Funktionstest

Die folgende Testvorlage ist zum eigenen Nachvollziehen gedacht; sie beschreibt keine bereits gemessenen Ergebnisse:

  1. Legen Sie in einem Test-Workspace ein Dokument „Projekt Linde – Übergabe“ mit dem Satz „Die Übergabe ist am 14. Oktober“ an.
  2. Ergänzen Sie auf einem Whiteboard eine Textnotiz: „Offener Punkt: Freigabe der Checkliste“. Warten Sie, bis die Inhalte gespeichert und für die Suche verfügbar sind.
  3. Fragen Sie: „Suche in meinem AFFiNE-Workspace nach Projekt Linde. Nenne den Übergabetermin und offene Punkte. Gib für jede Aussage die Fundstelle an. Wenn etwas nicht gefunden wird, sage das ausdrücklich.“
  4. Öffnen Sie die gefundenen Dokumente beziehungsweise Canvas-Stellen und vergleichen Sie die Antwort mit den Originalen. Prüfen Sie bei fehlenden Treffern zuerst eine wörtliche Suche.
  5. Widerrufen Sie den Testzugang in AFFiNE und lösen Sie einen neuen Abruf aus. Der neue Zugriff muss scheitern. Bereits im Chat vorhandene Texte werden durch den Widerruf nicht nachträglich gelöscht.

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.

Häufige Probleme bei der Einrichtung

BeobachtungWas Sie zuerst prüfen sollten
Der Server verbindet sich nichtURL, Netzwerkzugriff, HTTPS, Transport und eine von beiden Seiten unterstützte Protokollversion
Die Anmeldung schlägt fehlVollstä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 TrefferInhalt gespeichert, richtiges Dokument beziehungsweise Workspace, Leserechte, genauer Suchbegriff und Suchindex verfügbar?
Dokumente werden gefunden, Anhänge nichtdoc_search deckt im geprüften Stand keine Anhänge ab
Lesen funktioniert, Schreiben nichtZugangsmodus 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.

Sicherheit und Datenschutz: Was deutsche Teams prüfen sollten

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:

  • Zugriff begrenzen: Nur benötigte Quellen freigeben, mit Leserechten beginnen und Änderungen gezielt bestätigen lassen.
  • Zugänge trennen: Pro Client eigene Zugangsdaten verwenden, die Laufzeit begrenzen und ungenutzte Zugänge widerrufen.
  • Abgerufenen Text als Daten behandeln: Eine Anweisung in einem gefundenen Dokument darf nicht automatisch die Regeln des Assistenten ersetzen. Das ist ein typischer Angriffspunkt für Prompt Injection.
  • Datenabfluss kontrollieren: Prüfen, was der Client an das Modell sendet und was Anbieter oder Protokolle speichern. Lesen kann bereits vertrauliche Informationen offenlegen.

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.

Häufige Fragen zu MCP-Servern

Was ist ein MCP-Server einfach erklärt?

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.

Muss ich einen MCP-Server installieren?

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.

Ist MCP kostenlos?

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.

Kann ein MCP-Server Daten verändern?

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.

Kann ich AFFiNE MCP mit jedem KI-Client verbinden?

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.

Macht Self-Hosting den Einsatz automatisch DSGVO-konform?

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.

Findet AFFiNE MCP auch Whiteboards und PDF-Anhänge?

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.

Der nächste Schritt: eine Quelle, eine Aufgabe, überprüfbare Ergebnisse

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.