Claude
Spør Claude om kirken din på vanlig språk, og det svarer ut fra B1-dataene dine, inkludert FreePlay-leksjonene og klasserommene dine. Spørsmål som «hvor mange førstegangsbesøkende kom på søndag?» eller «hvem ble med i en smågruppe denne måneden?», eller be det gjøre ting, som «legg til en ny side på nettstedet vårt som heter Arrangementer.» Oppsettet tar under 3 minutter, og du trenger ingen tekniske ferdigheter eller programvare for å installere det.
Det du trenger
- En Claude-konto. Gratisabonnementet fungerer, og er en god måte å prøve det på. Gratiskontoer har imidlertid en daglig meldingsgrense, og oppslag i B1 bruker meldinger raskt, så hvis du bruker det jevnlig, anbefaler vi Claude Pro (omtrent 20 USD i måneden).
- B1-innloggingen din, den samme som du bruker i B1 Admin.
Claude er den enkleste måten å koble B1 til KI på, og det fungerer på Claudes gratisabonnement. Det er en perfekt måte for kirken din å prøve det på før dere betaler for noe.
Det finnes to måter å koble til på. Alternativ 1 er enklest. Ingen nøkkel og ingenting å installere.
Alternativ 1: Logg inn med B1 (enklest)
Fungerer på Claude-nettsiden, Claude-skrivebordsappen og Claude-mobilappen. Sett det opp én gang, så er det på alle.
Steg 1: Åpne Claudes connector-innstillinger
- Gå til claude.ai og logg inn (eller opprett en gratis konto).
- Klikk på navnet ditt nederst til venstre, og deretter Tilpass → Connectors.
Steg 2: Legg til B1
- Klikk på Legg til, og deretter Legg til egendefinert connector.
- Navn: skriv
B1. - URL: lim inn
https://api.churchapps.org/mcp - La de andre alternativene stå som de er, og klikk på Legg til.
Steg 3: Logg inn på B1
- Klikk på Koble til. En innloggingsside for B1 åpnes.
- Logg inn med B1-kontoen din. Hvis du tilhører mer enn én kirke, kontroller at siden nevner riktig kirke («Vil du gi tilgang til følgende data fra din kirke…»).
- B1 viser hva Claude ber om (Alt B1-kontoen din har tilgang til), noterer at appen registrerte seg selv hos B1, og bekrefter at du sendes tilbake til claude.ai. Klikk på Tillat.
Du er tilbake i Claude, og B1 vises som tilkoblet.
Steg 4: Still et spørsmål
Start en ny chat og prøv:
- «Hvor mange personer er det i kirken vår?»
- «List opp de aktive gruppene våre.»
- «Oppsummer denne månedens gaver per fond.»
- «Hvem ble med i kirken de siste 30 dagene?»
Første gang spør Claude om tillatelse til å bruke B1. Klikk på Tillat.
Alternativ 2: Skrivebordsutvidelse med en B1-nøkkel
Bruk dette hvis du heller vil gi Claude en nøkkel med begrensede tillatelser (for eksempel bare lesing). Det fungerer i Claude-skrivebordsappen for Mac eller Windows, og du trenger tillatelse til å administrere kirkeinnstillinger i B1 for å lage en nøkkel.
Steg 1: Skaff Claude-appen
Last ned Claude-appen fra claude.com/download, installer den, åpne den og logg inn.
Steg 2: Lag B1-nøkkelen din
Nøkkelen er det som gir Claude tilgang til kirkens B1. Tenk på den som et passord bare for Claude.
- Logg inn på B1 Admin og gå til Innstillinger → Utvikler.
- Under fanen API-nøkler klikker du på Ny API-nøkkel.
- Navn: skriv
Claude. - Omfang: kryss av for hva Claude har lov til å gjøre. De fleste områder har en boks for lesing (bare se) og en boks for skriving (gjøre endringer). Skjemaer har bare forms:write. Er du usikker? Kryss av bare for lesing-boksene til å begynne med. Du kan lage en ny nøkkel med flere tillatelser senere.
- Klikk på Lagre, og deretter Kopier nøkkelen. Den vises bare én gang, så gå rett til steg 3.
Steg 3: Legg til B1 i Claude
- Last ned B1-utvidelsen.
- Dobbeltklikk på den nedlastede filen (
b1-churchapps.mcpb). Claude åpnes og viser B1 (ChurchApps). - Klikk på Installer.
- Når den spør etter B1 API-nøkkelen din, lim inn nøkkelen fra steg 2 og lagre.
- Avslutt Claude helt (Mac: Cmd+Q · Windows: høyreklikk på Claude-ikonet i oppgavelinjen → Avslutt), og åpne det igjen.
Hvis dobbeltklikk ikke åpner Claude, gå til Innstillinger → Utvidelser → Avanserte innstillinger → Installer utvidelse… i Claude og velg den nedlastede filen. Start deretter en ny chat og still et spørsmål.
Du trenger ikke å gjøre noe. FreePlay fungerer gjennom den samme tilkoblingen. Ett unntak er versjon 1.1.0, som ba om en B1-e-postadresse og et passord. Last ned og installer utvidelsen på nytt for å oppdatere den. Nøkkelen din beholdes.
Er det trygt?
- Claude kan bare se kirkens data.
- Innlogget (alternativ 1): Claude kan aldri gjøre mer enn din egen B1-innlogging kan. Innloggingssiden for B1 viser hva Claude ber om før du klikker Tillat.
- Med en nøkkel (alternativ 2): Claude kan bare gjøre det nøkkelen tillater i B1. En nøkkel med bare lesing-bokser avkrysset kan se på data, men aldri endre noe. FreePlay fungerer på samme måte, med samme nøkkel.
- For å slå det av: gå i B1 Admin til Innstillinger → Utvikler og oppheve appen under Tilkoblede apper (alternativ 1), eller slett nøkkelen under API-nøkler (alternativ 2). Tilgangen stopper med en gang. Du kan også klikke på Koble fra for B1-connectoren i Claude.
Hva koster det?
B1-tilkoblingen er gratis. Den er en del av ChurchApps. Claude selv har et gratisabonnement. Claude Pro (omtrent 20 USD i måneden) gir deg mye mer bruk. Se claude.com/pricing.
Tekniske detaljer
Resten av denne siden er for tekniske brukere og KI-assistenter: omfang, andre måter å koble til på, og hvordan det fungerer.
Omfang
Claude snakker med B1 gjennom Model Context Protocol (MCP)-serveren som er innebygd i B1-API-et (https://api.churchapps.org/mcp). Hvert kall går gjennom de samme autentiserings-, tillatelses- og kirkeavgrensningsreglene som en forespørsel fra B1 Admin. Claude er begrenset til tillatelsene og omfangene til API-nøkkelen, og kan ikke nå webhooks for betalingsleverandører, administrasjonsendepunkter for OAuth-klienter, eller endepunkter for innlogging og passord.
Vanlige startsett med omfang:
- Skrivebeskyttet assistent:
people:read,groups:read,attendance:read,donations:read,content:read - Lesing + legge til notater / oppgaver: legg til
people:write - Full operativ assistent: legg til de tilsvarende
:write-omfangene du ønsker
En donations:read-nøkkel lar Claude oppsummere gaver, men kan ikke registrere en gave. En people:write-nøkkel kan legge til en person, men kan ikke se gaver. Se API-nøkler for hva hvert omfang tillater.
Andre måter å koble til på
Claude Code (CLI)
I en terminal:
claude mcp add --scope user --transport http b1 https://api.churchapps.org/mcp \
--header "Authorization: Bearer cak_<prefix>.<secret>"
Det var alt. Skriv /mcp i en hvilken som helst Claude Code-økt for å bekrefte at b1-serveren er tilkoblet, og still deretter et spørsmål om kirken din.
Claude Desktop, manuell konfigurasjon (avansert)
Hvis du heller ikke vil bruke utvidelsen, rediger konfigurasjonsfilen til Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Legg til en b1-serveroppføring som kobler til B1 gjennom mcp-remote (krever Node.js):
{
"mcpServers": {
"b1": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://api.churchapps.org/mcp",
"--header", "Authorization:Bearer cak_<prefix>.<secret>"
]
}
}
}
Start Claude Desktop på nytt. Connector-menyen i chatfeltet viser b1 med verktøyene sine.
Claude.ai (nett), egendefinert connector
Se alternativ 1 ovenfor. Connectoren bruker OAuth 2.1: Claude finner B1s autorisasjonsserver fra https://api.churchapps.org/.well-known/oauth-protected-resource, registrerer seg selv med Dynamic Client Registration, og logger inn med PKCE. På Team- og Enterprise-abonnementer må en eier kanskje legge til connectoren for organisasjonen først. Claude ber ikke om spesifikke omfang, så samtykkesiden tilbyr alt den innloggede B1-kontoen har tilgang til. Oppheve den under Innstillinger → Utvikler → Tilkoblede apper i B1 Admin.
Slik fungerer det
B1-API-et eksponerer ett enkelt MCP-endepunkt på /mcp. Claude kobler seg til det, autentiserer med cak_…-nøkkelen din, og får tilgang til fire verktøy:
| Verktøy | Hva det gjør |
|---|---|
list_endpoints | Lister REST-endepunktene Claude kan kalle, som kan filtreres på sti. Brukes til oppdagelse. |
describe_endpoint | Returnerer en kort oppsummering og et eksempel på forespørsel og svar for et bestemt endepunkt. |
api_call | Kaller et REST-endepunkt faktisk, som den autentiserte brukeren. |
describe_page_builder | En veiledning for å bygge og redigere kirkens nettsidesider, som Claude leser før det arbeider med nettinnhold. |
Dette er den samme flaten /membership/people, /giving/donations, /attendance/visits osv. som B1 Admin bruker. Alle autorisasjonsregler gjelder likt. FreePlay-endepunkter (lessons.church) er listet under /lessons/*. Claudes kall til dem videresendes til FreePlay som samme bruker, med samme tillatelser.
Sikkerhet og begrensninger
- Isolasjon per kirke. API-nøkkelen peker til én kirke. Claude har ingen måte å se andre kirkers data på.
- Begrenset av tillatelser. Hvis du fjerner en tillatelse fra personen som laget nøkkelen i B1 Admin, mister Claude den ved neste kall, med en gang.
- Kan trekkes tilbake. Slett nøkkelen under Innstillinger → Utvikler → API-nøkler, så stopper Claudes tilgang med en gang.
- Blokkeringsliste. Webhook-endepunkter for betalingsleverandører, administrasjonsendepunkter for OAuth-klienter, og endepunkter for innlogging, registrering, passord og tofaktor kan ikke kalles via MCP.
- Svarstørrelsesgrense. Ett enkelt verktøysvar er begrenset til 64 KB, så lange lister ikke sprenger Claudes kontekst. Claude vil snevre inn søket med filtre når dette skjer.
- Revisjonsspor. Endringer går gjennom samme revisjonslogg som handlinger i B1 Admin. Du kan se dem under Innstillinger → Revisjonslogg.
Feilsøking
Claude ber om en B1-e-postadresse og et passord for å bruke FreePlay: du har versjon 1.1.0 av skrivebordsutvidelsen. Last ned og installer den på nytt for å oppdatere. Nyere versjoner bruker bare nøkkelen din.
Claude melder «Unauthorized» eller 401: bærertokenet mangler, er feil formatert, eller nøkkelen er trukket tilbake. Hvis du brukte utvidelsen, åpne Innstillinger → Utvidelser → B1 (ChurchApps) i Claude og lim inn nøkkelen på nytt. Ellers kontroller Authorization: Bearer cak_…-headeren på nytt (legg merke til mellomrommet og det bokstavelige ordet Bearer).
Et verktøykall gir 403: API-nøkkelen har ikke omfanget for det endepunktet. Legg til omfanget under Innstillinger → Utvikler → API-nøkler (du må lage en ny nøkkel, for omfang kan ikke endres på stedet), og lim den nye nøkkelen inn i utvidelsens innstillinger eller Claudes konfigurasjon.
Claude finner ikke et endepunkt: be det kalle list_endpoints med et filter, f.eks. «bruk list_endpoints med filteret 'donations' for å finne riktig sti». Ruteoversikten genereres fra det kjørende API-et, så alt du kan nå med curl, finnes der.
Lokal utvikling: bytt https://api.churchapps.org/mcp med http://localhost:8084/mcp. Samme autentisering, samme verktøy.
Relatert
- API-nøkler — fullstendig referanse for omfang
- MCP-server (referanse for utviklere) — protokolldetaljer og verktøyskjemaer
- ChatGPT — samme idé, for OpenAIs modeller