KI-Assistent-Integration (MCP)

Verbinde Linkflare mit deinem bevorzugten KI-Assistenten und verwalte deine Lesezeichen per natürlichem Gespräch. Links speichern, deine Bibliothek durchsuchen, Sammlungen organisieren – alles, ohne deinen Chat zu verlassen.

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten mit externen Tools und Daten interagieren lässt. Stell es dir so vor, als würdest du deiner KI eine Reihe von Superkräften verleihen – in diesem Fall die Fähigkeit, deine Linkflare-Lesezeichen zu lesen, zu schreiben und zu organisieren.

Linkflare stellt einen gehosteten MCP-Server unter https://mcp.linkflare.io/mcp bereit, der mit jedem MCP-kompatiblen Client funktioniert, darunter Claude Desktop, ChatGPT, Cursor, Windsurf und mehr.

Was kannst du damit machen?

Sobald die Verbindung steht, kannst du mit deinem KI-Assistenten in einfacher Sprache reden, und er interagiert in deinem Namen mit deiner Linkflare-Bibliothek. Hier sind einige Dinge, die du sagen kannst:

Lesezeichen speichern

„Speichere diesen Link in meiner Sammlung Rezepte: https://example.com/pasta-recipe"
„Füge https://arxiv.org/abs/2401.12345 hinzu und versieh es mit den Tags machine-learning und research"
„Hier ist ein Haufen Links aus meinen Notizen – speichere sie alle:" (einen Textblock mit URLs einfügen)

Suchen und finden

„Finde alle meine Lesezeichen zum Thema TypeScript"
„Zeig mir Videos mit dem Tag scotland"
„Welche Rezepte habe ich kürzlich gespeichert?"
„Finde Artikel, die ich mit Daumen hoch bewertet habe"
„Durchsuche meine Wissenskarten nach verteiltem Wiederholen"

Organisieren

„Verschiebe die Links 42 und 43 in meine Sammlung Arbeit"
„Erstelle eine neue Sammlung namens Reise nach Japan"
„Erstelle ein Tag namens must-read"
„Was ist in meinem Posteingang? Hilf mir, ihn zu organisieren."

Wissen festhalten Pro

Wissenskarten sind hierarchische Notizen mit reichhaltigem Inhalt, Tags und optionalem verteiltem Wiederholen. Die Wissens-Tools erfordern einen Pro-Tarif.

„Erstelle eine Wissenskarte mit dem Titel React Server Components und diesen Notizen: …"
„Füge unter Kochgrundlagen eine untergeordnete Karte für Messer-Skills hinzu"
„Aktualisiere Karte 42 – ergänze: funktioniert auch mit async iterators"
„Zeig mir alle Wissenskarten der obersten Ebene"
„Was weiß ich über Vektordatenbanken? Fasse meine Karten zusammen."

Überprüfen und reflektieren

„Gib mir eine Übersicht über das, was ich diese Woche gespeichert habe"
„Fasse zusammen, was in meiner Sammlung Designinspiration ist"
„Finde Lesezeichen zum Thema Benutzeroberflächendesign"
„Welche Lesezeichen haben noch keine Tags? Schlag welche vor."
„Erkunde meine Wissensdatenbank zum Thema maschinelles Lernen – welche Lücken habe ich?"

Praxisbeispiele

🔬 Recherche-Workflow

Du recherchierst zu einem Thema und findest viele nützliche Artikel. Statt zu Linkflare zu wechseln, sag einfach deiner KI:

„Speichere https://example.com/article in meiner Sammlung Recherche, versieh es mit den Tags AI und transformers und bewerte es mit Daumen hoch"

📋 Posteingang aufräumen

Dein Posteingang ist gewachsen. Bitte deine KI um Hilfe:

„Zeig mir meinen Posteingang. Gruppiere die Einträge nach Typ und schlage vor, in welche Sammlung jeder gehört."

🎬 Filmabend

Planst du einen Filmabend? Frag nach einer Empfehlung aus deiner eigenen Sammlung:

„Durchsuche meine Lesezeichen nach Filmen, die ich noch nicht bewertet habe. Wähle einen aus, der nach einem unterhaltsamen Actionfilm aussieht."

🍳 Wöchentliche Essensplanung

Du hast die ganze Woche Rezepte gespeichert. Zeit zu planen:

„Zeig mir alle Rezepte in meinem Posteingang. Wähle 5 für die Abendessen dieser Woche und verschiebe sie in meine Sammlung Essensplan."

