Перейти до основного вмісту

Claude

Запитуйте Claude про вашу церкву простою мовою, і він відповідатиме на основі даних B1, включно з вашими уроками та класами FreePlay. Питання на кшталт «скільки гостей-новачків прийшло в неділю?» або «хто приєднався до малої групи цього місяця?» чи прохання «додай на наш сайт нову сторінку під назвою Події». Налаштування займає менше 3 хвилин, і для встановлення не потрібні технічні навички чи програми.

Що вам потрібно

  • Обліковий запис Claude. Безкоштовний план працює, це добрий спосіб спробувати. Однак у безкоштовних облікових записів є денний ліміт повідомлень, а пошук даних у B1 витрачає повідомлення швидко, тож якщо ви користуватиметеся ним регулярно, рекомендуємо Claude Pro (близько 20 доларів на місяць).
  • Ваш логін B1, той самий, що й для B1 Admin.
Рекомендовано: можна спробувати безкоштовно

Claude є найпростішим способом підключити B1 до ШІ, і він працює на безкоштовному плані Claude. Це ідеальний спосіб для вашої церкви спробувати перед будь-якими витратами.

Є два способи підключення. Варіант 1 найпростіший: ключ не потрібен, і нічого встановлювати не треба.

Варіант 1: вхід через B1 (найпростіший)​

Працює на веб-сайті Claude, у настільному застосунку Claude та в мобільному застосунку Claude. Налаштуйте один раз, і він буде на всіх пристроях.

Крок 1: відкрийте налаштування конекторів Claude​

  1. Перейдіть на claude.ai і увійдіть (або створіть безкоштовний обліковий запис).
  2. Натисніть своє ім'я в лівому нижньому куті, а потім Персоналізація → Конектори.

Крок 2: додайте B1​

  1. Натисніть Додати, а потім Додати власний конектор.
  2. Назва: введіть B1.
  3. URL: вставте https://api.churchapps.org/mcp
  4. Залиште інші параметри без змін і натисніть Додати.

Крок 3: увійдіть у B1​

  1. Натисніть Підключити. Відкриється сторінка входу B1.
  2. Увійдіть зі своїм обліковим записом B1. Якщо ви належите до кількох церков, переконайтеся, що вгорі показано потрібну.
  3. B1 покаже, що саме Claude просить дозволити, і повідомить, що вас повернуть на claude.ai. Натисніть Дозволити.

Ви знову в Claude, і B1 позначено як підключений.

Крок 4: поставте питання​

Почніть новий чат і спробуйте, наприклад:

  • «Скільки людей у нашій церкві?»
  • «Перелічи наші активні групи.»
  • «Підсумуй пожертви за цей місяць за фондами.»
  • «Хто приєднався до церкви за останні 30 днів?»

Уперше Claude попросить дозвіл на використання B1. Натисніть Дозволити.

Варіант 2: розширення для настільного застосунку з ключем B1​

Скористайтеся цим варіантом, якщо хочете дати Claude ключ з обмеженими правами, наприклад лише для читання. Він працює в настільному застосунку Claude для Mac або Windows. Щоб створити ключ, потрібен дозвіл на керування налаштуваннями церкви в B1.

Крок 1: отримайте застосунок Claude​

Завантажте застосунок Claude з claude.com/download, встановіть, відкрийте і увійдіть.

Крок 2: створіть ключ B1​

Ключ дає Claude доступ до B1 вашої церкви. Це як пароль лише для Claude.

  1. Увійдіть у B1 Admin і перейдіть до Налаштування → Розробник.
  2. На вкладці API-ключі натисніть Новий API-ключ.
  3. Назва: введіть Claude.
  4. Області доступу (Scopes): позначте, що може робити Claude. Кожна область має прапорець read (лише перегляд) і прапорець write (внесення змін). Не впевнені? Для початку позначте лише прапорці read. Пізніше можна створити новий ключ із ширшими правами.
  5. Натисніть Зберегти, потім Копіювати ключ. Його показують лише один раз, тож одразу переходьте до кроку 3.

Крок 3: додайте B1 до Claude​

  1. Завантажте розширення B1.
  2. Двічі клацніть завантажений файл (b1-churchapps.mcpb). Claude відкриється і покаже B1 (ChurchApps).
  3. Натисніть Встановити.
  4. Коли з'явиться запит на ключ API B1, вставте ключ із кроку 2 і збережіть.
  5. Повністю закрийте Claude (Mac: Cmd+Q · Windows: клацніть правою кнопкою миші на значку Claude на панелі завдань → Вийти), а потім відкрийте його знову.

Якщо подвійне клацання не відкриває Claude, перейдіть у Claude до Налаштування → Розширення → Додаткові налаштування → Встановити розширення… і виберіть завантажений файл. Потім почніть новий чат і поставте питання.

Розширення вже встановлено?

Нічого робити не треба: FreePlay працює через те саме підключення. Єдиний виняток — версія 1.1.0, яка запитувала email і пароль B1. Щоб оновити її, завантажте й встановіть розширення знову. Ваш ключ збережеться.

