Aller au contenu

Connecter ChatGPT à la bibliothèque Shamela

Ajoutez le serveur MCP de Quran Gallery à ChatGPT pas à pas, captures à l'appui : une URL, No authentication, puis cherchez dans 8 594 livres arabes.

Sur cette page

Ni compte, ni connexion, ni clé. Ajoutez cette URL à ChatGPT comme serveur MCP personnalisé et réglez Authentication sur No authentication :

https://qurangallery.com/mcp/shamela

La configuration prend environ une minute. Elle a fonctionné sur un compte ChatGPT Free au moment de la rédaction de ce guide (octobre 2026). Sur un espace de travail Business ou Enterprise, un administrateur devra peut-être d’abord autoriser les serveurs MCP personnalisés.

1. Ouvrir Plugins et ajouter un serveur personnalisé

Ouvrez chatgpt.com/plugins. En haut à droite, cliquez sur Add, puis sur Add custom MCP server.

Le menu Add en haut à droite de la page Plugins de ChatGPT : Create plugin, Upload plugin archive, Add custom MCP server.

2. Remplir le formulaire

ChampÀ saisir
Icon (optional)quran-gallery-icon.png : téléchargez-la, puis cliquez sur + et choisissez le fichier
NameQuran Gallery
Description (optional)Search classical Arabic Islamic books with printed-page citations
ConnectionGardez Server URL sélectionné et collez https://qurangallery.com/mcp/shamela
AuthenticationNo authentication

Cochez I understand and want to continue, puis cliquez sur Create as a plugin.

La boîte de dialogue Add custom MCP server remplie : l'icône, le nom et la description de Quran Gallery, Server URL https://qurangallery.com/mcp/shamela, Authentication réglé sur No authentication, et la case I understand cochée.

Saisissez l’URL vous-même ou copiez-la depuis cette page. Un lien copié depuis un e-mail peut être une redirection google.com/url?q=… plutôt que l’adresse elle-même, et ChatGPT la rejette.

3. Connexion

ChatGPT affiche ce que le plugin peut faire. Cliquez sur Connect. Un message confirme Quran Gallery is now connected.

L'écran Connect Quran Gallery avec son bouton Connect.

4. Vérifier l’installation

Ouvrez Settings → Plugins. Quran Gallery apparaît dans la liste avec son icône. Tous ses outils sont en lecture seule.

Les paramètres des plugins de ChatGPT, avec Quran Gallery dans la liste des plugins installés.

5. L’utiliser dans une conversation

Démarrez une nouvelle conversation. Cliquez sur + dans la zone de message et choisissez Quran Gallery. Posez ensuite votre question.

Le menu + d'une nouvelle conversation ChatGPT, avec Quran Gallery dans la liste.

La réponse nomme l’édition, le volume et la page imprimée, et renvoie vers cette page dans le lecteur Maktabah :

Une réponse de ChatGPT utilisant Quran Gallery : Sahih al-Bukhari, édition Sultaniyya, volume 1 page 6, hadith 1, avec un lien vers la page sur Shamela.

Gérer, actualiser ou supprimer

Ouvrez Settings → Plugins et cliquez sur Quran Gallery. Sous Manage app, vous pouvez le renommer, utiliser Refresh tools lorsque notre serveur ajoute un outil, ou Delete app.

La section Manage app du plugin : App name, App description, Refresh tools et Delete app.

Vous ne pouvez modifier ni l’URL du serveur ni l’icône une fois le plugin créé. Pour changer l’une ou l’autre, supprimez le plugin et ajoutez-le à nouveau.

Deep research

La recherche approfondie (deep research) et la connaissance d’entreprise de ChatGPT exigent deux outils en lecture seule nommés search et fetch. Ce serveur propose les deux, et les liste à tous les clients avec les autres outils. search prend une requête et renvoie des results avec id, title et url ; fetch prend un id et renvoie id, title, text, url et metadata. L’url de chaque résultat est la page dans le lecteur Maktabah.

Premier prompt à essayer

Trouvez le hadith «إنما الأعمال بالنيات» dans les recueils primaires et dites-moi dans quel livre, quelle édition, quel volume et quelle page il est imprimé. Citez l’arabe exactement.

Votre assistant devrait appeler shamela_search_library (ou search puis fetch). Les résultats comprennent صحيح البخاري, ط السلطانية, page 1/6, avec un lien vers cette page dans le lecteur Maktabah. S’il répond de mémoire à la place, dites-lui : « Utilise l’outil de la bibliothèque Quran Gallery et cite ce qu’il renvoie. »

Les requêtes de recherche doivent être en arabe ; votre assistant traduit d’abord les termes français (détails). Des prompts prêts à l’emploi pour le takhrīj, la citation d’un passage et la comparaison de tafsirs figurent dans la liste complète des outils.

Dépannage

  • « Some app settings were rejected. Check the server URL or tunnel ID, icon, and authentication settings. » Vérifiez trois points. L’URL doit être exactement https://qurangallery.com/mcp/shamela, et non un lien de redirection provenant d’un e-mail. Authentication doit être réglé sur No authentication. L’icône doit être un PNG d’au moins 256×256 pixels et de moins de 10 Ko ; la nôtre respecte ces critères, et vous pouvez aussi vous passer d’icône. Si vous avez essayé avant notre correctif, ajoutez à nouveau le serveur.
  • « Couldn’t discover OAuth settings. » Authentication est resté sur OAuth. Réglez-le sur No authentication.
  • « An app with this name already exists. » Vous l’avez déjà ajouté. Supprimez d’abord l’ancien plugin (voir Gérer, actualiser ou supprimer), ou choisissez un autre nom.
  • Create as a plugin ne répond pas. Cochez d’abord la case I understand and want to continue.
  • Pas de page Plugins ni de Add custom MCP server. Les comptes plus anciens accèdent au même formulaire par Settings → Apps & Connectors → Advanced settings → Developer mode → Create. Utilisez la même URL et No authentication. Avec un compte professionnel, demandez à l’administrateur de votre espace de travail d’autoriser les serveurs MCP personnalisés.
  • 429, « Keyless limit reached ». Sans clé, vous disposez de 10 appels d’outil par minute et de 200 par jour par adresse IP. Attendez l’en-tête Retry-After. Voir Limites et erreurs.
  • 503. Le serveur ou la bibliothèque qui le soutient est brièvement indisponible. Réessayez après l’en-tête Retry-After. Si le plugin n’affiche aucun outil, attendez une minute et cliquez sur Refresh tools.
  • Les outils n’apparaissent pas, ou un outil attendu manque. ChatGPT lit la liste des outils à la création du plugin. Cliquez sur Refresh tools, puis démarrez une nouvelle conversation.
  • La connexion échoue immédiatement. Le point d’accès est /mcp/shamela. L’adresse /mcp seule est une page web, pas le serveur.

Facultatif : une clé gratuite pour des limites plus hautes

Une clé n’est jamais obligatoire. Une clé gratuite porte la limite à 60 appels par minute et lève les plafonds de plages de pages du mode sans clé. Le formulaire de serveur personnalisé de ChatGPT ne propose que OAuth ou aucune authentification, sans champ pour un en-tête bearer : ChatGPT reste donc au niveau sans clé. Si vous avez besoin de la clé, utilisez Claude, Claude Code, Cursor, VS Code ou Gemini CLI. Créez-en une sur la page Développeurs de votre compte Quran Gallery (fonctionnement des clés).

Étapes suivantes

Modifier cette page sur GitHub