LogoBibGenie-Dokumentation

MCP

Verwende den lokalen MCP-Server von BibGenie, damit externe Clients auf Zotero-Werkzeuge zugreifen können.

MCP steht für Model Context Protocol. BibGenie kann einen lokalen MCP-Server starten, über den MCP-kompatible Clients auf Zotero-bezogene Werkzeuge zugreifen können.

Die meisten Nutzer benötigen MCP nicht

Wenn du nur innerhalb des BibGenie-Plugins chattest, musst du MCP nicht konfigurieren. MCP ist vor allem für fortgeschrittene Nutzer, externe Clients und automatisierte Workflows gedacht.

Was kann MCP tun?

Externe Clients können BibGenies Zotero-Werkzeuge verwenden, um:

  • Zotero-Einträge zu suchen
  • semantische Literatursuchen auszuführen
  • PDF-Anhänge zu lesen
  • Snapshots zu lesen
  • Zotero-Notizen zu lesen
  • Tags und Sammlungen aufzulisten
  • Zotero-Notizen zu erstellen
  • Tags und Sammlungen zu verwalten
  • Metadaten abzurufen oder zu bearbeiten

Was ist Zotero MCP?

Zotero MCP ist BibGenies lokale Brücke zwischen deiner Zotero-Bibliothek und externen KI-Clients. Statt Dateien zu exportieren oder Metadaten manuell zu kopieren, kann ein MCP-kompatibler Client BibGenie über ein lokales Protokoll nach Zotero-Kontext fragen.

Ein externer Client kann zum Beispiel deine Bibliothek durchsuchen, Sammlungen prüfen, einen PDF-Anhang lesen oder eine Zotero-Notiz über BibGenies MCP-Werkzeuge erstellen.

Kernvorteile

Eingebaut

BibGenies MCP-Server läuft im Zotero-Plugin. Du brauchst keinen separaten Python-Dienst und kein eigenes lokales Backend.

Standardmäßig lokal

Der MCP-Endpunkt läuft auf Zotero's lokalem HTTP-Server. Dein externer Client spricht auf deinem eigenen Gerät mit Zotero.

Für Forschung gemacht

Die Werkzeuge sind für Zotero-Workflows gebaut: Paper, PDFs, Sammlungen, Tags, Notizen, Snapshots und Metadaten.

Gut für externe Workflows

MCP lässt Werkzeuge wie Cursor, Claude Code, Claude Desktop und Cherry Studio Zotero-Kontext verwenden, ohne ihre eigene Oberfläche zu verlassen.

Kernfunktionen

FunktionWobei sie hilft
EintragssuchePaper nach Titel, Autor, Publikation, Schlüsselwort oder Thema finden.
Semantische SucheVerwandte Paper nach Bedeutung finden, nicht nur nach exakten Schlüsselwörtern.
MetadatenzugriffDetaillierte Zotero-Metadaten lesen, bevor zitiert, organisiert oder bearbeitet wird.
PDF-LesenText aus Zotero-PDF-Anhängen lesen, wenn ein Client Paper-Inhalt benötigt.
Visuelles PDF-LesenPDF-Seiten als Bilder rendern, wenn Abbildungen, Tabellen oder gescannte Seiten visuell geprüft werden müssen.
Notizen und SnapshotsZotero-Notizen und Web-Snapshots aus deiner Bibliothek lesen.
BibliotheksorganisationSammlungen und Tags auflisten, Sammlungen erstellen und Tags oder Sammlungszuordnung verwalten.
Kontrolliertes SchreibenVertrauenswürdige Clients können über explizite MCP-Tool-Aufrufe Notizen erstellen oder Metadaten bearbeiten.

Plugin-Chat vs. MCP

ModusAm besten fürEinrichtung erforderlich
BibGenie In-Plugin-ChatDie meisten NutzerNein
Lokaler MCP-ServerNutzer, die Zotero mit externen KI-Clients verbindenJa

Servertyp und URL

BibGenies MCP-Server verwendet Streamable HTTP. Die Server URL sieht normalerweise so aus:

http://127.0.0.1:23119/bibgenie/mcp

Der Port kann abweichen, wenn dein Zotero-HTTP-Server einen benutzerdefinierten Port verwendet. Kopiere immer die Server URL aus den BibGenie-Einstellungen, anstatt sie von Hand einzugeben.

