Claude
Питајте Claude о вашој цркви обичним језиком, а он ће одговорити на основу ваших B1 података, укључујући ваше FreePlay лекције и учионице. Питања попут „колико је првопосетилаца дошло у недељу?“ или „ко се ове месеце придружио малој групи?“, или га замолите да уради нешто, на пример „додај нову страницу на наш веб-сајт под називом Догађаји.“ Подешавање траје мање од 3 минута, а за инсталацију не треба никакво техничко знање или софтвер.
Шта вам је потребно
- Claude налог. Бесплатан план функционише и добар је начин да га испробате. Бесплатни налози, међутим, имају дневни лимит порука, а претраживање података у B1 брзо троши поруке, па ако га често користите, препоручујемо Claude Pro (око 20 долара месечно).
- Ваша B1 пријава — иста коју користите за B1 Admin.
Claude је најлакши начин да повежете B1 са вештачком интелигенцијом, а ради и на Claude-овом бесплатном плану, што је савршен начин да ваша црква то испроба пре плаћања било чега.
Постоје два начина за повезивање. Опција 1 је најлакша — не треба кључ и ништа се не инсталира.
Опција 1 — Пријава помоћу B1 (најлакше)
Ради на Claude веб-сајту, Claude десктоп апликацији и Claude апликацији за телефон. Подесите једном и важи на свим њима.
Корак 1 — Отворите Claude подешавања конектора
- Идите на claude.ai и пријавите се (или направите бесплатан налог).
- Кликните на своје име у доњем левом углу, па на Customize → Connectors (Прилагоди → Конектори).
Корак 2 — Додајте B1
- Кликните на Add (Додај), па на Add custom connector (Додај прилагођени конектор).
- Name (Назив): укуцајте
B1. - URL: налепите
https://api.churchapps.org/mcp - Оставите остале опције како јесу и кликните на Add (Додај).
Корак 3 — Пријавите се у B1
- Кликните на Connect (Повежи). Отвара се B1 страница за пријаву.
- Пријавите се својим B1 налогом. Ако припадате више од једној цркви, проверите да је у врху приказана права црква.
- B1 наводи шта Claude тражи да уради и потврђује да ћете бити враћени на claude.ai. Кликните на Allow (Дозволи).
Вратићете се у Claude и B1 ће бити приказан као повезан.
Корак 4 — Питајте нешто
Започните нови разговор и пробајте:
- „Колико људи има у нашој цркви?“
- „Наведи активне групе.“
- „Сажми ове месечне донације по фонду.“
- „Ко се придружио цркви у последњих 30 дана?“
Први пут Claude тражи дозволу за коришћење B1 — кликните на Allow (Дозволи).
Опција 2 — Десктоп додатак са B1 кључем
Користите ово ако желите да Claude-у дате кључ са ограниченим дозволама (на пример, само за читање). Ради у Claude десктоп апликацији за Mac или Windows, а да бисте направили кључ, потребна вам је дозвола за управљање подешавањима цркве у B1.
Корак 1 — Преузмите Claude апликацију
Преузмите Claude апликацију са claude.com/download, инсталирајте је, отворите и пријавите се.
Корак 2 — Направите свој B1 кључ
Кључ је оно што Claude-у даје приступ B1 ваше цркве — замislite га као лозинку само за Claude.
- Пријавите се на B1 Admin и идите на Settings → Developer (Подешавања → Програмер).
- На картици API Keys кликните на New API Key (Нови API кључ).
- Name (Назив): укуцајте
Claude. - Scopes (Дозволе): означите шта Claude сме да ради. Свака област има поље read (читање, само преглед) и поље write (упис, прављење измена). Нисте сигурни? За почетак означите само поља read — касније можете направити нови кључ са више дозвола.
- Кликните на Save (Сачувај), па на Copy (Копирај) да копирате кључ. Приказује се само једном, зато одмах пређите на Корак 3.
Корак 3 — Додајте B1 у Claude
- Преузмите B1 додатак.
- Двапут кликните на преузету датотеку (
b1-churchapps.mcpb). Claude се отвара и приказује B1 (ChurchApps). - Кликните на Install (Инсталирај).
- Када вас затражи B1 API key (B1 API кључ), налепите кључ из Корака 2 и сачувајте.
- Потпуно затворите Claude (Mac: Cmd+Q · Windows: десни клик на Claude икону у траци задатака → Quit (Затвори)) и поново га отворите.
Ако двоструки клик не отвори Claude, идите на Settings → Extensions → Advanced settings → Install Extension… (Подешавања → Додаци → Напредна подешавања → Инсталирај додатак…) у Claude-у и изаберите преузету датотеку. Затим започните нови разговор и питајте нешто.
Ништа не треба да радите — FreePlay ради преко исте везе. Једини изузетак је верзија 1.1.0, која је тражила B1 имејл и лозинку: поново преузмите и инсталирајте додатак да бисте га ажурирали. Ваш кључ остаје исти.
Да ли је сигурно?
- Claude може да види само податке ваше цркве.
- Пријављени (Опција 1): Claude никада не може да уради више него што може ваш B1 налог. Страница за пријаву у B1 наводи све што Claude сме да уради пре него што кликнете на Allow (Дозволи).
- Са кључем (Опција 2): Claude може само оно што кључ дозвољава у B1 — кључ са означеним пољима само за read може да прегледа, али никада не може ништа да промени. FreePlay функционише на исти начин, под истим кључем.
- Да бисте га искључили: у B1 Admin-у идите на Settings → Developer (Подешавања → Програмер) и опозовите апликацију под Connected Apps (Повезане апликације) (Опција 1) или обришите кључ под API Keys (API кључеви) (Опција 2). Приступ се одмах прекида. Можете и да кликнете на Disconnect (Прекини везу) на B1 конектору у Claude-у.
Колико кошта?
B1 веза је бесплатна — део је ChurchApps-а. Claude има бесплатан план; Claude Pro (око 20 долара месечно) вам даје много више коришћења. Погледајте claude.com/pricing.
Технички детаљи
Остатак ове странице намењен је техничким корисницима и AI асистентима: дозволама, другим начинима повезивања и начину рада.
Дозволе (scopes)
Claude комуницира са B1 преко Model Context Protocol (MCP) сервера уграђеног у B1 API (https://api.churchapps.org/mcp). Сваки позив пролази кроз иста правила аутентификације, дозвола и ограничења на цркву као и захтев из B1 Admin-а. Claude је ограничен на дозволе и опсеге API кључа и не може да приступи webhook-овима, OAuth администраторским крајњим тачкama или другим путевима намењеним само оператерима.
Уобичајени почетни скупови дозвола:
- Асистент само за читање:
people:read,groups:read,attendance:read,donations:read,content:read - Читање + додавање белешки / задатака: додајте
people:write - Потпун оперативни асистент: додајте одговарајуће
:writeдозволе које желите
Кључ са donations:read омогућава Claude-у да сажме давања, али не може да евидентира поклон. Кључ са people:write може да дода особу, али не може да види донације. Погледајте API кључеве за то шта свака дозвола омогућава.
Други načini повезивања
Claude Code (CLI)
У терминалу:
claude mcp add --scope user --transport http b1 https://api.churchapps.org/mcp \
--header "Authorization: Bearer cak_<prefix>.<secret>"
То је све. У било којој Claude Code сесији укуцајте /mcp да потврдите да је b1 сервер повезан, па питајте Claude било шта о вашој цркви.
Claude Desktop — ручна конфигурација (напредно)
Ако не желите да користите додатак, измените датотеку конфигурације Claude Desktop-а:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Додајте унос b1 сервера који се повезује са B1 преко mcp-remote (потребан је Node.js):
{
"mcpServers": {
"b1": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://api.churchapps.org/mcp",
"--header", "Authorization:Bearer cak_<prefix>.<secret>"
]
}
}
}
Поново покрените Claude Desktop. Мени конектора у пољу за унос у разговору приказаће b1 са његовим алатима.
Claude.ai (веб) — прилагођени конектор
Видите Опцију 1 горе. Конектор користи OAuth 2.1: Claude открива B1-ов ауторизациони сервер преко https://api.churchapps.org/.well-known/oauth-protected-resource, региструје се помоћу Dynamic Client Registration и пријављује се преко PKCE. На Team и Enterprise плановима власник можда прво мора да дода конектор за организацију. Claude не тражи посебне дозволе, па страница за сагласност нуди све што пријављени B1 налог може да приступи. Опозовите га под Settings → Developer → Connected Apps (Подешавања → Програмер → Повезане апликације) у B1 Admin-у.
Како ради
B1 API излаже једну MCP крајњу тачку на /mcp. Claude се повезује на њу, аутентификује се својим cak_… кључем и добија приступ четири алата:
| Алат | Шта ради |
|---|---|
list_endpoints | Наводи REST крајње тачке које Claude може да позове, уз филтрирање по путањи. Користи се за откривање. |
describe_endpoint | Враћа кратак опис и пример захтева/одговора за одређену крајњу тачку. |
api_call | Заправо позива REST крајњу тачку као аутентификовани корисник. |
describe_page_builder | Водич за прављење и уређивање страница ваше црквене веб-странице, који Claude чита пре рада на садржају сајта. |
Ово је иста површина /membership/people, /giving/donations, /attendance/visits итд. коју користи B1 Admin — свако правило ауторизације се примењује подједнако. FreePlay (lessons.church) крајње тачке наведене су под /lessons/*; Claude-ови позиви ка њима се прослеђују FreePlay-у као исти корисник, са истим дозволама.
Безбедност и ограничења
- Изолација по цркви. API кључ се односи на једну цркву. Claude нема начина да види податке других цркава.
- Ограничено дозволама. Ако уклоните дозволу особи која је направила кључ у B1 Admin-у, Claude је губи при следећем позиву — одмах.
- Опозиво. Обришите кључ у Settings → Developer → API Keys (Подешавања → Програмер → API кључеви) и Claude-ов приступ се одмах прекида.
- Списак забрањених. Webhook-ови провајдера, крајње тачке за administraciju OAuth клијената и руте намењене само оператерима (
apiEmails) не могу се позвати преко MCP-а. - Ограничење величине одговора. Један одговор алата ограничен је на 64 KB како дуге листе не би преоптеретиле Claude-ов контекст — Claude ће у том случају сузити упит филтерима.
- Трag ревизије. Измене иду кроз исти дневник ревизије као и радње у B1 Admin-у; можете их прегледати под Settings → Audit Log (Подешавања → Дневник ревизије).
Решавање проблема
Claude тражи B1 имејл и лозинку за коришћење FreePlay-а: имате верзију 1.1.0 десктоп додатка. Поново га преузмите и инсталирајте да бисте га ажурирали — новије верзије користе само ваш кључ.
Claude јавља „Unauthorized“ или 401: bearer токен недостаје, неисправан је или је кључ опозван. Ако сте користили додатак, отворите Settings → Extensions → B1 (ChurchApps) (Подешавања → Додаци → B1 (ChurchApps)) у Claude-у и поново налепите кључ. Иначе поново проверите заглавље Authorization: Bearer cak_… (обратите пажњу на размак и на реч Bearer).
Позив алата враћа 403: API кључ нема дозволу за ту крајњу тачку. Додајте дозволу у Settings → Developer → API Keys (Подешавања → Програмер → API кључеви) (мораћете да направите нови кључ — дозволе се не могу мењати на месту) и налепите нови кључ у подешавања додатка или у Claude-ову конфигурацију.
Claude не може да пронађе крајњу тачку: замолите га да позове list_endpoints са филтером, на пример „користи list_endpoints са филтером 'donations' да пронађеш праву путању“. Инвентар рута се генерише из живог API-ја, тако да је све што можете да позовете преко curl-а ту.
Локални развој: замените https://api.churchapps.org/mcp са http://localhost:8084/mcp — иста аутентификација, исти алати.
Повезано
- API кључеви — потпуни преглед дозвола
- MCP сервер (референца за програмере) — детаљи протокола и шеме алата
- ChatGPT — исти приступ, за OpenAI-јеве моделе