Cómo utilizar FaithGPT con ChatGPT y Codex
TL;DR: FaithGPT expone un servidor MCP en api.faithgpt.io/mcp y una API compatible con OpenAI en api.faithgpt.io/v1, y hay tres formas de acceder a ellos desde las herramientas de OpenAI. Un GPT personalizado con acciones es la ruta más confiable hoy en día: importe el esquema OpenAPI desde Faithgpt.io/api/openapi.json, configure la autenticación en Clave API con portador y pegue una clave fgpt_live. Un conector personalizado ChatGPT apunta al punto final de MCP e inicia sesión a través de OAuth sin que se filtre ninguna clave, aunque el acceso al plan a los conectores personalizados sigue cambiando. En Codex, un comando lo conecta e inicia el flujo de OAuth automáticamente, con una opción Bearer_token_env_var para máquinas sin navegador. Las cinco herramientas de MCP cubren la búsqueda de pasajes exactos, la búsqueda de versículos temáticos, respuestas fundamentadas, revisión de doctrina y devocionales, y solo la búsqueda es gratuita.
Pídele a ChatGPT un versículo sobre esperar en Dios y te entregará uno. Pídale la redacción KJV exacta de Lamentaciones 3:25 y se la entregará también, con idéntica confianza. Una de esas respuestas se puede imprimir de forma segura en un folleto. El otro es el modelo que recita de memoria, y en la memoria es donde las paráfrasis se convierten silenciosamente en citas.
He visto que esto salió mal en un grupo pequeño. El versículo en la copia impresa era lo suficientemente parecido como para que nadie lo notara hasta que una mujer en la tercera fila leyó el suyo en voz alta y las palabras no coincidían. No se rompió nada. Era simplemente vergonzoso de una manera que hacía que toda la hoja pareciera menos confiable.
FaithGPT publica dos puertas de entrada con las que las herramientas de OpenAI pueden comunicarse directamente, lo que soluciona el problema específico anterior: el modelo deja de adivinar las Escrituras y comienza a buscarlas. Hay un servidor MCP en https://api.faithgpt.io/mcp y una API REST compatible con OpenAI en https://api.faithgpt.io/v1. Tres formas de ingresar, dependiendo de si estás creando un GPT para otras personas, conectando tu propia cuenta ChatGPT o trabajando en una terminal.
Lo que realmente te ofrece la conexión
El servidor MCP expone cinco herramientas y vale la pena conocer sus nombres porque los verá en el resultado de la llamada a la herramienta:
lookup_scripture toma una referencia como Romans 8:28-39 y devuelve el texto del pasaje en KJV, ASV o YLT. find_scripture_by_topic va en la otra dirección, tomando algo como "esperanza durante el duelo" y regresando hasta diez versos con una breve explicación. ask_faithgpt responde una pregunta sobre la Biblia, la teología o la vida cristiana con citas adjuntas. review_doctrine toma un bloque de texto de hasta 20.000 caracteres, que es aproximadamente un manuscrito de sermón completo, y revisa su solidez teológica y el uso de las Escrituras. create_devotional escribe un devocional sobre un tema, opcionalmente anclado a una referencia que usted proporcione, con opciones de duración y audiencia.
La facturación se divide limpiamente. lookup_scripture es gratis. Los otros cuatro reservan y concilian créditos contra cualquier cuenta de FaithGPT que haya iniciado sesión.
La razón para preocuparse por todo esto: FaithGPT compara sus respuestas con un corpus de referencia que se incluye con cada plan y publica la precisión de sus citas en lugar de pedirle que se base en la fe. Muchas herramientas citan las Escrituras. Menos le mostrarán con qué frecuencia la cita es correcta.
Comience con un GPT personalizado
Este es el camino que yo construiría primero. Está completamente documentado por parte de OpenAI, funciona hoy y el resultado se puede compartir con personas que nunca leerán un archivo de configuración.
Cree un nuevo GPT, abra la pestaña Configurar y desplácese hasta Acciones. Elija Crear nueva acción, luego Importar desde URL y pegue:
Ese es el contrato OpenAPI 3.1.1 en vivo, generado a partir de la API en ejecución en lugar de escrito a mano, por lo que se mantiene en sintonía con los puntos finales. Al importarlo, su GPT proporciona todas las rutas publicadas a la vez: /v1/faithgpt/answer, /v1/chat/completions, /v1/models y /v1/usage. La mayoría de los GPT de estudio solo necesitan el primero. Elimine las operaciones que no desee después de la importación, ya que cada operación adicional es otra cosa que el modelo puede seleccionar mal.
A continuación, Autenticación. Elija Clave API, establezca Tipo de autenticación en Portador y pegue una clave. Las claves provienen del tablero en faithgpt.io/api y lucen como fgpt_live_a1b2c3.... Solo se almacena el hash SHA-256, por lo que la clave completa aparece una vez en el momento de la creación y nunca más. Cópielo antes de cerrar el cuadro de diálogo.
Luego, escriba instrucciones que le indiquen al GPT cuándo acceder a la API en lugar de responder desde la memoria. Algo en esta forma funciona:
__FGPTTOken16__
Esa última frase se gana su lugar. Sin él, el modelo trata una llamada fallida como una indicación para improvisar, lo que le devuelve al problema del folleto.
Una advertencia que es fácil pasar por alto hasta que llega la factura: la clave pertenece a su cuenta, por lo que cualquiera que use su GPT gasta sus créditos. Comparta un GPT de estudio bíblico con un grupo de cuarenta y estará financiando las preguntas de cuarenta personas. Mantenga la configuración para compartir privada o solo mediante enlace hasta que conozca el volumen.
Conecte el servidor MCP a ChatGPT directamente
Si desea que FaithGPT esté disponible en conversaciones ChatGPT normales en lugar de dentro de un GPT especialmente diseñado, la ruta del conector es la que debe utilizar. En Configuración, busque conectores bajo el encabezado de aplicaciones o conectores, abra el área avanzada y habilite el modo de desarrollador. OpenAI ha movido y renombrado esto más de una vez, así que trate la redacción exacta como una pista en lugar de un mapa, y verifique su documentación actual si las etiquetas no coinciden.
Agregue un conector personalizado que apunte a:
El inicio de sesión se realiza a través de OAuth en su cuenta FaithGPT, por lo que no hay clave que pegar ni clave que filtrar. Luego, las herramientas facturan a la cuenta que las autorizó, que es el comportamiento que desea cuando el conector es solo suyo.
Dos cosas que debes saber antes de pasar tiempo aquí. Los conectores personalizados deben ser remotos y servirse a través de HTTPS, por lo que un servidor MCP local en su computadora portátil no funcionará. Y los planes que pueden agregar conectores personalizados han cambiado repetidamente, a veces a mitad del trimestre. Deliberadamente no he escrito el nombre de un plan en este párrafo, porque en poco tiempo estaría mal. Consulta lo que ofrece tu cuenta hoy.
Agregar FaithGPT al Codex
Codex lee el mismo servidor MCP, lo que hace que la verificación de las Escrituras esté disponible mientras escribes el código. Un comando:
Codex detecta que el servidor admite OAuth e inicia el flujo inmediatamente, imprimiendo una URL de autorización que apunta a clerk.faithgpt.io. Ábralo, apruebe y se completará el apretón de manos. Para ejecutar ese flujo nuevamente más tarde, después de revocar el acceso o cambiar de cuenta:
El comando add escribe un pequeño bloque en ~/.codex/config.toml, y también puedes escribirlo tú mismo:
__FGPTTOken23__
Para una máquina sin navegador, un agente desatendido o un cuadro de compilación, omita OAuth y use una clave estática en su lugar. Codex lee el token de una variable de entorno en lugar de almacenarlo en el archivo:
__FGPTTOken24__
Exporte FAITHGPT_API_KEY con su clave fgpt_live_ y Codex la enviará como un token al portador. El indicador equivalente en el comando es --bearer-token-env-var. Comandos útiles una vez conectado: codex mcp list para ver qué está registrado, codex mcp get faithgpt para la configuración de un servidor y codex mcp logout faithgpt para descartar las credenciales almacenadas.
Cuatro cosas que vale la pena construir
Un GPT de estudio para un grupo que se reúne semanalmente
Importe el esquema, limítelo al punto final de respuesta e incluya la preferencia de traducción y el plan de lectura de su grupo en las instrucciones. Los miembros hacen sus preguntas entre reuniones en lugar de guardarlas todas para usted. El texto del versículo vuelve a buscarse en lugar de recordarse, que es el punto.
Un pase de verificación para cualquier borrador de ChatGPT
Redacte el boletín informativo o el resumen de la lección normalmente y luego envíe el texto terminado a través de review_doctrine antes de publicarlo. Toma un manuscrito completo en una sola llamada y señala los mensajes de texto de prueba descuidados, que es el modo de falla que sobrevive a una revisión ortográfica y una lectura completa. Trate el resultado como un segundo lector cuyas notas puede anular.
Verificaciones de referencia mientras construyes
Si está publicando el sitio de una iglesia o una aplicación devocional con las Escrituras en la copia, la conexión del Codex significa que las referencias se verifican mientras se escribe el código, en lugar de una revisión separada que nunca sucede. Pídale que verifique cada referencia en sus datos semilla y llamará a lookup_scripture por referencia en lugar de observarlas.
Respuestas fundamentadas dentro de tus propios guiones
La API REST es una simple llamada HTTP:
__FGPTTOken33__
La respuesta lleva la respuesta como Markdown más un bloque de uso con input_tokens, output_tokens, credits_charged y request_id como soporte. Establezca include_tool_calls en verdadero y también obtendrá una matriz que muestra qué herramientas se ejecutaron, que es la forma en que confirma que el pasaje se obtuvo en lugar de recordarse. faithgpt-mini es el valor predeterminado; faithgpt-max y faithgpt-ultra cuestan más por llamada y piensan más. Si ya tiene código escrito en el SDK de OpenAI, apúntelo a /v1/chat/completions y cambie la URL base y la clave.
Qué esperar cuando no funciona
Los créditos se consumen por solicitud en las tres rutas, incluidas las llamadas a herramientas que el modelo realiza por iniciativa propia. Un GPT hablador que llama a ask_faithgpt cuatro veces para responder una pregunta factura cuatro veces. El panel en faithgpt.io/api y el punto final /v1/usage muestran recuentos reales, y la página de precios cubre lo que incluye un plan.
Espere un mensaje de aprobación en cada llamada a la herramienta, incluidas las que solo leen. FaithGPT marca que las cinco herramientas tienen efectos secundarios, porque incluso una búsqueda escribe telemetría de uso y cuatro de ellas mueven créditos. OpenAI trata eso como no de solo lectura, por lo que el cliente pregunta antes de ejecutar en lugar de disparar en silencio. Esto es deliberado por parte de FaithGPT y no hay ninguna configuración para desactivarlo. Si las confirmaciones le resultan aburridas durante una sesión larga, agrupe sus preguntas en lugar de hacerlas una por una.
Si el conector no se agrega en ChatGPT, verifique la pregunta del plan antes de verificar cualquier otra cosa. Ahí es donde se detienen la mayoría de estos intentos, y por mucho que se reintente la URL, no se soluciona un derecho.
Si Codex lo autoriza pero las herramientas nunca aparecen, ejecute codex mcp get faithgpt y confirme que la URL no tenga una barra diagonal ni un error tipográfico en el esquema. HTTP no servirá.
Si una búsqueda no arroja nada para una referencia que sabe que existe, verifique la traducción. lookup_scripture sirve KJV, ASV e YLT, y el valor predeterminado es KJV. Pedirle texto ESV o NIV es pedir algo que no contiene, y un modelo que no puede entender el texto recurrirá a su propia memoria a menos que sus instrucciones lo prohíban.
Ese último fracaso es contra el que hay que diseñar. Todo aquí está al servicio de un objetivo estrecho y poco glamoroso: cuando la máquina no conoce un verso, quieres que lo diga.
Helpful Scripture resources
Contact & support
Email the FaithGPT team at hello@faithgpt.io or visit the contact page .
Explore FaithGPT