Teste MCP nicht durch direktes Öffnen der URL im Browser

MCP-Clients verbinden sich über HTTP POST JSON-RPC. Die Browser-Adresszeile sendet einen GET-Request und ist kein zuverlässiger MCP-Verbindungstest. Verwende Test Connection in den BibGenie-Einstellungen oder einen MCP-Client.

MCP-Server aktivieren

Öffne die BibGenie-Einstellungen.

Suche den Abschnitt MCP Server.

Aktiviere Enable MCP Server.

Kopiere die angezeigte Server URL.

Füge die URL in deinen externen MCP-Client ein.

Klicke auf Test Connection, um die Verbindung zu prüfen.

Externe Clients verbinden

Verwende die Server URL aus den BibGenie-Einstellungen in Clients, die Streamable HTTP MCP unterstützen.

Cursor

Cursor kann sich direkt mit BibGenies Streamable-HTTP-Endpunkt verbinden.

Öffne Cursor Settings und gehe zu Tools & MCP.

Klicke auf + New MCP Server.

Füge diese Konfiguration ein:

{
  "mcpServers": {
    "ZoteroBibGenie": {
      "url": "http://127.0.0.1:23119/bibgenie/mcp"
    }
  }
}

Ersetze die URL, wenn BibGenie einen anderen Port anzeigt.

Speichere die Konfiguration. Sobald Cursor den MCP-Server als verbunden anzeigt, kannst du Zotero-Kontext im Cursor-Chat verwenden.

Claude Code

Claude Code unterstützt HTTP-MCP-Server direkt:

claude mcp add ZoteroBibGenie --transport http http://127.0.0.1:23119/bibgenie/mcp

Ersetze die URL, wenn BibGenie einen anderen Port anzeigt.

Claude Desktop

Einige Claude Desktop-Versionen verbinden stdio-MCP-Server zuverlässiger als lokale HTTP-Endpunkte. Verwende dann mcp-remote als Brücke von Claude Desktop zu BibGenies lokalem HTTP-Server.

Installiere Node.js, falls node und npx auf deinem System nicht verfügbar sind.

Öffne Claude Desktop.

Öffne Settings und gehe zum Bereich Developer.

Klicke auf Edit Config, um claude_desktop_config.json zu öffnen.

Füge diese Konfiguration hinzu:

{
  "mcpServers": {
    "ZoteroBibGenie": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:23119/bibgenie/mcp"]
    }
  }
}

Ersetze die URL, wenn BibGenie einen anderen Port anzeigt.

Speichere die Datei und starte Claude Desktop neu.

Cherry Studio

Cherry Studio unterstützt Streamable HTTP MCP direkt.

Öffne Cherry Studio Settings und wechsle zum Tab MCP.

Klicke auf Add und wähle Quick Create.

Fülle aus:

  • Name: ZoteroBibGenie
  • Type: Streamable HTTP
  • URL: die aus BibGenie kopierte Server URL

Cherry Studio MCP setup fields

Optional: Öffne Advanced Settings und setze:

  • Provider URL: https://www.bibgenie.com/
  • Logo URL: https://www.bibgenie.com/favicon.png

Cherry Studio MCP advanced settings

Klicke auf Save, schalte den Dienst ein und nutze den Verify-Button von Cherry Studio, um die Verbindung zu prüfen.

Beispiel-Prompts

  • "Finde Zotero-Paper zu Retrieval-Augmented Generation nach 2023."
  • "Lies den PDF-Anhang dieses Zotero-Eintrags und fasse den Kernbeitrag zusammen."
  • "Liste Einträge in meiner Machine-Learning-Sammlung auf und finde fehlende Jahresangaben."

Sicherheitsempfehlungen

  • Teile die MCP Server URL nur mit Clients, denen du vertraust.
  • Sei vorsichtig mit Werkzeugen, die in deine Zotero-Bibliothek schreiben, etwa Notizen erstellen, Metadaten bearbeiten oder Tags und Sammlungen verwalten.
  • Schalte den Server aus, wenn du MCP nicht verwendest.
  • Wenn sich ein externer Client unerwartet verhält, stoppe den MCP-Server und prüfe die Client-Konfiguration.

FAQ

On this page