MCP-Integration

AFFiNE MCP Server: KI-Tools an Ihre Wissensdatenbank anbinden

Der Workspace-MCP-Endpunkt von AFFiNE lässt kompatible KI-Clients Notizen und Whiteboard-Text durchsuchen und Dokumente lesen. Direktverbindungen benötigen Streamable HTTP und Bearer-Header; Clients mit lokalem stdio können eine lokale Bridge nutzen.

  • Zugangsdaten pro Workspace, jederzeit widerrufbar
  • Streamable HTTP + Bearer
  • 70K+ GitHub-Sterne

Die Wissensbasis mit einem kompatiblen KI-Client verbinden

MCP ist ein offener Standard für externe Tools und Daten. Unterstützte AFFiNE-Cloud- und selbst gehostete Instanzen enthalten einen Workspace-Endpunkt. Direktverbindungen brauchen Streamable HTTP und einen Authorization-Header. Für reine stdio-Clients ist eine lokale Bridge wie mcp-remote nötig.

Einmal verbunden, durchsucht ein Assistent Ihre Wissensdatenbank per Stichwort- und semantischer Suche – Whiteboards eingeschlossen – und liest ganze Dokumente, mit exakt den Rechten, die Sie vergeben, und keinem mehr. Jeder Client erhält eigene Zugangsdaten, die Sie unabhängig rotieren oder widerrufen können. "Meine KI sieht meine Notizen" muss nie "alles, für immer" bedeuten.

Der AFFiNE MCP Server auf einen Blick

Was es istDer offizielle Model-Context-Protocol-Endpunkt, eingebaut in AFFiNE Cloud und selbst gehostete Instanzen
EndpunktPOST /api/workspaces/{workspace-id}/mcp
TransportStreamable HTTP, zustandslos
AuthBearer-Zugangsdaten (Präfix aff_mcp_v1.), pro Client in den Workspace-Einstellungen erstellt
Toolsdoc_search / read_document; READ_WRITE: development / canary
GeltungsbereichEin Workspace pro Zugangsdaten, unter Beachtung Ihrer Dokumentrechte
PreisKostenlos in AFFiNE Cloud und auf selbst gehosteten Instanzen mit aktivierten KI-Funktionen

Workspace-Verbindung oder öffentliche Inhaltsdemo?

Dein Workspace

AFFiNE Cloud oder eine unterstützte eigene Instanz. Ein Workspace-Bearer-Token ist erforderlich; Dokumentberechtigungen gelten weiterhin. Unten stehen die standardmäßigen Lesewerkzeuge. Die Verfügbarkeit hängt von der Instanz ab.

https://app.affine.pro/api/workspaces/{workspace-id}/mcp
  • doc_search
  • read_document

Öffentliche Website-Inhalte

Ein separater Lesedienst für veröffentlichte Blogartikel und Vorlagen. Ohne Konto oder Token. Er kann deinen Workspace weder lesen noch Dokumente schreiben. Sende niemals Workspace-Zugangsdaten an diesen Endpunkt.

https://affine.pro/api/public/mcp
  • search_public_content
  • read_public_content
Public content API (English)

Einen kompatiblen MCP-Client verbinden

Erstelle Zugangsdaten in AFFiNE und richte danach den Client in dessen eigenem Format ein.

  1. MCP-Einstellungen des Workspace öffnen

    In AFFiNE: Einstellungen → Integrations → MCP Server. Verfügbar in AFFiNE Cloud und auf selbst gehosteten Instanzen mit aktivierten KI-Funktionen.

  2. Zugangsdaten erstellen

    Auf 'Create credential' klicken, ein Label vergeben (eines pro Client, z. B. 'Claude Code' oder 'Cursor'), dann Zugriffsmodus und Ablaufdatum wählen. Nur-Lesen ist der Standard.

  3. Konfiguration in den Client einfügen

    Kopiere Endpunkt und Zugangsdaten aus AFFiNE. Das Token wird einmal angezeigt. Nutze das passende Client-Beispiel; nicht jeder Client akzeptiert dasselbe JSON.

{
"mcpServers": {
"affine_workspace_<workspace-id>": {
"type": "streamable-http",
"url": "https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"headers": { "Authorization": "Bearer aff_mcp_v1...." }
}
}
}

Das von AFFiNE erzeugte Verbindungsformat. Passe es an deinen Client an; selbst gehostete Instanzen verwenden ihre eigene Serveradresse.

Einrichtung Client für Client