📚 Leseliste durchsehen

Hol nach, was du gespeichert hast:

„Gib mir eine wöchentliche Übersicht meiner aktuellen Lesezeichen. Zu welchen Themen habe ich am meisten gespeichert?"

✈️ Reiseplanung

Du sammelst seit Monaten Reise-Links:

„Finde alle Lesezeichen mit dem Tag japan. Fasse zusammen, was ich gesammelt habe – Restaurants, Hotels, Aktivitäten."

💡 Mehrere Links aus Notizen speichern

Du hast ein Dokument voller Links. Füge es ein und sag:

„Extrahiere alle URLs aus diesem Text und speichere sie in meiner Sammlung Leseliste."

🧠 Festhalten, was du gerade gelernt hast Pro

Du hast gerade einen Artikel zu Ende gelesen und möchtest die Kernideen als Wissenskarte festhalten:

„Erstelle eine Wissenskarte mit dem Titel Rate Limiting Patterns unter meiner übergeordneten Karte Engineering. Notizen: token bucket, leaky bucket, sliding window. Versieh sie mit den Tags backend und distributed-systems."

🔎 Wissenslücken prüfen Pro

Verwende den Prompt explore_knowledge, um ein Thema zu prüfen, bevor du tiefer einsteigst:

„Erkunde, was ich über transformers weiß. Fasse meine Karten zusammen und liste dann 3 Unterthemen auf, die ich noch nicht festgehalten habe."

Voraussetzungen

Ein Linkflare-Konto – hier registrieren, falls du noch keins hast.
Dein API-Schlüssel – öffne die Linkflare-App, klicke auf dein Benutzermenü (oben rechts) und wähle API-Schlüssel kopieren.
Ein KI-Client, der entfernte MCP-Server unterstützt (siehe Einrichtungsanleitungen unten).

Einrichtung: Claude

Claude unterstützt benutzerdefinierte entfernte MCP-Connectors in Claude, Claude Desktop und unterstützten Team-Tarifen. Füge Linkflare als benutzerdefinierten Web-Connector hinzu.

Schritt 1: Connectors öffnen

Gehe zu Settings → Connectors und klicke auf Add custom connector.

Schritt 2: Die Connector-Details ausfüllen

Name: linkflare
Remote MCP server URL: https://mcp.linkflare.io/mcp

Schritt 3: OAuth konfigurieren (Advanced settings)

Öffne Advanced settings und lege fest:

OAuth Client ID: linkflare-claude

Schritt 4: Autorisieren

Wenn du die Linkflare-Tools zum ersten Mal in einem Gespräch verwendest, öffnet Claude eine Autorisierungsseite, auf der du deinen Linkflare-API-Schlüssel einfügst. Du findest deinen API-Schlüssel, indem du in der Linkflare-App auf dein Benutzermenü (oben rechts) klickst und API-Schlüssel kopieren wählst. Nach der Autorisierung merkt sich Claude deine Verbindung.

Schritt 5: Probier es aus

Starte ein Gespräch und sag etwas wie:

„Was ist in meinem Linkflare-Posteingang?"
„Durchsuche meine Lesezeichen nach Artikeln über Produktivität"
„Speichere https://example.com in meiner Leseliste"

Claude fragt um Erlaubnis, bevor es ein Tool zum ersten Mal verwendet.

Einrichtung: ChatGPT

ChatGPT unterstützt entfernte MCP-Server über ChatGPT-Apps und den Developer Mode. Linkflare unterstützt OAuth-Authentifizierung, sodass ChatGPT sich sicher verbinden kann.

Schritt 1: ChatGPT-Einstellungen öffnen

Gehe zu Settings → Apps, scrolle dann zu Advanced settings und klicke auf Create app.

Schritt 2: Eine neue App erstellen

Fülle Folgendes aus:

Name: Linkflare
MCP Server URL: https://mcp.linkflare.io/mcp
Authentication: OAuth

Falls ChatGPT nach zusätzlichen OAuth-Details fragt:

Client ID: linkflare-chatgpt
Client Secret: leer lassen

ChatGPT ermittelt die Autorisierungs- und Token-Endpunkte automatisch vom MCP-Server.

Schritt 3: Autorisieren

Wenn du die Linkflare-Tools zum ersten Mal in einem Gespräch verwendest, öffnet ChatGPT eine Autorisierungsseite, auf der du deinen Linkflare-API-Schlüssel einfügst. Du findest deinen API-Schlüssel, indem du in der Linkflare-App auf dein Benutzermenü (oben rechts) klickst und API-Schlüssel kopieren wählst. Nach der Autorisierung merkt sich ChatGPT deine Verbindung.

