Comment utiliser FaithGPT avec ChatGPT et Codex
TL;DR: FaithGPT expose un serveur MCP sur api.faithgpt.io/mcp et une API compatible OpenAI sur api.faithgpt.io/v1, et il existe trois façons d'y accéder à partir des outils d'OpenAI. Un GPT personnalisé avec actions est le chemin le plus fiable aujourd'hui : importez le schéma OpenAPI depuis Faithgpt.io/api/openapi.json, définissez l'authentification sur Clé API avec porteur et collez une clé fgpt_live. Un connecteur personnalisé ChatGPT pointe vers le point de terminaison MCP et se connecte via OAuth sans clé à fuir, bien que le plan d'accès aux connecteurs personnalisés continue de changer. Dans le Codex, une commande le connecte et démarre automatiquement le flux OAuth, avec une option Bearer_token_env_var pour les machines sans navigateur. Les cinq outils MCP couvrent la recherche exacte de passages, la recherche de versets d'actualité, les réponses fondées, la révision de la doctrine et les dévotions, et seule la recherche est gratuite.
Demandez à ChatGPT un verset sur l'attente de Dieu et il vous en remettra un. Demandez-lui la formulation exacte de Lamentations 3:25 dans la version KJV et il vous la remettra également, avec la même confiance. L’une de ces réponses peut être imprimée en toute sécurité sur un document. L’autre est le modèle récitant de mémoire, et la mémoire est l’endroit où les paraphrases deviennent tranquillement des citations.
J'ai vu cela mal tourner dans un petit groupe. Le verset imprimé était suffisamment proche pour que personne ne le remarque jusqu'à ce qu'une femme au troisième rang lise le sien à haute voix et que les mots ne correspondent pas. Rien de cassé. C'était juste embarrassant d'une manière qui rendait l'ensemble de la feuille moins digne de confiance.
FaithGPT publie deux portes d'entrée auxquelles les outils d'OpenAI peuvent communiquer directement, ce qui résout le problème spécifique ci-dessus : le modèle arrête de deviner les Écritures et commence à les rechercher. Il existe un serveur MCP sur https://api.faithgpt.io/mcp et une API REST compatible OpenAI sur https://api.faithgpt.io/v1. Trois façons d'y accéder, selon que vous créez un GPT pour d'autres personnes, que vous câblez votre propre compte ChatGPT ou que vous travaillez sur un terminal.
Ce que la connexion vous apporte réellement
Le serveur MCP expose cinq outils, et leurs noms valent la peine d'être connus car vous les verrez dans la sortie de l'appel d'outil :
lookup_scripture prend une référence comme Romans 8:28-39 et renvoie le texte du passage en KJV, ASV ou YLT. find_scripture_by_topic va dans l'autre sens, prenant quelque chose comme « l'espoir pendant le deuil » et revenant jusqu'à dix versets avec une brève explication. ask_faithgpt répond à une question sur la Bible, la théologie ou la vie chrétienne avec des citations jointes. review_doctrine prend un bloc de texte allant jusqu'à 20 000 caractères, ce qui correspond à peu près à un manuscrit complet de sermon, et examine sa solidité théologique et son utilisation des Écritures. create_devotional écrit une dévotion autour d'un thème, éventuellement ancrée à une référence que vous fournissez, avec des options de durée et d'audience.
La facturation se divise proprement. lookup_scripture est gratuit. Les quatre autres réservent et rapprochent les crédits avec le compte FaithGPT connecté.
La raison de s'embêter avec tout cela : FaithGPT vérifie ses réponses par rapport à un corpus de référence fourni avec chaque plan et publie l'exactitude de ses citations plutôt que de vous demander de vous appuyer sur la foi. De nombreux outils citent les Écritures. Moins vous montreront à quelle fréquence la citation est correcte.
Commencez avec un GPT personnalisé
C’est le chemin que je construirais en premier. C'est entièrement documenté du côté d'OpenAI, cela fonctionne aujourd'hui, et le résultat est partageable avec des personnes qui ne liront jamais un fichier de configuration.
Créez un nouveau GPT, ouvrez l'onglet Configurer et faites défiler jusqu'à Actions. Choisissez Créer une nouvelle action, puis Importer depuis l'URL et collez :
Il s'agit du contrat OpenAPI 3.1.1 en direct, généré à partir de l'API en cours d'exécution plutôt qu'écrit à la main, il reste donc en phase avec les points de terminaison. L'importer donne à votre GPT tous les itinéraires publiés à la fois : /v1/faithgpt/answer, /v1/chat/completions, /v1/models et /v1/usage. La plupart des GPT d’étude n’ont besoin que du premier. Supprimez les opérations dont vous ne voulez pas après l'importation, car chaque opération supplémentaire est une autre chose que le modèle peut mal choisir.
Ensuite, l'authentification. Choisissez Clé API, définissez Type d'authentification sur Porteur et collez une clé. Les clés proviennent du tableau de bord sur faithgpt.io/api et ressemblent à fgpt_live_a1b2c3.... Seul le hachage SHA-256 est stocké, de sorte que la clé complète apparaît une fois lors de la création et plus jamais. Copiez-le avant de fermer la boîte de dialogue.
Écrivez ensuite des instructions qui indiquent au GPT quand accéder à l'API au lieu de répondre de mémoire. Quelque chose de cette forme fonctionne :
Cette dernière phrase mérite sa place. Sans cela, le modèle traite un appel échoué comme une invitation à improviser, ce qui vous ramène au problème du document.
Une mise en garde qu'il est facile de manquer jusqu'à l'arrivée de la facture : la clé appartient à votre compte, donc toute personne utilisant votre GPT dépense vos crédits. Partagez une étude biblique GPT avec un groupe de quarante personnes et vous financez les questions de quarante personnes. Gardez le paramètre de partage privé ou en lien uniquement jusqu'à ce que vous connaissiez le volume.
Câblez directement le serveur MCP à ChatGPT
Si vous souhaitez que FaithGPT soit disponible dans les conversations ChatGPT ordinaires plutôt que dans un GPT spécialement conçu, le chemin du connecteur est celui à utiliser. Dans Paramètres, recherchez les connecteurs sous un en-tête d'applications ou de connecteurs, ouvrez la zone avancée et activez le mode développeur. OpenAI l'a déplacé et renommé plus d'une fois, alors traitez le libellé exact comme un indice plutôt que comme une carte, et vérifiez leur documentation actuelle si les étiquettes ne correspondent pas.
Ajoutez un connecteur personnalisé pointant vers :
La connexion s'effectue via OAuth sur votre compte FaithGPT, il n'y a donc aucune clé à coller ni aucune clé à divulguer. Les outils facturent ensuite le compte qui les a autorisés, ce qui est le comportement que vous souhaitez lorsque le connecteur vous appartient uniquement.
Deux choses à savoir avant de passer du temps ici. Les connecteurs personnalisés doivent être distants et servis via HTTPS, donc un serveur MCP local sur votre ordinateur portable ne fonctionnera pas. Et les plans pouvant ajouter des connecteurs personnalisés ont changé à plusieurs reprises, parfois au milieu du trimestre. Je n'ai délibérément pas écrit de nom de plan dans ce paragraphe, car ce serait bientôt une erreur. Vérifiez ce que votre compte propose aujourd'hui.
Ajouter FaithGPT au Codex
Le Codex lit le même serveur MCP, ce qui rend la vérification des Écritures disponible pendant que vous écrivez du code. Une commande :
Codex détecte que le serveur prend en charge OAuth et démarre le flux immédiatement, en imprimant une URL d'autorisation pointant vers clerk.faithgpt.io. Ouvrez-le, approuvez et la poignée de main se termine. Pour réexécuter ce flux plus tard, après avoir révoqué l'accès ou changé de compte :
La commande add écrit un petit bloc dans ~/.codex/config.toml, et vous pouvez tout aussi bien l'écrire vous-même :
Pour une machine sans navigateur, sans agent ou sans boîte de build, ignorez OAuth et utilisez plutôt une clé statique. Codex lit le jeton à partir d'une variable d'environnement plutôt que de le stocker dans le fichier :
Exportez FAITHGPT_API_KEY avec votre clé fgpt_live_ et le Codex l'envoie sous forme de jeton de porteur. L'indicateur équivalent sur la commande est --bearer-token-env-var. Commandes utiles une fois connecté : codex mcp list pour voir ce qui est enregistré, codex mcp get faithgpt pour la configuration d'un serveur et codex mcp logout faithgpt pour supprimer les informations d'identification stockées.
Quatre choses qui méritent d'être construites
Une étude GPT pour un groupe qui se réunit chaque semaine
Importez le schéma, limitez-le au point de terminaison de la réponse et indiquez les préférences de traduction et le plan de lecture de votre groupe dans les instructions. Les membres posent leurs questions entre les réunions au lieu de toutes les enregistrer pour vous. Le texte du verset revient recherché plutôt que rappelé, c'est là tout l'intérêt.
Une passe de vérification sur tous les brouillons ChatGPT
Rédigez normalement le bulletin d'information ou le plan de la leçon, puis transmettez le texte final via review_doctrine avant qu'il ne soit publié. Il prend un manuscrit complet en un seul appel et signale une correction de texte négligente, qui est le mode d'échec qui survit à une vérification orthographique et à une lecture approfondie. Traitez la sortie comme un deuxième lecteur dont vous êtes libre de modifier les notes.
Vérification des références pendant la construction
Si vous créez un site religieux ou une application de dévotion avec les Écritures dans la copie, la connexion au Codex signifie que les références sont vérifiées pendant l'écriture du code, plutôt que lors d'une révision séparée qui n'a jamais lieu. Demandez-lui de vérifier chaque référence dans vos données de départ et il appellera lookup_scripture par référence au lieu de les observer.
Des réponses fondées dans vos propres scripts
L'API REST est un simple appel HTTP :
La réponse contient la réponse sous la forme Markdown plus un bloc d'utilisation avec input_tokens, output_tokens, credits_charged et un request_id pour la prise en charge. Définissez include_tool_calls sur true et vous obtenez également un tableau indiquant quels outils ont été exécutés, ce qui vous permet de confirmer que le passage a été récupéré plutôt que mémorisé. faithgpt-mini est la valeur par défaut ; faithgpt-max et faithgpt-ultra coûtent plus cher par appel et réfléchissez plus fort. Si vous avez déjà écrit du code avec le SDK d'OpenAI, pointez-le vers /v1/chat/completions et modifiez l'URL et la clé de base.
À quoi s'attendre lorsque cela ne fonctionne pas
Les crédits sont consommés par demande sur les trois chemins, y compris les appels d'outils que le modèle effectue de sa propre initiative. Un GPT bavard qui appelle ask_faithgpt quatre fois pour répondre à une question facture quatre fois. Le tableau de bord sur faithgpt.io/api et le point de terminaison /v1/usage affichent tous deux des décomptes réels, et la page de tarification couvre ce qu'un plan comprend.
Attendez-vous à une invite d'approbation à chaque appel d'outil, y compris ceux qui ne font que lire. FaithGPT marque les cinq outils comme ayant des effets secondaires, car même une recherche écrit la télémétrie d'utilisation et quatre d'entre eux déplacent les crédits. OpenAI traite cela comme non en lecture seule, de sorte que le client demande avant de s'exécuter plutôt que de tirer silencieusement. Ceci est délibéré de la part de FaithGPT et il n'y a aucun paramètre pour le désactiver. Si les confirmations deviennent fatigantes au cours d'une longue session, regroupez vos questions au lieu de les poser une par une.
Si le connecteur ne s'ajoute pas à ChatGPT, vérifiez la question du plan avant de vérifier autre chose. C’est là que s’arrêtent la plupart de ces tentatives, et aucune nouvelle tentative d’URL ne corrige un droit.
If Codex authorizes but the tools never appear, run codex mcp get faithgpt and confirm the URL has no trailing slash and no typo in the scheme. HTTP ne fera pas l'affaire.
Si une recherche ne renvoie rien pour une référence dont vous savez qu'elle existe, vérifiez la traduction. lookup_scripture sert KJV, ASV et YLT, et par défaut KJV. Asking it for ESV or NIV wording is asking for something it does not hold, and a model that cannot get the text will fall back on its own memory unless your instructions forbid it.
Ce dernier échec est celui contre lequel il faut concevoir. Tout ici est au service d’un objectif étroit et peu glamour : quand la machine ne connaît pas un vers, on a envie qu’elle le dise.
Helpful Scripture resources
Contact & support
Email the FaithGPT team at hello@faithgpt.io or visit the contact page .
Explore FaithGPT
