LogoDocumentation BibGenie

MCP

Utilisez le serveur MCP local de BibGenie pour permettre à des clients externes d'accéder aux outils Zotero.

MCP signifie Model Context Protocol. BibGenie peut démarrer un serveur MCP local qui permet aux clients compatibles MCP d'accéder à des outils liés à Zotero.

La plupart des utilisateurs n'ont pas besoin de MCP

Si vous discutez uniquement dans le plugin BibGenie, vous n'avez pas besoin de configurer MCP. MCP s'adresse surtout aux utilisateurs avancés, aux clients externes et aux flux automatisés.

Que peut faire MCP ?

Les clients externes peuvent utiliser les outils Zotero de BibGenie pour :

  • rechercher des éléments Zotero ;
  • lancer une recherche bibliographique sémantique ;
  • lire les pièces jointes PDF ;
  • lire les instantanés ;
  • lire les notes Zotero ;
  • lister les tags et collections ;
  • créer des notes Zotero ;
  • gérer les tags et collections ;
  • obtenir ou modifier des métadonnées.

Qu'est-ce que Zotero MCP ?

Zotero MCP est le pont local de BibGenie entre votre bibliothèque Zotero et des clients IA externes. Au lieu d'exporter des fichiers ou de copier manuellement des métadonnées, un client compatible MCP peut demander du contexte Zotero à BibGenie via un protocole local.

Par exemple, un client externe peut rechercher dans votre bibliothèque, inspecter des collections, lire une pièce jointe PDF ou créer une note Zotero avec les outils MCP de BibGenie.

Avantages principaux

Intégré

Le serveur MCP de BibGenie s'exécute dans le plugin Zotero. Vous n'avez pas besoin d'un service Python séparé ni d'un backend local personnalisé.

Local par défaut

Le point d'accès MCP s'exécute sur le serveur HTTP local de Zotero. Votre client externe communique avec Zotero sur votre propre appareil.

Pensé pour la recherche

Les outils sont conçus pour les flux Zotero : articles, PDF, collections, tags, notes, instantanés et métadonnées.

Adapté aux flux externes

MCP permet à Cursor, Claude Code, Claude Desktop et Cherry Studio d'utiliser le contexte Zotero sans quitter leur propre interface.

Fonctionnalités principales

FonctionnalitéUtilité
Recherche d'élémentsTrouver des articles par titre, auteur, publication, mot-clé ou sujet.
Recherche sémantiqueDécouvrir des articles liés par le sens, pas seulement par des mots exacts.
Accès aux métadonnéesLire les métadonnées Zotero détaillées avant de citer, organiser ou modifier.
Lecture de PDFLire le texte des pièces jointes PDF Zotero lorsque le client a besoin du contenu de l'article.
Lecture visuelle de PDFRendre des pages PDF en images lorsque des figures, tableaux ou pages scannées doivent être inspectés visuellement.
Notes et instantanésLire les notes Zotero et les instantanés web de votre bibliothèque.
Organisation de bibliothèqueLister les collections et tags, créer des collections, gérer les tags ou l'appartenance aux collections.
Écriture contrôléeLes clients de confiance peuvent créer des notes ou modifier des métadonnées via des appels explicites aux outils MCP.

Chat du plugin ou MCP

ModeIdéal pourConfiguration requise
Chat BibGenie dans le pluginLa plupart des utilisateursNon
Serveur MCP localUtilisateurs qui connectent Zotero à des clients IA externesOui

Type de serveur et URL

Le serveur MCP de BibGenie utilise Streamable HTTP. La Server URL ressemble généralement à ceci :

http://127.0.0.1:23119/bibgenie/mcp

Le port peut être différent si le serveur HTTP de Zotero utilise un port personnalisé. Copiez toujours la Server URL affichée dans les paramètres BibGenie au lieu de la saisir manuellement.

Ne testez pas MCP en ouvrant directement l'URL dans un navigateur

Les clients MCP se connectent avec des requêtes HTTP POST JSON-RPC. La barre d'adresse du navigateur envoie une requête GET et ne constitue pas un test fiable. Utilisez Test Connection dans BibGenie ou un client MCP.

Activer le serveur MCP

Ouvrez les paramètres de BibGenie.

Repérez la section MCP Server.

Activez Enable MCP Server.

Copiez la Server URL affichée.

Collez l'URL dans votre client MCP externe.

Cliquez sur Test Connection pour vérifier que tout fonctionne.

Connecter des clients externes

Utilisez la Server URL des paramètres BibGenie dans les clients compatibles Streamable HTTP MCP.

Cursor

Cursor peut se connecter directement au point d'accès Streamable HTTP de BibGenie.

Ouvrez Cursor Settings et allez dans Tools & MCP.

Cliquez sur + New MCP Server.

Collez cette configuration :

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

Remplacez l'URL si BibGenie affiche un autre port.

Enregistrez la configuration. Lorsque Cursor indique que le serveur MCP est connecté, vous pouvez utiliser le contexte Zotero dans le chat Cursor.

Claude Code

Claude Code prend directement en charge les serveurs MCP HTTP :

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

Remplacez l'URL si BibGenie affiche un autre port.

Claude Desktop

Certaines versions de Claude Desktop se connectent plus facilement aux serveurs MCP stdio qu'aux points d'accès HTTP locaux. Dans ce cas, utilisez mcp-remote comme pont vers le serveur HTTP local de BibGenie.

Installez Node.js si node et npx ne sont pas disponibles sur votre système.

Ouvrez Claude Desktop.

Ouvrez Settings, puis la section Developer.

Cliquez sur Edit Config pour ouvrir claude_desktop_config.json.

Ajoutez cette configuration :

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

Remplacez l'URL si BibGenie affiche un autre port.

Enregistrez le fichier et redémarrez Claude Desktop.

Cherry Studio

Cherry Studio prend directement en charge Streamable HTTP MCP.

Ouvrez Cherry Studio Settings et passez à l'onglet MCP.

Cliquez sur Add et choisissez Quick Create.

Renseignez :

  • Name: ZoteroBibGenie
  • Type: Streamable HTTP
  • URL: la Server URL copiée depuis les paramètres BibGenie

Cherry Studio MCP setup fields

Facultatif : ouvrez Advanced Settings et définissez :

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

Cherry Studio MCP advanced settings

Cliquez sur Save, activez le service et utilisez le bouton de vérification de Cherry Studio pour tester la connexion.

Exemples de prompts

  • « Trouve dans Zotero des articles sur la génération augmentée par récupération publiés après 2023. »
  • « Lis la pièce jointe PDF de cet élément Zotero et résume la contribution principale de l'article. »
  • « Liste les éléments de ma collection machine learning et trouve ceux auxquels il manque l'année. »

Recommandations de sécurité

  • Ne partagez la MCP Server URL qu'avec des clients de confiance.
  • Soyez prudent avec les outils qui écrivent dans votre bibliothèque Zotero, par exemple la création de notes, la modification de métadonnées ou la gestion des tags et collections.
  • Désactivez le serveur lorsque vous n'utilisez pas MCP.
  • Si un client externe se comporte de manière inattendue, arrêtez le serveur MCP et vérifiez la configuration du client.

FAQ

On this page