Cómo utilizar FaithGPT dentro de Claude Code, Cowork y Claude.ai
TL;DR: Agregue https://api.faithgpt.io/mcp a Claude Code con un solo comando e inicie sesión a través de la pantalla de consentimiento OAuth de FaithGPT, y Claude obtendrá cinco herramientas para la búsqueda de Escrituras, búsqueda de versículos de actualidad, respuestas fundamentadas, revisión de doctrina y escritura devocional. La misma URL del servidor funciona en Claude.ai, Claude Desktop y Cowork a través de la configuración de su conector.
Un modelo que haya leído toda la Biblia aún la citará incorrectamente.
Estás tres archivos en el sitio web de una iglesia, escribiendo la copia para una página de donaciones, y le preguntas a Claude Romanos 8:28 en la versión King James. Lo que regresa se lee bien. "Y sabemos que a los que aman a Dios, todas las cosas les ayudan a bien, es decir, a los que conforme a su propósito son llamados". Quizás ese sea el verso. Quizás una palabra se movió. No lo vas a entender, porque casi fallar en un verso familiar suena exactamente como el verso, y la persona que revisa tu solicitud de extracción está verificando los colores de los botones.
Esta es la falla que hace que las citas de las Escrituras por IA sean riesgosas de una manera que el código de IA no lo es. El código roto falla ruidosamente. Un verso mal citado se envía, se imprime en un boletín y se queda allí.
FaithGPT ejecuta un servidor MCP remoto que cierra esa brecha. Una vez conectado, Claude deja de responder preguntas bíblicas de memoria y comienza a llamar a una herramienta que lee la propia base de datos bíblica de FaithGPT. El texto del verso regresa con su referencia adjunta. Puedes conectarlo a Claude Code con un solo comando.
Qué es realmente el servidor MCP de FaithGPT
MCP es el protocolo de contexto modelo, el estándar que Anthropic utiliza para permitir que Claude hable con servicios externos. Un servidor MCP remoto es una URL a la que Claude puede llamar y FaithGPT vive en:
__FGPTTOken0__
Habla HTTP Streamable sin estado sobre JSON-RPC 2.0. La autorización es un código de autorización OAuth 2.0 con PKCE, con registro dinámico de cliente y descubrimiento de recursos protegidos RFC 9728, que es la forma aburrida de decir que nunca manejas una clave. Su cliente se registra, su navegador abre la pantalla de inicio de sesión y consentimiento de FaithGPT, usted aprueba openid profile email faithgpt:mcp y el token pertenece a su cuenta.
Se encuentran cinco herramientas:
lookup_scripture toma una referencia como John 3:16, Psalm 23 o Romans 8:28-39 y devuelve el texto del pasaje en KJV, ASV o YLT. KJV es el valor predeterminado. Esta es la herramienta de recuperación y es la que soluciona el problema de las citas erróneas.
find_scripture_by_topic va en la otra dirección. Dale un tema, una situación o una palabra clave y te devolverá pasajes relevantes con una breve explicación. Puede limitarlo al Antiguo Testamento, al Nuevo o a ambos, y limitarlo entre uno y diez resultados.
ask_faithgpt envía una pregunta completa a FaithGPT y devuelve una respuesta basada en las Escrituras con citas. Úselo cuando la pregunta necesite una respuesta en lugar de un verso.
review_doctrine toma un bloque de texto, de hasta 20.000 caracteres, y lo revisa para determinar su solidez teológica y el uso responsable de las Escrituras. FaithGPT es explícito en que se trata de orientación y no de consejo pastoral calificado, que es la línea correcta para que se mantenga una herramienta.
create_devotional crea un devocional en torno a un tema, opcionalmente anclado en un verso, con una duración y una audiencia que usted elija. Devuelve un título, un pasaje, una reflexión y una oración. No publica ni guarda nada.
La parte que vale la pena leer dos veces: este conector no puede leer ni cambiar sus datos privados de FaithGPT. Diarios, oraciones, notas, recuerdos, conversaciones, medios, tu suscripción, tu configuración, todo fuera de los límites. Lee las Escrituras y genera contenido. El acceso es revocable cuando quieras que desaparezca.
Código Claude
Un comando:
Luego confirma que aterrizó:
__FGPTTOken11__
La primera vez que Claude llama a una de las herramientas, se abre el flujo de consentimiento de FaithGPT en su navegador. Usted inicia sesión y aprueba los ámbitos, y esa es toda la configuración. No se pega nada en un archivo de configuración y no existe ninguna clave API que pueda filtrarse.
Para comprobar la conexión por sí sola:
__FGPTTOken12__
Está buscando un estado de Connected. Dentro de una sesión, /mcp le muestra los servidores que tiene Claude Code y le permite manejar la autenticación si hay un servidor allí no autorizado.
Después de eso, preguntas en inglés. "Busque Hebreos 12:1-2 en KJV y colóquelo en la sección de héroes". Claude elige lookup_scripture por sí solo, porque las descripciones de las herramientas indican cuándo se aplica cada una. No nombras herramientas.
Elegir un alcance
La bandera --scope decide quién obtiene el servidor.
--scope user es lo que usa el comando anterior y es el valor predeterminado correcto para un desarrollador en solitario. El servidor te sigue a cada proyecto en esa máquina, por lo que lo configuras una vez.
--scope local lo guarda para el proyecto actual y para usted.
--scope project escribe el servidor en un archivo .mcp.json en la raíz del repositorio:
__FGPTTOken21__
Confirme ese archivo y todos los que clonen el repositorio obtendrán el servidor que se les ofrecerá. Su Claude Code les pedirá que lo aprueben antes de conectarse, y cada persona aún inicia sesión en su propia cuenta FaithGPT, para que nadie herede sus créditos o su identidad. Para un equipo que construye un producto de la iglesia, así es como hace que las Escrituras verificadas sean las predeterminadas en lugar de algo que un desarrollador recuerda hacer.
Claude.ai y Claude Desktop
Los conectores personalizados en claude.ai utilizan la misma URL del servidor MCP. En tu configuración hay una sección de conectores con una opción para agregar un conector personalizado, donde pegas:
__FGPTTOken22__
Estoy cubriendo la redacción exacta del menú a propósito. Anthropic mueve estas etiquetas entre versiones, y la instrucción honesta es abrir la configuración y buscar conectores en lugar de confiar en una captura de pantalla del momento en que se escribió esto. Lo que no se mueve es la URL y lo que sucede después de enviarla: se abre el inicio de sesión de FaithGPT, usted aprueba los mismos cuatro ámbitos y las cinco herramientas aparecen en su lista de conectores.
Claude Desktop se basa en la misma configuración de conector que la aplicación web, por lo que configurarlo en un solo lugar cubre ambos.
Dos advertencias que vale la pena tener en cuenta antes de empezar a buscar. Los conectores personalizados no están disponibles en todos los planes y, si su cuenta pertenece a una organización, un administrador puede restringir qué conectores pueden agregar las personas. Si la opción falta por completo, esa suele ser la razón más que cualquier cosa por parte de FaithGPT.
Cotrabajo
Cowork utiliza el sistema de conector de Claude, por lo que funciona la misma URL. No voy a inventar la ruta del clic. Anthropic ha estado enviando Cowork rápidamente y la navegación se ha movido, así que abra su configuración, busque dónde se administran los conectores y pegue la URL del servidor allí. El flujo de OAuth se comporta de manera idéntica una vez que usted lo hace.
El cowork es donde más gana este conector, y el motivo es la forma del trabajo. Las sesiones de cowork duran más y se basan en documentos de una manera que las sesiones de codificación no lo hacen. Preparar un estudio, revisar un manuscrito. Ésa es exactamente la obra en la que un verso equivocado sobrevive hasta llegar al público.
Qué hacer realmente con él
Preparación del sermón al lado de una compilación
Usted enviará un sitio web de la iglesia el jueves y el pastor necesita la lista de pasajes para el domingo. En lugar de cambiar de contexto, en la misma sesión solicita pasajes sobre la perseverancia en ambos Testamentos, obtiene cinco con referencias y los pega en el archivo de notas que ya está abierto en el editor.
Revisión de doctrina en copia generada
Este es el flujo de trabajo que configuraría primero. Es muy fácil que el texto de marketing de un producto cristiano se equivoque ligeramente, y el error es más teológico que gramatical, por lo que una revisión normal lo pasa por alto. Redacte la página acerca de y luego entréguela a review_doctrine antes de que se acerque a un diseñador. Señala dónde las Escrituras están haciendo una obra para la que no fueron escritas. Trate el resultado como un estímulo para pensar en lugar de un veredicto.
Devocionales de un repositorio compartido
Coloque el servidor en .mcp.json, confírmelo y su equipo de contenido generará devocionales dentro del mismo repositorio donde reside el sitio, bajo los mismos controles de cuenta, con cada borrador anclado a un pasaje real. La herramienta no publica nada, por lo que un humano aún decide qué se envía.
Comprobación de referencias sobre cualquier cosa que hayas heredado
Dirija a Claude a un directorio de contenido existente y pídale que verifique cada referencia de las Escrituras con lookup_scripture. Este es un trabajo aburrido que nadie hace, razón por la cual los sitios de iglesias antiguas están llenos de referencias que desaparecieron hace años. Un modelo que lo recorra en un bucle encontrará aquellos que una persona pasa por alto.
Límites, costos y qué saldrá mal
Las llamadas de herramientas se basan en sus créditos FaithGPT y se atribuyen a cualquier cuenta con la que haya iniciado sesión. Vale la pena decirlo claramente: este no es un canal secundario gratuito en FaithGPT, es su cuenta a la que se accede desde un cliente diferente. Si consumes un lote de devocionales en Cowork, los créditos se obtienen del mismo saldo que utiliza la aplicación web. Los planes y montos de crédito se encuentran en la página de precios .
Su cliente puede pedirle que apruebe cada llamada de herramienta en lugar de ejecutarlas en silencio. Eso es deliberado. FaithGPT marca que estas herramientas tienen efectos secundarios, porque escriben registros de uso y pueden gastar créditos, y un cliente que sea honesto acerca de los efectos secundarios lo consultará con usted.
La búsqueda de Escrituras cubre KJV, ASV y YLT. Si necesita una traducción fuera de ese conjunto, esta herramienta no se la proporcionará y no debe permitir que un modelo llene el vacío de la memoria. Ese es exactamente el comportamiento que el conector pretende evitar.
Si las herramientas nunca aparecen, trabaje en orden. Ejecute claude mcp get faithgpt y lea el estado. Si no es Connected, el flujo de OAuth probablemente no finalizó, así que active una llamada a la herramienta y observe la pestaña del navegador. Si no se abre nada, verifique si un bloqueador de ventanas emergentes se lo comió. En claude.ai, confirme que su plan permita conectores personalizados y que un administrador no los haya restringido.
También puedes comprobar el servidor en sí sin ningún cliente involucrado:
__FGPTTOken29__
Eso devuelve los metadatos de recursos protegidos de FaithGPT. Si responde y su cliente aún no puede conectarse, el problema está en el lado del cliente.
Cuando quieras la API en su lugar
MCP se adapta al trabajo interactivo, donde una persona está al tanto y Claude decide qué herramienta encaja. Para cualquier cosa programada, un trabajo nocturno o un servidor que necesite respuestas de FaithGPT sin que nadie mire, use la API REST en su lugar. Es compatible con OpenAI:
Usted se autentica con una clave del panel de API en lugar de OAuth, y la referencia completa se encuentra en faithgpt.io/api .
La línea divisoria es simple. Si hay una persona mirando, utilice el conector. Si es un trabajo cron, use la clave.
Comienza con un verso
Agregue el servidor, pídale a Claude un pasaje que conozca bien y compare el resultado con su propia Biblia. Una vez que lo hayas visto regresar correctamente, desde una base de datos en lugar de los recuerdos de un modelo, la razón para dejarlo conectado se vuelve obvia.
Puede ver todo lo que FaithGPT hace con la misma base bíblica en faithgpt.io .
Helpful Scripture resources
Contact & support
Email the FaithGPT team at hello@faithgpt.io or visit the contact page .
Explore FaithGPT