Prüfe Transport und Authentifizierung. Claude Code, Cursor und Cline unterstützen HTTP mit Bearer-Header. Ein reiner OAuth-Anmeldedialog kann diese manuell erstellten Zugangsdaten nicht nutzen. Eine stdio-Bridge setzt voraus, dass der Client lokale Prozesse starten kann.

Claude Code

AFFiNE mit einem CLI-Befehl hinzufügen; danach kann Claude aus jeder Session heraus Ihren Workspace durchsuchen und lesen.

claude mcp add --transport http affine \
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp" \
--header "Authorization: Bearer <your-credential>"

Cursor

Trage URL und headers aus dem Beispiel in ~/.cursor/mcp.json ein. Verwende die Daten aus deinem Workspace; die JSON-Formate unterscheiden sich je nach Client.

{
"mcpServers": {
"affine": {
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}

Cline

Clines MCP-Einstellungen öffnen und AFFiNE als entfernten Streamable-HTTP-Server hinzufügen.

{
"mcpServers": {
"affine": {
"type": "streamableHttp",
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}

Lokale stdio-Clients, etwa Claude Desktop

Diese Konfiguration startet die Drittanbieter-Bridge mcp-remote in einem Client mit lokalen stdio-Prozessen. Dafür ist eine unterstützte Node.js-Version nötig. Dies ist kein OAuth-Connector für Claude im Web.

{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"--header",
"Authorization:${AFFINE_MCP_AUTH}"
],
"env": {
"AFFINE_MCP_AUTH": "Bearer <your-credential>"
}
}
}
}

Was ein verbundener Assistent kann

Lesen ist der Standard. Die am 26. Oktober 2026 geprüfte Implementierung beschränkt Schreibzugangsdaten und Schreibwerkzeuge auf Entwicklungs- oder canary-Umgebungen. Das belegt keine Verfügbarkeit in der stabilen Cloud-Version. Prüfe Zugriffsmodus und tools/list deiner Instanz.

Nur Lesen

Standard
doc_search
Dokumentsuche

Stichwort- und semantische Suche über Workspace-Dokumente; liefert begrenzte Passagen mit Seiten- oder Canvas-Verweis. Nie Dateien, Blobs oder das Web.

read_document
Dokument lesen

Ruft den vollständigen Inhalt eines Dokuments per ID ab, unter Beachtung Ihrer aktuellen Workspace-Rechte.

Lesen und Schreiben

Development / canary
create_document
Dokument erstellen

Wenn aktiviert: ein Dokument aus Titel und Markdown-Inhalt erstellen. Datenbankblöcke und Bilder lassen sich damit nicht einfügen.

update_document
Dokument aktualisieren

Wenn aktiviert: den Markdown-Inhalt mit strukturellen Änderungen aktualisieren. Titel, Datenbankblöcke und Bilder werden damit nicht aktualisiert.

update_document_meta
Metadaten aktualisieren

Wenn aktiviert: den Dokumenttitel ändern. Andere Metadatenfelder stellt das geprüfte Werkzeug nicht bereit.

Pro Workspace

Zugangsdaten erreichen immer nur einen Workspace, mit Ihren Rechten.

Ein Credential pro Client

Widerrufen Sie den Zugriff eines Clients, ohne die anderen anzufassen.

Ablaufdatum eingebaut

Jedes Credential erhält beim Erstellen ein Ablaufdatum.

Token-Rotation

Das alte Token gilt bis zu 24 Stunden oder bis zum früheren ursprünglichen Ablauf. Ein Widerruf kann den Zugriff früher beenden.

Der AFFiNE MCP Server im Vergleich

Viele Notiz-Tools sprechen inzwischen MCP. Der Unterschied liegt darin, was der Server erreicht, wo er läuft und wer ihn kontrolliert. So schneidet AFFiNEs eingebauter Server gegen die zwei meistgefragten Setups ab.

AFFiNENotion MCPObsidian
Eingebaut, First-PartyJaFirst-Party, in die App eingebaut; Zugangsdaten in den Workspace-EinstellungenJaOffizieller Remote-Server, von Notion gehostetNeinCommunity-Plugins oder Server von Drittanbietern
Self-Hosting möglichJaDerselbe offizielle Endpunkt; KI-Funktionen auf der eigenen Instanz aktivierenNeinAktueller Server nur gehostet; der eingestellte Open-Source-Vorgänger ließe sich hostenBedingtStandardmäßig localhost, Remote ist Eigenbau
Whiteboard-SucheJaDie Suche indiziert Text auf dem Edgeless-Canvas und liefert Element- und Frame-VerweiseNeinNotion hat kein natives WhiteboardNein.canvas-Dateien nur als rohes JSON lesbar; kein verbreiteter Server durchsucht sie
BetriebsmodellCloud oder self-hostedOffizieller Endpunkt in AFFiNE; beim Self-Hosting müssen KI-Funktionen aktiviert seinNur gehostetDer aktuelle offizielle Server läuft bei NotionLokalCommunity-Server laufen neben dem Desktop-Vault
PreisKostenlosKostenlos in der Cloud und self-hosted mit aktivierten KI-FunktionenKern kostenlosConnected-App-Suche und Meeting-Notizen brauchen Notion-AI-TarifeKostenlosApp und Community-Server

Vergleich auf Basis öffentlich dokumentierter Fähigkeiten, Stand August 2026.

Obsidians MCP-Server auf REST-API-Basis setzen voraus, dass die Desktop-App läuft. Obsidians CLI (2026) ist eine offizielle Automatisierungsschnittstelle, aber kein MCP.

Häufige Fragen

Was ist der AFFiNE MCP Server?

Der offizielle Model-Context-Protocol-Endpunkt, der in AFFiNE eingebaut ist. KI-Assistenten wie Claude, Cursor und Cline durchsuchen und lesen darüber die Dokumente eines Ihrer AFFiNE-Workspaces – über eine standardisierte, authentifizierte HTTP-Verbindung mit Zugangsdaten, die Sie in den Workspace-Einstellungen erstellen und kontrollieren.

Ist der MCP Server kostenlos?

Ja. Er ist in AFFiNE Cloud und auf selbst gehosteten Instanzen mit aktivierten KI-Funktionen kostenlos. Für die Verbindung selbst fallen keine Kosten an.

Läuft der MCP Server auch self-hosted – Stichwort Datenhoheit?

Ja. Der offizielle MCP-Endpunkt steht auf selbst gehosteten AFFiNE-Instanzen genauso bereit: Er liegt dann auf Ihrer eigenen Serveradresse, die Einrichtung ist identisch (Einstellungen → Integrations → MCP Server), KI-Funktionen müssen auf der Instanz aktiviert sein. Wer aus Datenschutz- oder DSGVO-Gründen die komplette Wissensinfrastruktur auf eigenen Maschinen betreiben will, bekommt hier denselben Server wie in der Cloud.

Kann eine verbundene KI auch Whiteboards durchsuchen?

Ja. doc_search deckt Seitendokumente und Edgeless-Whiteboards gleichermaßen ab: Text auf dem Canvas wird indiziert, Treffer tragen Block-, Element- oder Frame-Verweise – der Assistent kann also zeigen, wo auf einem Whiteboard die Antwort steht. Volltext-Lesen liefert Seiteninhalte; Whiteboard-Inhalte kommen über die Suche. Die meisten Notiz-MCP-Server sehen nur reine Dokumente.

Bleibt der Zugriff auf Nur-Lesen beschränkt?

Lesen ist der Standard. Die am 26. Oktober 2026 geprüfte Implementierung beschränkt Schreibzugangsdaten und Schreibwerkzeuge auf Entwicklungs- oder canary-Umgebungen. Das belegt keine Verfügbarkeit in der stabilen Cloud-Version. Prüfe Zugriffsmodus und tools/list deiner Instanz.

Welche KI-Tools können sich mit AFFiNE verbinden?

Prüfe Transport und Authentifizierung. Claude Code, Cursor und Cline unterstützen HTTP mit Bearer-Header. Ein reiner OAuth-Anmeldedialog kann diese manuell erstellten Zugangsdaten nicht nutzen. Eine stdio-Bridge setzt voraus, dass der Client lokale Prozesse starten kann.

Wie ist der Zugriff abgesichert?

Zugangsdaten erreichen immer nur einen Workspace, mit Ihren Rechten. Widerrufen Sie den Zugriff eines Clients, ohne die anderen anzufassen. Jedes Credential erhält beim Erstellen ein Ablaufdatum. Das alte Token gilt bis zu 24 Stunden oder bis zum früheren ursprünglichen Ablauf. Ein Widerruf kann den Zugriff früher beenden.

Bringen Sie Ihre Wissensdatenbank zum Arbeiten

Erstellen Sie Zugangsdaten in den Workspace-Einstellungen – und Ihre KI-Tools antworten ab heute aus Ihren eigenen Notizen.

Zuletzt aktualisiert: 26. Oktober 2026