Connecter une IA à la bibliothèque Shamela : démarrage
Ajoutez le serveur MCP de Quran Gallery à ChatGPT, Claude, Cursor, VS Code ou Gemini CLI par URL. Sans compte ni clé. Lancez une première recherche citée.
Sur cette page
Collez une URL dans votre assistant et posez une question. Aucun compte ni aucune clé n’est nécessaire pour commencer ; une clé gratuite relève les limites quand vous en avez besoin.
1. Ajouter le serveur
Le serveur parle MCP en streamable HTTP à l’adresse :
https://qurangallery.com/mcp/shamelaCette URL suffit à un client. L’endroit où la coller dépend de l’application :
| Vous utilisez | Où coller l’URL | Guide |
|---|---|---|
| ChatGPT | Plugins → Add → Add custom MCP server, Authentication No authentication | Pas à pas, avec captures d’écran |
| Claude (claude.ai, Claude Desktop) | Settings → Connectors → + Add → Add custom connector | Pas à pas, avec captures d’écran |
| Claude Code | Une commande dans le terminal | Claude Code |
| Gemini CLI | Une commande dans le terminal | Gemini CLI |
| Cursor | ~/.cursor/mcp.json | Cursor |
| VS Code, GitHub Copilot | .vscode/mcp.json | VS Code, Copilot |
ChatGPT : ouvrez ChatGPT Plugins, cliquez sur Add → Add custom MCP server, nommez-le Quran Gallery et collez l’URL. Réglez Authentication sur No authentication, car le champ démarre sur OAuth, qui échoue. Cochez I understand and want to continue, cliquez sur Create as a plugin, puis sur Connect. Les comptes plus anciens passent par Settings → Apps & Connectors → Advanced settings → Developer mode → Create. Pas à pas.
Claude (claude.ai et Claude Desktop) : ouvrez Settings → Connectors (certaines versions : Customize → Connectors), cliquez sur + Add → Add custom connector, nommez-le Quran Gallery, collez l’URL et cliquez sur Continue. Gardez No sign-in, cliquez sur Add, puis sur Connect. Activez-le pour une conversation depuis + → Connectors. Pas à pas.
Claude Code (détails) :
claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaGemini CLI (détails) :
gemini mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaCursor (détails) — dans ~/.cursor/mcp.json :
{
"mcpServers": {
"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
}
}VS Code et GitHub Copilot (VS Code, Copilot) — dans .vscode/mcp.json :
{
"servers": {
"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
}
}Fichier de configuration de Claude Desktop : Claude Desktop ne se connecte pas à un serveur distant inscrit dans claude_desktop_config.json sous forme d’entrée "url" ; une configuration copiée du bloc Cursor ci-dessus y échoue donc. Ajoutez plutôt le serveur dans Settings → Connectors (Claude). Si vous avez besoin du fichier de configuration, passez par la passerelle mcp-remote, qui nécessite Node.js :
{
"mcpServers": {
"quran-gallery": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://qurangallery.com/mcp/shamela"]
}
}
}Enregistrez le fichier et redémarrez Claude Desktop.
Les noms de menus changent d’une version à l’autre. Si les vôtres diffèrent, cherchez connecteurs, intégrations ou serveurs MCP dans les paramètres du client — tout client qui accepte une URL MCP distante convient.
Utilisez le chemin complet,
/mcp/shamela. L’adresse/mcpseule est la page qui décrit le serveur, pas le point d’accès, et y pointer un client ne fonctionnera pas.
2. Poser une question
Redémarrez votre client s’il vous le demande, puis posez une question qui nécessite un texte :
Trouvez le hadith « إنما الأعمال بالنيات » dans les recueils primaires et dites-moi exactement sur quelle page imprimée il se trouve.
Votre assistant devrait appeler shamela_search_library, et la réponse devrait nommer un livre, une impression et une page — pour ce hadith, صحيح البخاري, ط السلطانية, page 1/6.
S’il répond de mémoire au lieu d’appeler l’outil, dites-le-lui directement : « Utilise l’outil de la bibliothèque Quran Gallery et cite la page imprimée qu’il renvoie. »
3. Vérifier la connexion
Votre client devrait lister 15 outils, à commencer par shamela_search_library (voir la liste complète des outils). S’il n’en liste aucun, le serveur est injoignable — voir Limites et erreurs.
Vous pouvez aussi vérifier à la main :
curl -X POST https://qurangallery.com/mcp/shamela
-H "Content-Type: application/json"
-H "Accept: application/json, text/event-stream"
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'La réponse est un objet JSON listant les outils, shamela_search_library en premier. Sans clé, lister les outils ne consomme pas votre quota d’appels d’outil.
4. Facultatif : ajouter une clé pour des limites plus hautes
Sans clé, vous disposez de 10 appels d’outil par minute et de 200 par jour par adresse IP, et les deux lecteurs de plages de pages renvoient quelques pages par appel (voir Limites et erreurs). Cela suffit pour essayer le serveur et faire des recherches occasionnelles. Pour des sessions de recherche, ou tout ce que vous construisez dessus, une clé gratuite est disponible : 60 appels par minute, sans plafond quotidien, plages de pages complètes. Passez cette section tant que vous n’atteignez pas une limite.
Connectez-vous à votre compte Quran Gallery, allez dans Développeurs et créez une clé avec un nom descriptif.
La clé complète n’est affichée qu’une seule fois, à la création. Copiez-la à ce moment-là — seuls les premiers caractères restent visibles ensuite. Les clés ressemblent à ceci :
qg_sk_ghjKm4x…sk signifie secret key (clé secrète). Traitez-la exactement comme un mot de passe : elle vous authentifie vous, elle a sa place dans un gestionnaire de mots de passe ou un coffre de secrets, et elle ne doit jamais être versée dans git ni collée dans un ticket public.
Envoyez-la comme jeton bearer à chaque requête. Dans un fichier de configuration :
{
"mcpServers": {
"quran-gallery": {
"type": "http",
"url": "https://qurangallery.com/mcp/shamela",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}Ou avec Claude Code :
claude mcp add --transport http quran-gallery
https://qurangallery.com/mcp/shamela
--header "Authorization: Bearer qg_sk_your_key_here"La clé ne circule que dans Authorization: Bearer … — pas de paramètre d’URL, pas de flux OAuth. Un client qui n’accepte qu’une simple URL reste aux limites sans clé.
Les détails sur la création, la rotation et la révocation des clés se trouvent dans Clés d’API.
Étapes suivantes
Questions
Comment connecter un assistant IA à la bibliothèque Shamela ?
Collez https://qurangallery.com/mcp/shamela dans toute application qui accepte un serveur MCP distant, comme ChatGPT, Claude, Claude Code, Gemini CLI, Cursor, VS Code ou GitHub Copilot, puis posez une question qui demande un texte.
Faut-il un compte ou une clé API ?
Non. Une clé gratuite est facultative et porte la limite à 60 appels par minute si vous en avez besoin.
Comment ajouter le serveur à ChatGPT ?
Ouvrez ChatGPT Plugins, choisissez Add puis Add custom MCP server, nommez-le Quran Gallery, collez l'URL et réglez Authentication sur No authentication.
Comment ajouter le serveur à Claude ?
Ouvrez Settings, puis Connectors, choisissez Add puis Add custom connector, nommez-le Quran Gallery, collez l'URL, gardez No sign-in, puis cliquez sur Add et Connect.
Comment vérifier que la connexion fonctionne ?
Votre client doit lister 15 outils, à commencer par shamela_search_library. Demandez un hadith dans les recueils primaires : la réponse doit nommer un livre, une édition et une page.
Pourquoi mon assistant répond-il de mémoire ?
Dites-le-lui directement : utilise l'outil de bibliothèque Quran Gallery et cite la page imprimée qu'il renvoie.
Quelles sont les limites gratuites ?
Sans clé, 10 appels d'outils par minute et 200 par jour par adresse IP. Avec une clé gratuite, 60 par minute et pas de plafond quotidien.