ChatGPT
Conecte o ChatGPT aos dados do B1 da sua igreja e faça perguntas em linguagem simples -- ele responde com base nos registros atualizados da sua igreja. Você também pode pedir ajuda para tarefas que exigiriam várias etapas no B1 Admin.
Algumas coisas que você pode perguntar:
- "Mostre todas as pessoas que estiveram presentes na semana passada, mas ainda não foram incluídas em um pequeno grupo"
- "Resuma as doações deste mês por fundo"
- "Quem são nossos membros mais novos e já fizemos algum acompanhamento com eles?"
- "Não consigo descobrir como fazer X no B1 -- pode me explicar passo a passo?"
O que você precisa
- O aplicativo de desktop do ChatGPT para Mac ou Windows
- Um plano pago do ChatGPT (Plus ou superior). Contas gratuitas do ChatGPT não podem se conectar ao B1.
- Seu login do B1 com permissão para gerenciar as configurações da igreja (necessária para criar uma chave). Não tem essa permissão? Peça ao administrador do B1 da sua igreja.
Claude se conecta ao B1 no plano gratuito e é configurado em menos de 3 minutos -- basta adicionar o B1 como conector e entrar com sua conta do B1. Não é preciso chave. É a forma mais fácil de a sua igreja experimentar a IA com o B1 antes de pagar por qualquer coisa.
Como configurar
As telas podem parecer um pouco diferentes na sua versão do ChatGPT.
Etapa 1 -- Crie sua chave do B1
A chave é o que permite que o ChatGPT acesse o B1 da sua igreja -- pense nela como uma senha exclusiva para o ChatGPT.
- Entre no B1 Admin e acesse Configurações → Desenvolvedor.
- Na aba Chaves de API, clique em Nova chave de API e dê a ela o nome
ChatGPT. - Escopos: marque o que o ChatGPT poderá fazer. Cada área tem uma caixa leitura (apenas consultar) e uma caixa escrita (fazer alterações). Não tem certeza? Para começar, marque apenas as caixas de leitura.
- Clique em Salvar e depois em Copiar a chave (ela começa com
cak_). Ela é exibida apenas uma vez.
Etapa 2 -- Clique no seu nome, no canto inferior esquerdo do ChatGPT

Etapa 3 -- Clique em Configurações

Etapa 4 -- Clique em Plugins na barra lateral esquerda

Etapa 5 -- Clique na aba MCPs

Aqui você verá os servidores MCP que já tiver adicionado.
Etapa 6 -- Clique em Adicionar → Adicionar servidor MCP

Etapa 7 -- Preencha o formulário e clique em Salvar

Clique em Streamable HTTP e preencha:
| Campo | O que informar |
|---|---|
| Nome | B1 Church (ou qualquer nome de sua preferência) |
| Tipo | Clique em Streamable HTTP |
| URL | https://api.churchapps.org/mcp |
| Variável de ambiente do token Bearer | Deixe em branco |
| Cabeçalhos | Clique em + Adicionar cabeçalho → Chave: Authorization → Valor: veja abaixo |