Чи це безпечно?​

  • Claude бачить лише дані вашої церкви.
  • Вхід в обліковий запис (Варіант 1): Claude ніколи не може зробити більше, ніж може ваш власний логін B1. Сторінка входу B1 перелічує все, що Claude може робити, перш ніж ви натиснете Дозволити.
  • З ключем (Варіант 2): Claude може робити лише те, що дозволяє ключ у B1. Ключ лише з прапорцями read може переглядати дані, але ніколи нічого не змінити. FreePlay працює так само, з тим самим ключем.
  • Щоб вимкнути: у B1 Admin перейдіть до Налаштування → Розробник і відкличте застосунок у розділі Підключені застосунки (Варіант 1) або видаліть ключ у розділі API-ключі (Варіант 2). Доступ припиняється одразу. Також можна натиснути Від'єднати на конекторі B1 у Claude.

Скільки це коштує?​

Підключення B1 безкоштовне, воно входить до ChurchApps. Claude має безкоштовний план, а Claude Pro (близько 20 доларів на місяць) дає значно більше можливостей. Див. claude.com/pricing.

Технічні деталі​

Решта цієї сторінки призначена для технічних користувачів і ШІ-асистентів: області доступу, інші способи підключення та принцип роботи.

Області доступу​

Claude взаємодіє з B1 через сервер Model Context Protocol (MCP), вбудований в API B1 (https://api.churchapps.org/mcp). Кожен виклик проходить ті самі правила автентифікації, дозволів і прив'язки до церкви, що й запит із B1 Admin. Claude обмежений дозволами та областями доступу ключа API і не може звертатися до вебхуків, адміністративних кінцевих точок OAuth чи інших шляхів, доступних лише оператору.

Поширені стартові набори областей:

  • Асистент лише для читання: people:read, groups:read, attendance:read, donations:read, content:read
  • Читання та додавання нотаток або завдань: додайте people:write
  • Повноцінний операційний асистент: додайте потрібні відповідні області :write

Ключ із donations:read дозволяє Claude підсумовувати пожертви, але не може зафіксувати подарунок. Ключ із people:write може додати людину, але не бачить пожертв. Щоб дізнатися, що дозволяє кожна область, див. API-ключі.

Інші способи підключення​

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. Відкликати доступ можна в B1 Admin: Налаштування → Розробник → Підключені застосунки.

Як це працює​

API B1 надає єдину кінцеву точку MCP за адресою /mcp. Claude підключається до неї, автентифікується вашим ключем cak_… і отримує доступ до чотирьох інструментів:

ІнструментЩо робить
list_endpointsПерелічує кінцеві точки REST, які може викликати Claude, з можливістю фільтрації за шляхом. Використовується для пошуку.
describe_endpointПовертає короткий опис і приклад запиту та відповіді для конкретної кінцевої точки.
api_callФактично викликає кінцеву точку REST від імені автентифікованого користувача.
describe_page_builderПосібник зі створення та редагування сторінок вашого сайту церкви. Claude читає його перед роботою з вмістом сайту.

Це та сама поверхня /membership/people, /giving/donations, /attendance/visits тощо, яку використовує B1Admin. Усі правила авторизації застосовуються однаково. Кінцеві точки FreePlay (lessons.church) перелічено в /lessons/*. Виклики Claude до них передаються в FreePlay від імені того самого користувача з тими самими дозволами.

Безпека та обмеження​

  • Ізоляція за церквою. Ключ API прив'язаний до однієї церкви. Claude не може побачити дані інших церков.
  • Обмеження за дозволами. Якщо ви відберете дозвіл у людини, яка створила ключ, у B1Admin, Claude втратить його під час наступного виклику, миттєво.
  • Відкличний доступ. Видаліть ключ у Налаштування → Розробник → API-ключі, і доступ Claude припиниться одразу.
  • Чорний список. Вебхуки провайдерів, адміністративні кінцеві точки клієнтів OAuth і маршрут apiEmails, доступний лише оператору, не можна викликати через MCP.
  • Обмеження розміру відповіді. Одна відповідь інструмента обмежена 64 КБ, щоб довгі списки не переповнювали контекст Claude. У такому разі Claude звузить запит за допомогою фільтрів.
  • Журнал аудиту. Зміни проходять через той самий журнал аудиту, що й дії в B1Admin. Переглянути їх можна в Налаштування → Журнал аудиту.

Усунення несправностей​

Claude просить email і пароль B1, щоб використовувати FreePlay: у вас версія 1.1.0 настільного розширення. Завантажте й встановіть його знову, щоб оновити. Новіші версії використовують лише ваш ключ.

Claude повідомляє «Unauthorized» або помилку 401: токен авторизації відсутній, має неправильний формат або ключ відкликано. Якщо ви використовували розширення, відкрийте в Claude Налаштування → Розширення → B1 (ChurchApps) і вставте ключ ще раз. В іншому разі перевірте заголовок Authorization: Bearer cak_… (зверніть увагу на пробіл і слово Bearer саме в такому написанні).

Виклик інструмента повертає 403: ключ API не має області доступу для цієї кінцевої точки. Додайте потрібну область у Налаштування → Розробник → API-ключі. Для цього доведеться створити новий ключ, бо області не можна змінити на місці. Потім вставте новий ключ у налаштування розширення або в конфігурацію Claude.

Claude не може знайти кінцеву точку: попросіть його викликати list_endpoints із фільтром, наприклад: «використай list_endpoints з фільтром "donations", щоб знайти потрібний шлях». Перелік маршрутів генерується з живого API, тож усе, що можна перевірити через curl, там є.

Локальна розробка: замініть https://api.churchapps.org/mcp на http://localhost:8084/mcp. Автентифікація та інструменти ті самі.

Пов'язане​