Schritt 4: Testen

Starte ein neues Gespräch und bitte ChatGPT, „meine Linkflare-Sammlungen aufzulisten", um zu prüfen, ob die Verbindung funktioniert.

Einrichtung: VS Code

Verwende die MCP-Konfigurationsdatei in VS Code. OAuth öffnet beim ersten Verbinden deinen Browser.

{
  "servers": {
    "linkflare": {
      "type": "http",
      "url": "https://mcp.linkflare.io/mcp",
      "oauth": {
        "clientId": "linkflare-vscode"
      }
    }
  }
}

Einrichtung: Cursor

Füge Linkflare zu ~/.cursor/mcp.json oder .cursor/mcp.json hinzu. Cursor verwendet einen festen OAuth-Callback und statische OAuth-Clientdaten.

{
  "mcpServers": {
    "linkflare": {
      "url": "https://mcp.linkflare.io/mcp",
      "auth": {
        "CLIENT_ID": "linkflare-cursor",
        "scopes": ["mcp"]
      }
    }
  }
}

Einrichtung: Windsurf

Füge Linkflare über das MCP-Konfigurationspanel hinzu oder bearbeite ~/.codeium/windsurf/mcp_config.json. Falls OAuth in deiner Version nicht verfügbar ist, nutze den API-Schlüssel-Fallback unten.

{
  "mcpServers": {
    "linkflare": {
      "serverUrl": "https://mcp.linkflare.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "linkflare": {
      "serverUrl": "https://mcp.linkflare.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LINKFLARE_API_KEY}"
      }
    }
  }
}

Einrichtung: Zed

Füge Linkflare in Zed als benutzerdefinierten Context Server hinzu. Wenn kein Authorization-Header konfiguriert ist, startet Zed den Standard-MCP-OAuth-Flow.

{
  "context_servers": {
    "linkflare": {
      "url": "https://mcp.linkflare.io/mcp"
    }
  }
}

Legacy-Fallback für ältere Zed-Versionen oder Clients ohne native Remote-MCP-Unterstützung:

{
  "context_servers": {
    "linkflare": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linkflare.io/mcp"]
    }
  }
}

Verbindungsdetails

Einstellung	Wert
Endpoint-URL	`https://mcp.linkflare.io/mcp`
Transport	Streamable HTTP
Authentifizierung	Bearer-Token über den `Authorization`-Header
Auth-Header	`Authorization: Bearer YOUR_API_KEY`

Alternative: Manche Clients verwenden stattdessen einen x-api-key-Header. Linkflare akzeptiert beide.

Verfügbare Tools

Sobald die Verbindung steht, stehen deinem KI-Assistenten die folgenden Tools zur Verfügung. Du musst sie dir nicht merken – rede einfach natürlich und die KI wählt das richtige aus.

Lesezeichen-Tools

Tool	Was es tut
add_link	Ein Lesezeichen speichern, optional mit Sammlung, Tags, Notizen und Typ
add_links_from_text	Alle URLs aus einem eingefügten Textblock extrahieren und speichern
search_links	Lesezeichen mit Filtern durchsuchen (Text, Sammlung, Tags, Typ, Posteingang, Bewertung)
get_link	Alle Details eines bestimmten Lesezeichens abrufen
update_link	Titel, Notizen, Tags oder andere Eigenschaften eines Lesezeichens aktualisieren
delete_link	Ein Lesezeichen löschen
move_links	Ein oder mehrere Lesezeichen in eine andere Sammlung verschieben
rate_link	Ein Lesezeichen mit Daumen hoch oder runter bewerten
get_inbox	Alle Posteingang-Einträge auflisten

Organisations-Tools

Tool	Was es tut
list_collections	Alle deine Sammlungen als Baum ansehen
create_collection	Eine neue Sammlung erstellen
list_tags	Alle deine Tags ansehen
create_tag	Ein neues Tag erstellen

Wissens-Tools Pro

Wissenskarten sind hierarchische Rich-Text-Notizen (denk an Notion / Obsidian), die mit deinen Lesezeichen verknüpft und mit verteiltem Wiederholen wiederholt werden können. Diese Tools erfordern einen Pro-Tarif.

