← Handbuch

Claude-Integration

Markdown, das in Claude entsteht — ein Artifact, eine Chat-Antwort, eine von Claude Code erzeugte Datei — kann direkt in deine markbird-Bibliothek wandern, ohne Copy-Paste-Umweg und ohne dass etwas hochgeladen wird.

Es gibt einen Einstiegspunkt und drei Wege dorthin. Nimm den, der zu deinem Arbeitsort passt:

Wie die Übergabe funktioniert

Alles oben Genannte öffnet am Ende eine Adresse dieser Form:

https://app.markbird.md/new#<payload>

<payload> ist dein Dokument — gzip-komprimiert und base64url-kodiert — im Fragment der URL, also dem Teil hinter dem #.

Genau darum geht es. Browser übertragen das Fragment nie: Es steht nicht in der Anfrage, nicht in Serverprotokollen und nicht im Referer-Header, der an die nächste besuchte Seite geht. Eine Funktion, deren Aufgabe das Bewegen deiner Texte ist, wäre ein merkwürdiger Ort, um damit anzufangen, sie hochzuladen — also tut markbird das nicht. Der Import passiert vollständig in deinem Browser, funktioniert damit offline und braucht kein Konto.

Zwei Folgen, die man kennen sollte:

• markbird entfernt den Payload aus der Adresszeile, bevor der Editor erscheint. Ein Neuladen ist deshalb ein Neuladen und keine zweite Kopie des Dokuments.
• Eine URL kann nicht beliebig viel Text tragen. Sehr große Dokumente werden mit einer klaren Meldung abgelehnt, statt stillschweigend abgeschnitten zu werden — siehe Fehlerbehebung.

MCP-Server

Der MCP-Server deckt Claude Desktop und Claude Code mit einem Bauteil ab. Beide sprechen das Model Context Protocol; eine Browser-Erweiterung erreicht keines von beiden, denn Claude Desktop lädt keine Browser-Erweiterungen.

Einrichtung

Aus dem Repository bauen, dann registrieren:

pnpm --filter @markbird/mcp build
claude mcp add markbird -- node /absoluter/pfad/zu/packages/mcp/dist/server.js

Für Claude Desktop trägst du denselben Befehl in die MCP-Konfiguration ein.

Verwendung

Frag einfach in normaler Sprache:

Schick das an markbird.

Claude ruft das Werkzeug open_in_markbird auf, und das Dokument öffnet sich in deiner Bibliothek — mit Titel, oder mit einem aus der ersten Überschrift abgeleiteten Titel, wenn du keinen angibst.

Optionen

MARKBIRD_NO_LAUNCH ist für Umgebungen ohne Browser gedacht — eine entfernte Claude-Code-Sitzung oder einen Container. Du bekommst den Link als Text zurück und öffnest ihn selbst.

Browser-Erweiterung

Für claude.ai im Browser ergänzt die Erweiterung einen Knopf An markbird senden an Assistenz-Nachrichten sowie einen Kontextmenü-Eintrag für beliebig markierten Text. Dieselbe Erweiterung ist markbirds Web-Clipper: Ihr Knopf in der Symbolleiste speichert die Seite, die du gerade liest, in deine Bibliothek.

Einrichtung

pnpm --filter @markbird/extension build

Dann in den Browser laden:

• Chrome, Edge, Brave, Arc — chrome://extensions öffnen, den Entwicklermodus aktivieren, Entpackte Erweiterung laden wählen und packages/extension/dist auswählen.
• Firefox ab 140 — about:debugging#/runtime/this-firefox öffnen, Temporäres Add-on laden wählen und packages/extension/dist-firefox/manifest.json auswählen.

Für ein selbst gehostetes markbird oder einen lokalen Entwicklungsstand trägst du die Adresse in den Optionen der Erweiterung ein.

Wie sie das Dokument liest

