Aller au contenu

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

  1. Exécutez la commande ci-dessus dans votre terminal. Elle enregistre le serveur dans la portée locale ; ajoutez --scope user pour le rendre disponible dans tous les projets, ou --scope project pour le partager via .mcp.json.

  2. Exécutez claude mcp list, ou lancez claude puis exécutez /mcp. quran-gallery doit apparaître comme connecté.

    Un terminal : claude mcp add enregistre quran-gallery, et claude mcp list l'affiche comme Connected.

  3. 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 :

Un terminal : Claude Code trouve le hadith dans Sahih al-Bukhari, édition Sultaniyya, 1/6, et dans Sunan Ibn Majah, édition d'al-Arnaut, 5/305, chacun avec son lien Maktabah et le texte 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 /mcp et reconnectez le serveur, ou redémarrez claude ; 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 /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é. 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.

Modifier cette page sur GitHub