Tool	Was es tut
search_knowledge	Wissenskarten per Schlüsselwort über Titel, Inhalt und Tags durchsuchen
add_knowledge	Eine neue Wissenskarte erstellen, optional mit Inhalt, Tags, übergeordneter Karte und Farbe
get_knowledge	Eine Karte per ID mit ihrem vollständigen Inhalt und der übergeordneten Brotkrümel-Navigation abrufen
update_knowledge	Titel, Inhalt, Tags, übergeordnete Karte oder Farbe einer Karte aktualisieren
delete_knowledge	Eine Karte löschen. Achtung: löscht auch alle verschachtelten untergeordneten Karten.
list_knowledge_children	Die Hierarchie durchstöbern – Wurzelkarten oder die untergeordneten Karten einer bestimmten Karte auflisten

KI-Prompts

Dies sind vorgefertigte Prompt-Vorlagen, die deine KI für häufige Abläufe verwenden kann:

Prompt	Was er tut
organize_inbox	Vorschläge zum Organisieren deiner Posteingang-Einträge erhalten
summarize_collection	Den Inhalt einer Sammlung zusammenfassen
find_related	Lesezeichen zu einem bestimmten Thema finden
weekly_digest	Eine Übersicht kürzlich gespeicherter Lesezeichen erhalten
suggest_tags	Tag-Vorschläge für Lesezeichen ohne Tags erhalten
explore_knowledge Pro	Deine Wissensdatenbank zu einem Thema durchsuchen, das Festgehaltene zusammenfassen und Lücken hervorheben

Fehlerbehebung

Fehler „Unauthorized" oder „Missing authentication"

Prüfe deinen API-Schlüssel noch einmal. Klicke in der Linkflare-App auf dein Benutzermenü (oben rechts) und wähle API-Schlüssel kopieren, um den exakten Schlüssel zu kopieren. Stelle sicher, dass keine zusätzlichen Leerzeichen vorhanden sind und der vollständige Schlüssel enthalten ist.

Tools erscheinen nicht in Claude Desktop

Stelle sicher, dass du Claude Desktop vollständig beendet hast (nicht nur das Fenster geschlossen) und neu geöffnet hast.
Prüfe noch einmal, dass der Connector-Name linkflare und die URL genau https://mcp.linkflare.io/mcp lautet (kein abschließender Schrägstrich).
Überprüfe, dass die OAuth Client ID in den Advanced settings auf linkflare-claude gesetzt ist.

Keine Ergebnisse bei der Suche

Die Suche ist eine Volltextsuche. Wenn eine Anfrage keine Ergebnisse liefert, versuche es mit allgemeineren Begriffen. Du kannst auch nach Sammlung, Tags oder Typ statt nach Text filtern.

Sammlung oder Tag nicht gefunden

Du kannst Sammlungs- und Tag-Namen verwenden (nicht nur IDs). Der Namensabgleich ist nicht zwischen Groß- und Kleinschreibung unterscheidend, also funktionieren sowohl „rezepte" als auch „Rezepte".

Wissens-Tools geben „Forbidden" oder „Pro plan required" zurück

Die Wissens-Tools (search_knowledge, add_knowledge, get_knowledge, update_knowledge, delete_knowledge, list_knowledge_children sowie der Prompt explore_knowledge) sind auf Pro-Konten beschränkt. Die Tools für Lesezeichen, Sammlungen und Tags funktionieren im kostenlosen Tarif. Führe das Upgrade auf der Preisseite durch.

Ich habe eine Wissenskarte gelöscht, aber meine untergeordneten Karten sind weg

delete_knowledge wirkt kaskadierend – das Löschen einer übergeordneten Karte entfernt jede darunter verschachtelte Karte. Wenn die KI anbietet, eine Karte mit untergeordneten Karten zu löschen, prüfe es noch einmal, bevor du zustimmst. Um ohne Verlust der untergeordneten Karten aufzuräumen, verschiebe diese zuerst mit update_knowledge (setze parent_id auf 0 für die Wurzel oder auf die ID einer anderen Karte).

Datenschutz & Sicherheit

Dein API-Schlüssel identifiziert dein Konto. Der MCP-Server greift nur auf deine persönlichen Lesezeichen zu – er kann die Daten anderer Benutzer nicht sehen. Die gesamte Kommunikation ist über HTTPS verschlüsselt.

Der KI-Assistent sieht nur, worum du ihn bittest. Er hat keinen dauerhaften Zugriff auf deine vollständige Bibliothek, sofern du das nicht ausdrücklich anforderst.