ChatGPT
Conecte ChatGPT a los datos de B1 de su iglesia y hágale preguntas en lenguaje sencillo: responderá con la información en vivo de los registros de su iglesia. También puede pedirle ayuda con tareas que requerirían varios pasos en B1 Admin.
Algunas cosas que puede preguntar:
- "Muéstrame a todas las personas que asistieron la semana pasada pero que aún no han sido asignadas a un grupo pequeño"
- "Resume las donaciones de este mes por fondo"
- "¿Quiénes son nuestros miembros más recientes y hemos hecho seguimiento con ellos?"
- "No sé cómo hacer X en B1, ¿puedes guiarme paso a paso?"
Lo que necesita
- La aplicación de escritorio de ChatGPT para Mac o Windows
- Un plan de pago de ChatGPT (Plus o superior). Las cuentas gratuitas de ChatGPT no pueden conectarse a B1.
- Su inicio de sesión de B1 con permiso para administrar la configuración de la iglesia (necesario para crear una clave). ¿No lo tiene? Pídaselo al administrador de B1 de su iglesia.
Claude se conecta a B1 en su plan gratuito y se configura en menos de 3 minutos: solo agregue B1 como conector e inicie sesión con su cuenta de B1. No necesita clave. Es la forma más sencilla para que su iglesia pruebe la IA con B1 antes de pagar por algo.
Configúrelo
Las pantallas pueden verse un poco diferentes en su versión de ChatGPT.
Paso 1: Cree su clave de B1
La clave es lo que permite a ChatGPT entrar en el B1 de su iglesia; piénsela como una contraseña exclusiva para ChatGPT.
- Inicie sesión en B1 Admin y vaya a Configuración → Desarrollador.
- En la pestaña API Keys, haga clic en New API Key y póngale el nombre
ChatGPT. - Permisos (Scopes): marque lo que ChatGPT puede hacer. Cada área tiene una casilla read (solo lectura) y una casilla write (hacer cambios). ¿No está seguro? Para empezar, marque solo las casillas read.
- Haga clic en Save y luego en Copy para copiar la clave (comienza con
cak_). Solo se muestra una vez.
Paso 2: Haga clic en su nombre en la esquina inferior izquierda de ChatGPT

Paso 3: Haga clic en Settings

Paso 4: Haga clic en Plugins en la barra lateral izquierda

Paso 5: Haga clic en la pestaña MCPs

Aquí verá los servidores MCP que ya haya agregado.
Paso 6: Haga clic en Add → Add MCP server

Paso 7: Complete el formulario y haga clic en Save

Haga clic en Streamable HTTP y luego complete:
| Campo | Qué introducir |
|---|---|
| Name | B1 Church (o cualquier nombre que prefiera) |
| Type | Haga clic en Streamable HTTP |
| URL | https://api.churchapps.org/mcp |
| Bearer token env var | Déjelo en blanco |
| Headers | Haga clic en + Add header → Key: Authorization → Value: vea abajo |