- Chave:
Authorization - Valor:
Bearer cak_yourkey-- a palavra Bearer, um espaço e a sua chave
Clique em Salvar.
Pronto! Volte a um chat e pergunte algo como "Quantas pessoas fazem parte da nossa igreja?" e o ChatGPT buscará a resposta diretamente no B1.
É seguro?
- O ChatGPT só consegue ver os dados da sua igreja.
- Ele só pode fazer o que a sua chave permite -- uma chave com apenas as caixas de leitura marcadas pode consultar, mas nunca alterar nada.
- Para desativar o acesso, exclua a chave no B1 Admin em Configurações → Desenvolvedor. O acesso é interrompido imediatamente.
Quanto custa?
A conexão com o B1 é gratuita -- ela faz parte do ChurchApps. O ChatGPT precisa de um plano pago (Plus ou superior) para se conectar; veja os preços da OpenAI.
Detalhes técnicos
O restante desta página é destinado a usuários técnicos e assistentes de IA. O servidor MCP do B1 está em https://api.churchapps.org/mcp (Streamable HTTP) e recebe a chave de API como cabeçalho Authorization: Bearer cak_…. Veja a referência do servidor MCP para desenvolvedores.
GPT personalizado com Ações
Um GPT personalizado permite criar um assistente dedicado que toda a sua equipe pode compartilhar -- basta abrir um link e começar a fazer perguntas, sem nenhuma configuração do lado deles. Ele exige uma conta ChatGPT Plus, Team ou Enterprise e cerca de 10 minutos.
1. Crie uma chave de API
Siga a Etapa 1 de Como configurar, acima, se ainda não tiver feito isso.
2. Crie o GPT personalizado
-
No ChatGPT, clique no seu perfil → Meus GPTs → Criar um GPT.
-
Acesse a aba Configurar, dê um nome ao GPT (por exemplo, "Assistente B1") e adicione as instruções:
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. -
Role até Ações → Criar nova ação → Autenticação.
- Tipo de autenticação: Chave de API
- Chave de API: cole a sua chave
cak_… - Tipo de autenticação: Bearer
- Salve.
-
Na caixa Schema, cole esta especificação OpenAPI inicial:
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 -
Salve a ação. Teste: "quantas pessoas fazem parte da igreja?" -- o ChatGPT chama
listPeoplee responde. -
Publique o GPT (Somente eu / Qualquer pessoa com o link / Organização) e compartilhe o link com a sua equipe.
3. Use o GPT
Qualquer pessoa com o link pode fazer perguntas em linguagem natural. Os escopos da chave continuam valendo -- uma chave somente de leitura recusa gravações, independentemente do que o schema da ação disser.
Segurança e limites
- Isolamento por igreja. A chave de API corresponde a uma única igreja. O ChatGPT não consegue ver os dados de outras igrejas.
- Restrita por permissões. A chave só tem os escopos que você concedeu. Remover um escopo (excluindo e recriando a chave) corta esse acesso na próxima chamada.
- Revogável instantaneamente. Exclua a chave em Configurações → Desenvolvedor → Chaves de API e o acesso termina imediatamente.
- Compartilhar um GPT personalizado compartilha os dados. Todos com acesso ao GPT podem ver o que os escopos da chave permitirem. Prefira escopos mais restritos (por exemplo, omita
donations:read) para GPTs compartilhados amplamente. - Trilha de auditoria. Quaisquer alterações feitas pelo ChatGPT passam pelo mesmo registro de auditoria das ações do B1 Admin -- encontre-as em Configurações → Registro de auditoria.
Solução de problemas
O conector MCP mostra "Unauthorized" ou um erro 401: sua chave de API está ausente ou incorreta. Abra as configurações do conector e verifique o cabeçalho Authorization: o valor deve ser a palavra Bearer, um espaço e, em seguida, a chave cak_… completa, sem espaços extras.
O ChatGPT diz que não consegue encontrar determinados dados: a chave pode não ter os escopos corretos. Crie uma nova chave em Configurações → Desenvolvedor → Chaves de API com os escopos adicionais e atualize o conector.
A ação do GPT personalizado retorna 401: no painel de autenticação da ação, confirme que Tipo de autenticação: Bearer está selecionado e que a chave não inclui a palavra Bearer (o ChatGPT a adiciona automaticamente).
A ação do GPT personalizado retorna 403: a chave não tem o escopo para aquele endpoint. Crie uma nova chave com os escopos corretos e atualize o GPT.
O schema da ação é rejeitado: o ChatGPT exige OpenAPI 3.1 com pelo menos uma entrada em paths e uma URL em servers. Valide o YAML em editor.swagger.io antes de colar.
Relacionados
- Chaves de API -- referência completa de escopos
- Servidor MCP (referência para desenvolvedores) -- detalhes do protocolo e esquemas das ferramentas
- Claude -- a mesma ideia, para os modelos da Anthropic
- Referência da API REST -- todos os endpoints que uma ação de GPT personalizado pode chamar