Ajouter le serveur MCP de la bibliothèque islamique à Claude Code
Une commande ajoute le serveur MCP de Quran Gallery à Claude Code : livres arabes classiques, pages imprimées citées, sans compte ni clé.
Sur cette page
Ni compte, ni connexion, ni clé. Une seule commande :
claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaÉtapes
Exécutez la commande ci-dessus dans votre terminal. Elle enregistre le serveur dans la portée locale ; ajoutez
--scope userpour le rendre disponible dans tous les projets, ou--scope projectpour le partager via.mcp.json.Exécutez
claude mcp list, ou lancezclaudepuis exécutez/mcp.quran-gallerydoit apparaître comme connecté.
Posez une question qui nécessite un texte (ci-dessous). Claude Code demande confirmation avant d’exécuter chaque outil pour la première fois. Approuvez-le.
La réponse donne chaque édition avec son volume, sa page imprimée et son lien Maktabah, et cite l’arabe :

Pour le retirer : claude mcp remove quran-gallery.
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
- 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, ou ajoutez une clé gratuite (ci-dessous). 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 client n’affiche aucun outil, attendez une minute et reconnectez-vous. - Les outils n’apparaissent pas, ou un outil attendu manque. Exécutez
/mcpet reconnectez le serveur, ou redémarrezclaude; la liste des outils est lue à la connexion du serveur. - La connexion échoue immédiatement. Le point d’accès est
/mcp/shamela; l’adresse/mcpseule 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é. Créez-en une sur la page Développeurs de votre compte Quran Gallery (fonctionnement des clés), puis envoyez-la comme jeton bearer.
Ajoutez-la avec --header :
claude mcp add --transport http quran-gallery
https://qurangallery.com/mcp/shamela
--header "Authorization: Bearer qg_sk_your_key_here"Traitez la clé comme un mot de passe et gardez-la hors de git.
Étapes suivantes
Questions
Comment ajouter un serveur MCP à Claude Code ?
Lancez dans le terminal : claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamela. Aucun compte, connexion ni clé n'est nécessaire.
Comment vérifier que le serveur est connecté dans Claude Code ?
Lancez claude mcp list, ou démarrez claude puis /mcp. quran-gallery doit apparaître connecté. Si les outils manquent, reconnectez depuis /mcp ou relancez claude.
Comment rendre le serveur disponible dans tous les projets ?
Ajoutez --scope user à la commande. La portée par défaut est locale, et --scope project le partage avec l'équipe via .mcp.json.
Comment ajouter une clé API dans Claude Code ?
Ajoutez --header "Authorization: Bearer qg_sk_your_key_here" à la commande claude mcp add. La clé est facultative et porte la limite à 60 appels par minute.
Pourquoi l'erreur 429 Keyless limit reached apparaît-elle ?
Sans clé, 10 appels d'outils par minute et 200 par jour sont permis pour chaque adresse IP. Attendez la durée de l'en-tête Retry-After ou ajoutez une clé gratuite.
Comment retirer le serveur de Claude Code ?
Lancez claude mcp remove quran-gallery.