Die Erweiterung wandelt die gerenderte Seite zurück nach Markdown, statt in Claudes Interna zu greifen. Überschriften, Codeblöcke samt Sprache, Listen, Tabellen, Links, Zitate und Hervorhebungen überstehen den Weg.

Sie bietet bewusst zwei Auslöser, weil die unterschiedlich kaputtgehen:

• Text markieren und das Kontextmenü nutzen hängt an nichts, was claude.ai-spezifisch wäre. Dieser Weg funktioniert durch jede Neugestaltung der Seite hindurch.
• Der Knopf an jeder Nachricht ist der bequemere eine Klick, muss dafür aber Nachrichten in der Seite finden. Nach einer Neugestaltung durch Claude kann er verschwinden, bis die Erweiterung nachgezogen wird — das Kontextmenü läuft unabhängig davon weiter.

Beliebige Seiten clippen

Der Knopf in der Symbolleiste — oder Diese Seite nach markbird clippen bzw. Auswahl nach markbird clippen im Kontextmenü — macht aus der Seite, die du liest, eine Notiz. Der Artikel kommt mit, die Navigation drumherum nicht (dieselbe Regel wie beim Import einer .html-Datei), und Adresse sowie Datum landen im Frontmatter:

---
source: 'https://example.com/post'
clipped: 2026-09-19
tags: [clipped]
---

Berechtigungen

Die Erweiterung verlangt Kontextmenüs, Speicher für deine markbird-Adresse, claude.ai für den Nachrichten-Knopf sowie activeTab und scripting fürs Clippen. activeTab ist der springende Punkt: Der Browser gewährt Zugriff auf eine Seite nur im Moment deines Klicks. Sonst kann die Erweiterung nichts von dem lesen, was du im Netz tust, und nichts, was du clippst, wird irgendwo hochgeladen.

Dateien auf der Festplatte

Wenn Claude Code .md-Dateien lokal schreibt, brauchst du nichts von alledem. Installiere markbird als App (siehe Erste Schritte); es registriert sich dann als Handler für .md, .markdown, .mkd und .txt. „Öffnen mit markbird" steht danach im Dateimanager bereit.

Für Dateien, die du weiter an Ort und Stelle bearbeiten willst, nutzt du Datei von der Festplatte öffnen… und In Datei speichern — markbird schreibt in die echte Datei zurück.

Datenschutz

Nichts an dieser Integration sendet deine Dokumente an markbirds Server oder an irgendjemand anderen:

• Das Dokument reist im URL-Fragment, das nie übertragen wird.
• Der Import läuft in deinem Browser und funktioniert offline.
• Ein Konto ist nicht nötig.
• Die Erweiterung sieht ausschließlich claude.ai.

Wenn du zur Synchronisierung angemeldet bist, wird ein importiertes Dokument danach synchronisiert wie jedes andere auch — das ist die Synchronisierung, die du eingeschaltet hast, nicht etwas, das diese Funktion von sich aus tut. Siehe Datenschutz & Daten.

Fehlerbehebung

„Dokument ist zu groß für die Übergabe per URL." Browser begrenzen die URL-Länge. Speichere das Dokument als .md-Datei und nutze markbirds Import, oder teile es auf.

Der Knopf erscheint nicht auf claude.ai. Claude hat den Seitenaufbau geändert. Markiere den Text und nutze das Rechtsklick-Menü — dieser Weg hängt nicht am Aufbau der Seite — und aktualisiere die Erweiterung, sobald ein neuer Stand verfügbar ist.

Claude sagt, es sei gesendet, aber nichts passiert. Prüfe, ob der MCP-Server registriert ist (claude mcp list). In einer entfernten Sitzung oder im Container gibt es keinen Browser zum Öffnen: Setze MARKBIRD_NO_LAUNCH=1 und öffne den zurückgegebenen Link selbst.

Es hat das falsche markbird geöffnet. Setze MARKBIRD_URL für den MCP-Server bzw. die Adresse in den Optionen der Erweiterung.