- Key:
Authorization - Value:
Bearer cak_yourkey: la palabra Bearer, un espacio y luego su clave
Haga clic en Save.
¡Eso es todo! Vuelva a un chat y pregunte algo como "¿Cuántas personas hay en nuestra iglesia?", y ChatGPT obtendrá la respuesta directamente de B1.
¿Es seguro?
- ChatGPT solo puede ver los datos de su iglesia.
- Solo puede hacer lo que permita su clave: una clave con solo las casillas read marcadas puede consultar, pero nunca cambiar nada.
- Para desactivarlo, elimine la clave en B1 Admin en Configuración → Desarrollador. El acceso se detiene de inmediato.
¿Cuánto cuesta?
La conexión con B1 es gratuita: forma parte de ChurchApps. ChatGPT necesita un plan de pago (Plus o superior) para conectarse; consulte los precios de OpenAI.
Detalles técnicos
El resto de esta página es para usuarios técnicos y asistentes de IA. El servidor MCP de B1 está en https://api.churchapps.org/mcp (Streamable HTTP) y recibe la clave de API como un encabezado Authorization: Bearer cak_…. Consulte la referencia para desarrolladores del servidor MCP.
GPT personalizado con Actions
Un GPT personalizado le permite crear un asistente dedicado que todo su equipo puede compartir: abren un enlace y empiezan a hacer preguntas sin ninguna configuración de su parte. Requiere una cuenta de ChatGPT Plus, Team o Enterprise y unos 10 minutos.
1. Cree una clave de API
Siga el Paso 1 de Configúrelo más arriba si todavía no lo ha hecho.
2. Cree el GPT personalizado
-
En ChatGPT, haga clic en su perfil → My GPTs → Create a GPT.
-
Cambie a la pestaña Configure, póngale un nombre al GPT (por ejemplo, "Asistente de B1") y agregue las instrucciones:
You help church staff query their B1 records. Use the B1 API actions to
look up people, groups, attendance, donations, and content. Always scope
answers to data the user has permission to see. Be concise. -
Desplácese a Actions → Create new action → Authentication.
- Authentication type: API Key
- API Key: pegue su clave
cak_… - Auth Type: Bearer
- Guarde.
-
En el cuadro Schema, pegue esta especificación inicial de OpenAPI:
openapi: 3.1.0
info:
title: B1 API
version: "1.0"
servers:
- url: https://api.churchapps.org
paths:
/membership/people:
get:
operationId: listPeople
summary: List everyone in the church
responses:
"200":
description: OK
/membership/people/search:
get:
operationId: searchPeople
summary: Find people by name, or by exact email
parameters:
- in: query
name: term
schema: { type: string }
- in: query
name: email
schema: { type: string }
responses:
"200":
description: OK
/membership/people/{id}:
get:
operationId: getPerson
summary: Get a single person by id
parameters:
- in: path
name: id
required: true
schema: { type: string }
responses:
"200":
description: OK
/membership/groups:
get:
operationId: listGroups
summary: List groups in the church
responses:
"200":
description: OK
/giving/donations:
get:
operationId: listDonations
summary: List donations for one person, or between two dates (send both startDate and endDate as YYYY-MM-DD)
parameters:
- in: query
name: personId
schema: { type: string }
- in: query
name: startDate
schema: { type: string, format: date }
- in: query
name: endDate
schema: { type: string, format: date }
responses:
"200":
description: OK
/attendance/attendancerecords/search:
get:
operationId: listAttendance
summary: List attendance records between two dates, optionally for one campus, service, service time, or group
parameters:
- in: query
name: startDate
required: true
schema: { type: string, format: date }
- in: query
name: endDate
required: true
schema: { type: string, format: date }
- in: query
name: campusId
schema: { type: string }
- in: query
name: serviceTimeId
schema: { type: string }
- in: query
name: groupId
schema: { type: string }
responses:
"200":
description: OK -
Guarde la acción. Pruébela: "¿cuántas personas hay en la iglesia?": ChatGPT llama a
listPeopley responde. -
Publique el GPT (Solo yo / Cualquier persona con el enlace / Organización) y comparta el enlace con su equipo.
3. Úselo
Cualquier persona con el enlace puede hacer preguntas en lenguaje natural. Los permisos de la clave siguen aplicando: una clave de solo lectura rechaza las escrituras sin importar lo que diga el esquema de la acción.
Seguridad y límites
- Aislamiento por iglesia. La clave de API corresponde a una sola iglesia. ChatGPT no puede ver los datos de otras iglesias.
- Limitado por permisos. La clave solo tiene los permisos que usted otorgó. Si quita un permiso (eliminando la clave y creando una nueva), ese acceso se corta en la siguiente llamada.
- Revocable al instante. Elimine la clave en Configuración → Desarrollador → API Keys y el acceso termina de inmediato.
- Compartir un GPT personalizado comparte los datos. Todas las personas con acceso al GPT pueden ver todo lo que permitan los permisos de la clave. Para los GPT que se compartan ampliamente, prefiera permisos más restringidos (por ejemplo, omita
donations:read). - Registro de auditoría. Cualquier cambio hecho a través de ChatGPT pasa por el mismo registro de auditoría que las acciones de B1 Admin; encuéntrelos en Configuración → Registro de auditoría.
Solución de problemas
El conector MCP dice "Unauthorized" o muestra un error 401: su clave de API falta o es incorrecta. Abra la configuración del conector y revise el encabezado Authorization: el valor debe ser la palabra Bearer, un espacio y luego la clave cak_… completa, sin espacios adicionales.
ChatGPT dice que no puede encontrar ciertos datos: es posible que la clave no tenga los permisos adecuados. Cree una nueva clave en Configuración → Desarrollador → API Keys con los permisos adicionales y actualice el conector.
La acción del GPT personalizado devuelve 401: en el panel de autenticación de la acción, confirme que Auth Type: Bearer esté seleccionado y que la clave no incluya la palabra Bearer (ChatGPT la agrega automáticamente).
La acción del GPT personalizado devuelve 403: la clave no tiene el permiso para ese endpoint. Cree una nueva clave con los permisos correctos y actualice el GPT.
Se rechaza el esquema de la acción: ChatGPT requiere OpenAPI 3.1 con al menos una entrada paths y una URL en servers. Valide el YAML en editor.swagger.io antes de pegarlo.
Relacionados
- Claves de API: referencia completa de permisos
- Servidor MCP (referencia para desarrolladores): detalles del protocolo y esquemas de herramientas
- Claude: la misma idea, para los modelos de Anthropic
- Referencia de la API REST: todos los endpoints que puede llamar una acción de GPT personalizado