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.
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.
| Was es ist | Der offizielle Model-Context-Protocol-Endpunkt, eingebaut in AFFiNE Cloud und selbst gehostete Instanzen |
|---|---|
| Endpunkt | POST /api/workspaces/{workspace-id}/mcp |
| Transport | Streamable HTTP, zustandslos |
| Auth | Bearer-Zugangsdaten (Präfix aff_mcp_v1.), pro Client in den Workspace-Einstellungen erstellt |
| Tools | doc_search / read_document; READ_WRITE: development / canary |
| Geltungsbereich | Ein Workspace pro Zugangsdaten, unter Beachtung Ihrer Dokumentrechte |
| Preis | Kostenlos in AFFiNE Cloud und auf selbst gehosteten Instanzen mit aktivierten KI-Funktionen |
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}/mcpdoc_searchread_documentEin 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/mcpsearch_public_contentread_public_contentErstelle Zugangsdaten in AFFiNE und richte danach den Client in dessen eigenem Format ein.
In AFFiNE: Einstellungen → Integrations → MCP Server. Verfügbar in AFFiNE Cloud und auf selbst gehosteten Instanzen mit aktivierten KI-Funktionen.
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.
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.
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.
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>"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>"
}
}
}
}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>"
}
}
}
}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>"
}
}
}
}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.
doc_searchStichwort- und semantische Suche über Workspace-Dokumente; liefert begrenzte Passagen mit Seiten- oder Canvas-Verweis. Nie Dateien, Blobs oder das Web.
read_documentRuft den vollständigen Inhalt eines Dokuments per ID ab, unter Beachtung Ihrer aktuellen Workspace-Rechte.
create_documentWenn aktiviert: ein Dokument aus Titel und Markdown-Inhalt erstellen. Datenbankblöcke und Bilder lassen sich damit nicht einfügen.
update_documentWenn aktiviert: den Markdown-Inhalt mit strukturellen Änderungen aktualisieren. Titel, Datenbankblöcke und Bilder werden damit nicht aktualisiert.
update_document_metaWenn aktiviert: den Dokumenttitel ändern. Andere Metadatenfelder stellt das geprüfte Werkzeug nicht bereit.
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.
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.
| AFFiNE | Notion MCP | Obsidian | |
|---|---|---|---|
| Eingebaut, First-Party | JaFirst-Party, in die App eingebaut; Zugangsdaten in den Workspace-Einstellungen | JaOffizieller Remote-Server, von Notion gehostet | NeinCommunity-Plugins oder Server von Drittanbietern |
| Self-Hosting möglich | JaDerselbe offizielle Endpunkt; KI-Funktionen auf der eigenen Instanz aktivieren | NeinAktueller Server nur gehostet; der eingestellte Open-Source-Vorgänger ließe sich hosten | BedingtStandardmäßig localhost, Remote ist Eigenbau |
| Whiteboard-Suche | JaDie Suche indiziert Text auf dem Edgeless-Canvas und liefert Element- und Frame-Verweise | NeinNotion hat kein natives Whiteboard | Nein.canvas-Dateien nur als rohes JSON lesbar; kein verbreiteter Server durchsucht sie |
| Betriebsmodell | Cloud oder self-hostedOffizieller Endpunkt in AFFiNE; beim Self-Hosting müssen KI-Funktionen aktiviert sein | Nur gehostetDer aktuelle offizielle Server läuft bei Notion | LokalCommunity-Server laufen neben dem Desktop-Vault |
| Preis | KostenlosKostenlos in der Cloud und self-hosted mit aktivierten KI-Funktionen | Kern kostenlosConnected-App-Suche und Meeting-Notizen brauchen Notion-AI-Tarife | KostenlosApp 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.
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.
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.
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.
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.
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.
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.
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.
Erstellen Sie Zugangsdaten in den Workspace-Einstellungen – und Ihre KI-Tools antworten ab heute aus Ihren eigenen Notizen.
Zuletzt aktualisiert: 26. Oktober 2026