Comment utiliser FaithGPT dans Claude Code, Cowork et Claude.ai
TL;DR: Ajoutez https://api.faithgpt.io/mcp à Claude Code avec une seule commande et connectez-vous via l'écran de consentement OAuth de FaithGPT, et Claude obtient cinq outils pour la recherche d'Écritures, la recherche de versets d'actualité, les réponses fondées, la révision de la doctrine et l'écriture de dévotion. La même URL de serveur fonctionne dans Claude.ai, Claude Desktop et Cowork via leurs paramètres de connecteur.
Un modèle qui a lu la Bible en entier la citera toujours de manière erronée.
Vous êtes trois fichiers sur le site Web d'une église, en train d'écrire la copie pour une page de don, et vous demandez à Claude Romains 8:28 dans le King James. Ce qui revient se lit correctement. "Et nous savons que toutes choses concourent au bien de ceux qui aiment Dieu, de ceux qui sont appelés selon son dessein." C'est peut-être le verset. Peut-être qu'un mot a bougé. Vous n'allez pas l'attraper, car un quasi-accident sur un verset familier sonne exactement comme le verset, et la personne qui examine votre pull request vérifie les couleurs des boutons.
C’est l’échec qui rend la citation des Écritures d’IA risquée, contrairement au code d’IA. Le code cassé échoue bruyamment. Un verset mal cité est expédié, imprimé sur un bulletin et reste là.
FaithGPT exécute un serveur MCP distant qui comble cette lacune. Une fois connecté, Claude cesse de répondre aux questions bibliques de mémoire et commence à appeler un outil qui lit la propre base de données biblique de FaithGPT. Le texte du verset revient avec sa référence jointe. Vous pouvez le connecter à Claude Code en une seule commande.
Qu'est-ce que le serveur FaithGPT MCP ?
MCP est le Model Context Protocol, le standard utilisé par Anthropic pour permettre à Claude de communiquer avec des services extérieurs. Un serveur MCP distant est une URL que Claude peut appeler, et FaithGPT réside à l'adresse :
Il parle HTTP Streamable sans état sur JSON-RPC 2.0. L'autorisation est un code d'autorisation OAuth 2.0 avec PKCE, avec enregistrement client dynamique et découverte de ressources protégées RFC 9728, ce qui est une manière ennuyeuse de dire que vous ne manipulez jamais de clé. Votre client s'enregistre lui-même, votre navigateur ouvre le propre écran de connexion et de consentement de FaithGPT, vous approuvez openid profile email faithgpt:mcp et le jeton appartient à votre compte.
Cinq outils se présentent :
lookup_scripture prend une référence telle que John 3:16, Psalm 23 ou Romans 8:28-39 et renvoie le texte du passage en KJV, ASV ou YLT. KJV est la valeur par défaut. Il s’agit de l’outil de récupération, et c’est celui qui résout le problème des citations erronées.
find_scripture_by_topic va dans l'autre sens. Donnez-lui un thème, une situation ou un mot-clé et il renvoie les passages pertinents avec une brève explication. Vous pouvez l'étendre à l'Ancien Testament, au Nouveau, ou aux deux, et le limiter entre un et dix résultats.
ask_faithgpt envoie une question complète dans FaithGPT et renvoie une réponse basée sur les Écritures avec des citations. Utilisez-le lorsque la question nécessite une réponse plutôt qu’un verset.
review_doctrine prend un bloc de texte, jusqu'à 20 000 caractères, et l'examine pour en vérifier la solidité théologique et l'utilisation responsable des Écritures. FaithGPT est explicite sur le fait qu’il s’agit d’une orientation et non d’un conseil pastoral qualifié, ce qui est la bonne ligne à suivre pour un outil.
create_devotional construit une dévotion autour d'un thème, éventuellement ancré à un verset, avec une durée et un public que vous choisissez. Il renvoie un titre, un passage, une réflexion et une prière. Il ne publie ni n’enregistre rien.
La partie qui mérite d'être lue deux fois : ce connecteur ne peut pas lire ou modifier vos données privées FaithGPT. Journaux, prières, notes, souvenirs, conversations, médias, votre abonnement, vos paramètres, tout cela est interdit. Il lit les Écritures et génère du contenu. L'accès est révocable chaque fois que vous le souhaitez.
##Claude Code
Une commande :
Confirmez ensuite qu'il a atterri :
La première fois que Claude appelle l'un des outils, le flux de consentement FaithGPT s'ouvre dans votre navigateur. Vous vous connectez et approuvez les étendues, et c'est toute la configuration. Rien n'est collé dans un fichier de configuration et aucune clé API n'existe pour fuir.
Pour vérifier la connexion par vous-même :
Vous recherchez un statut de Connected. Au sein d'une session, /mcp vous montre les serveurs dont dispose Claude Code et vous permet de gérer l'authentification si un serveur s'y trouve sans autorisation.
Après cela, vous demandez en anglais. "Recherchez Hébreux 12 :1-2 dans KJV et mettez-le dans la section des héros." Claude choisit lookup_scripture seul, car les descriptions des outils lui indiquent quand chacun s'applique. Vous ne nommez pas les outils.
Choisir une portée
L'indicateur --scope décide qui obtient le serveur.
--scope user est ce que la commande ci-dessus utilise, et c'est la bonne valeur par défaut pour un développeur solo. Le serveur vous suit dans chaque projet sur cette machine, vous le configurez donc une seule fois.
--scope local le conserve pour le projet en cours et pour vous.
--scope project écrit le serveur dans un fichier .mcp.json à la racine du référentiel :
Validez ce fichier et tous ceux qui clonent le dépôt se voient proposer le serveur. Leur code Claude leur demandera de l'approuver avant de se connecter, et chaque personne se connecte toujours à son propre compte FaithGPT, donc personne n'hérite de vos crédits ou de votre identité. Pour une équipe qui crée un produit d'église, c'est ainsi que vous faites des Écritures vérifiées la valeur par défaut au lieu d'une chose qu'un développeur se souvient de faire.
Claude.ai et Claude Desktop
Les connecteurs personnalisés sur claude.ai utilisent la même URL du serveur MCP. Dans vos paramètres, il y a une section de connecteurs avec une option pour ajouter un connecteur personnalisé, où vous collez :
Je couvre volontairement le libellé exact du menu. Anthropic déplace ces étiquettes entre les versions, et l'instruction honnête est d'ouvrir vos paramètres et de rechercher des connecteurs plutôt que de vous fier à une capture d'écran du moment où cela a été écrit. Ce qui ne bouge pas, c'est l'URL et ce qui se passe après que vous l'ayez soumise : la connexion à FaithGPT s'ouvre, vous approuvez les quatre mêmes étendues et les cinq outils apparaissent dans votre liste de connecteurs.
Claude Desktop s'appuie sur la même configuration de connecteur que l'application Web, donc sa configuration en un seul endroit couvre les deux.
Deux mises en garde à connaître avant de partir chercher. Les connecteurs personnalisés ne sont pas disponibles sur tous les forfaits, et si votre compte appartient à une organisation, un administrateur peut restreindre les connecteurs que les utilisateurs sont autorisés à ajouter. Si l'option est complètement absente, c'est généralement la raison plutôt que quoi que ce soit du côté de FaithGPT.
Travail en collaboration
Cowork utilise le système de connecteurs de Claude, donc la même URL fonctionne. Je ne vais pas inventer le chemin du clic. Anthropic a livré Cowork rapidement et la navigation a été déplacée, alors ouvrez ses paramètres, recherchez où les connecteurs sont gérés et collez-y l'URL du serveur. Le flux OAuth se comporte de la même manière une fois que vous le faites.
Le cowork est l’endroit où ce connecteur gagne le plus, et la raison en est la forme du travail. Les sessions de cowork durent plus longtemps et s'appuient sur des documents contrairement aux sessions de codage. Préparer une étude, réviser un manuscrit. C’est exactement le genre de travail où un mauvais verset survit jusqu’au public.
Que faire avec ?
Préparation du sermon à côté d'un build
Vous expédiez le site Web d'une église le jeudi et le pasteur a besoin de la liste de passage pour le dimanche. Plutôt que de changer de contexte, vous demandez au cours de la même session des passages sur la persévérance dans les deux Testaments, vous en récupérez cinq avec des références et vous les collez dans le fichier de notes déjà ouvert dans l'éditeur.
Révision de la doctrine sur la copie générée
C'est le flux de travail que je configurerais en premier. Il est très facile de se tromper légèrement dans une copie marketing d'un produit chrétien, et l'erreur est théologique plutôt que grammaticale, donc une critique normale la manque. Rédigez la page à propos, puis remettez-la à review_doctrine avant qu'elle ne soit adressée à un concepteur. Il signale les domaines dans lesquels les Écritures accomplissent un travail pour lequel elles n’ont pas été écrites. Traitez le résultat comme une invitation à réfléchir plutôt que comme un verdict.
Dévotions à partir d'un dépôt partagé
Placez le serveur dans .mcp.json, validez-le et votre équipe de contenu génère des dévotions dans le même référentiel où réside le site, sous les mêmes contrôles de compte, avec chaque brouillon ancré à un passage réel. L'outil ne publie rien, donc un humain décide toujours de ce qui est expédié.
Vérification des références sur tout ce dont vous avez hérité
Pointez Claude vers un répertoire de contenu existant et demandez-lui de vérifier chaque référence biblique par rapport à lookup_scripture. C’est un travail ennuyeux que personne ne fait, c’est pourquoi les sites d’anciennes églises regorgent de références qui ont dérivé il y a des années. Un modèle qui le parcourt en boucle trouvera ceux qu’une personne survole.
Limites, coût et problèmes rencontrés
Les appels d'outils utilisent vos crédits FaithGPT et sont attribués au compte avec lequel vous vous êtes connecté. Cela vaut la peine de le dire clairement : il ne s'agit pas d'un canal secondaire gratuit vers FaithGPT, il s'agit de votre compte accessible depuis un autre client. Si vous brûlez un lot de dévotions dans Cowork, les crédits sont prélevés sur le même solde que celui utilisé par l'application Web. Les forfaits et les montants des crédits sont disponibles sur la page de tarification .
Votre client peut vous demander d'approuver chaque appel d'outil plutôt que de les exécuter en silence. C'est délibéré. FaithGPT marque ces outils comme ayant des effets secondaires, car ils rédigent des enregistrements d'utilisation et peuvent dépenser des crédits, et un client honnête au sujet des effets secondaires vérifiera avec vous.
La recherche des Écritures couvre KJV, ASV et YLT. Si vous avez besoin d'une traduction en dehors de cet ensemble, cet outil ne vous la fournira pas et vous ne devez pas laisser un modèle combler le vide de votre mémoire. C’est exactement le comportement que le connecteur vise à empêcher.
Si les outils n’apparaissent jamais, parcourez-les dans l’ordre. Exécutez claude mcp get faithgpt et lisez le statut. S'il ne s'agit pas de Connected, le flux OAuth ne s'est probablement pas terminé, alors déclenchez un appel d'outil et surveillez l'onglet du navigateur. Si rien ne s'ouvre, vérifiez si un bloqueur de popups l'a mangé. Sur claude.ai, confirmez que votre forfait autorise les connecteurs personnalisés et qu'un administrateur ne les a pas restreints.
Vous pouvez également vérifier le serveur lui-même sans qu'aucun client ne soit impliqué :
Cela renvoie les métadonnées des ressources protégées de FaithGPT. S'il répond et que votre client ne parvient toujours pas à se connecter, le problème vient du côté client.
Quand vous voulez plutôt l'API
MCP convient au travail interactif, où une personne est au courant et Claude décide quel outil lui convient. Pour tout ce qui est scripté, un travail de nuit ou un serveur qui a besoin de réponses FaithGPT sans que personne ne regarde, utilisez plutôt l'API REST. Il est compatible OpenAI :
Vous vous authentifiez avec une clé du tableau de bord API plutôt qu'avec OAuth, et la référence complète se trouve sur faithgpt.io/api .
La ligne de démarcation est simple. Si une personne regarde, utilisez le connecteur. Si une tâche cron existe, utilisez la clé.
Commencez par un verset
Ajoutez le serveur, demandez à Claude un passage que vous connaissez bien et vérifiez le résultat par rapport à votre propre Bible. Once you have watched it come back right, from a database rather than from a model's recollection, the reason to leave it connected becomes obvious.
Vous pouvez voir tout ce que FaithGPT fait avec cette même Écriture fondée sur faithgpt.io .
Helpful Scripture resources
Contact & support
Email the FaithGPT team at hello@faithgpt.io or visit the contact page .
Explore FaithGPT
