Agentenwerkby Masiar Ighani · powered by skillbyte

Praxisprojekt Second Brain · Einrichtung

MCP für Obsidian

Lektion 3/97 Min. LesezeitEinsteiger

Lernziele

  • Du schaltest das Plugin Local REST API ein und registrierst seinen MCP-Zugang bei Claude Code.
  • Du findest die vier häufigsten Ursachen, wenn die Verbindung fehlt.
  • Du entscheidest, ob dein Setup MCP überhaupt braucht.

MCP · engl. Model Context ProtocolEin offenes Protokoll, über das ein Agent Tools aus externen Servern einbindet, etwa für GitHub, Slack oder eine Datenbank. Jeder Server bringt eigene Tool-Definitionen mit.Im Glossar ist der Standardweg, über den Claude mit anderen Anwendungen spricht. Für einen Vault · engl. vaultDer Ordner mit allen Markdown-Dateien deines Second Brain, so wie Obsidian ihn öffnet. Jede Seite ist eine eigene Textdatei.Im Glossar öffnet MCP eine Tür in Obsidian selbst, zusätzlich zum Ordner darunter. Damit erreicht der Agent den Vault aus jeder Session, auch aus einer, die nicht in diesem Ordner gestartet wurde.

Zum Start brauchst du das nicht. Nimm es dazu, wenn du geplante Aufgaben willst oder aus der Desktop-App heraus arbeitest, ohne Terminal im Vault.

Zwei Wege

Das Plugin · engl. community pluginEine Erweiterung für Obsidian, die du in den Einstellungen unter Community plugins installierst. Plugins stammen meist von Dritten und erweitern, was Obsidian kann.Im Glossar Local REST API bringt inzwischen einen eigenen MCP-Server mit. Er läuft unter https://127.0.0.1:27124/mcp/. Ein separater Server ist damit nicht mehr nötig. Das ist der kürzere Weg, und diese Lektion beschreibt ihn zuerst.

Der zweite Weg ist der Server mcp-obsidian, der über die REST-Schnittstelle des Plugins mit Obsidian spricht. Ihn beschreiben die meisten Anleitungen. Beide Wege führen zum selben Ergebnis.

Schritt 1: Plugin einschalten

  1. Community-Plugins erlauben. In Obsidian: Settings (Zahnrad unten links) → Community plugins → Turn on community plugins.
  2. Plugin installieren. Browse → Local REST API suchen → Install → Enable.
  3. Key kopieren. Öffne Settings → Local REST API. Dort steht ein API Key, eine lange Zeichenkette. Kopier ihn.

Achte beim Einfügen darauf, wohin der Key geht. Im HTTP-Header steht vor dem Key das Wort Bearer und ein Leerzeichen. In der Variablen OBSIDIAN_API_KEY des zweiten Wegs steht nur der Key selbst. Nach unserer Einschätzung ist ein vertauschtes oder doppeltes Bearer der häufigste Grund, warum der erste Versuch scheitert.

Schritt 2: Server registrieren

Für den eingebauten Server gibst du im Terminal oder im Code-Tab diesen Befehl ein. Ersetz DEIN-KEY durch den kopierten Key:

claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ \
  --header "Authorization: Bearer DEIN-KEY"

Das Plugin sichert die Verbindung mit einem selbst signierten Zertifikat. Wie du ihm vertraust, beschreibt die README des Plugins. Alternativ schaltest du in den Plugin-Einstellungen Enable HTTP server ein und nutzt http://127.0.0.1:27123/mcp/.

Für den zweiten Weg mit mcp-obsidian sieht der Befehl so aus:

claude mcp add-json obsidian-vault '{
  "type": "stdio",
  "command": "uvx",
  "args": ["mcp-obsidian"],
  "env": {
    "OBSIDIAN_API_KEY": "DEIN-KEY",
    "OBSIDIAN_HOST": "127.0.0.1",
    "OBSIDIAN_PORT": "27124"
  }
}'

uvx startet den Server, ohne ihn dauerhaft zu installieren. Findet die Shell den Befehl nicht, installierst du zuerst uv. Beide Befehle registrieren den Server im Bereich local: Er gilt für dich und für den Ordner, in dem du ihn hinzugefügt hast.

Schritt 3: testen

Liste alle Dateien in meinem Obsidian-Vault auf.

Listet der Agent deine Notizen auf, steht die Verbindung.

Wenn es nicht klappt

Fehlersuche MCP

0 von 4 erledigt

Brauchst du das überhaupt

Ein Gegenargument verdient Beachtung: Ein Vault ist ein Ordner mit Textdateien, und jede Schicht zwischen Agent und Dateien ist eine weitere Fehlerquelle. Mit demselben Argument empfehlen wir zum Start das Dateisystem. Nach unserer Einschätzung lohnt sich MCP, sobald der Vault aus Sessions erreichbar sein muss, die nicht darin laufen, und vorher nicht.

Sicherheit

Merksätze

  • MCP macht den Vault aus jeder Session erreichbar, das Dateisystem nur aus dem Startordner.
  • Das Plugin Local REST API bringt einen eigenen MCP-Server unter /mcp/ mit, mcp-obsidian ist der zweite Weg.
  • Im Header steht der Key mit Bearer davor, in OBSIDIAN_API_KEY ohne.
  • Die Verbindung gibt es nur, solange Obsidian läuft und das Plugin aktiv ist.
  • Der Key gewährt vollen Lese- und Schreibzugriff und ist wie ein Passwort zu behandeln.

Prüf dich selbst

Denkfrage

Eine geplante Aufgabe läuft nachts und meldet, dass sie den Vault nicht erreicht. Tagsüber klappt alles. Was ist die wahrscheinlichste Ursache?

Denkfrage

Warum ist der Key des Plugins so heikel?

Prüf dich selbst

  1. 1Unter welcher Adresse läuft der eingebaute MCP-Server des Plugins standardmäßig?
  2. 2Du trägst den Key in OBSIDIAN_API_KEY ein. Wie sieht der Wert aus?
  3. 3Nach einem Update geht die Verbindung nicht mehr. Was prüfst du zuerst?

Quellen

  1. Local REST API with MCP · Adam Coddington, Stand: Nov. 2026

    Eingebauter MCP-Server unter /mcp/, Ports 27124 (HTTPS) und 27123 (HTTP nach „Enable HTTP server“), Header mit Bearer, Befehl für Claude Code.

  2. mcp-obsidian · Markus Pfundstein, Stand: Nov. 2026

    Umgebungsvariablen, Standard-Host 127.0.0.1 und Port 27124, braucht das REST-Plugin.

  3. Connect Claude Code to tools via MCP · Anthropic, Stand: Nov. 2026

    claude mcp add und add-json, Standardbereich local.

  4. Installing uv · Astral, Stand: Nov. 2026

    uvx startet ein Tool ohne dauerhafte Installation.

  5. Community plugins · Obsidian Help, Stand: Nov. 2026

    Turn on community plugins, Browse, Install, Enable; Restricted mode.

Dein Fortschritt bleibt nur in diesem Browser gespeichert.