Claude
Спрашивайте Claude о вашей церкви обычным языком — он отвечает на основе данных B1, включая ваши уроки и классы FreePlay. Вопросы вроде «сколько гостей, впервые пришедших, было в воскресенье?» или «кто присоединился к малой группе в этом месяце?» — или попросите что-то сделать, например, «добавь на наш сайт новую страницу под названием Events». Настройка занимает менее 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. Если вы состоите в нескольких церквях, проверьте, что на странице указана нужная церковь («Would you like to access the following data from your church…»).
- B1 покажет, что запрашивает Claude (Everything your B1 account can access), отметит, что приложение зарегистрировало себя в B1, и подтвердит, что вас вернут на 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 вашей церкви; считайте его паролем только для Claude.
- Войдите в B1 Admin и перейдите в Settings → Developer.
- На вкладке API Keys нажмите New API Key.
- Name: введите
Claude. - Scopes: отметьте, что Claude может делать. У большинства разделов есть флажок read (только просмотр) и флажок write (вносить изменения); у форм есть только forms:write. Не уверены? Начните, отметив только флажки read — позже вы сможете создать новый ключ с большими правами.
- Нажмите Save, затем Copy ключ. Он показывается только один раз, поэтому сразу переходите к шагу 3.
Шаг 3 — Добавьте B1 в Claude
- Скачайте расширение B1.
- Дважды щёлкните по скачанному файлу (
b1-churchapps.mcpb). Откроется Claude и покажет B1 (ChurchApps). - Нажмите Install.
- Когда появится запрос B1 API key, вставьте ключ из шага 2 и сохраните.
- Полностью закройте Claude (Mac: Cmd+Q · Windows: правый клик по значку Claude на панели задач → Quit) и откройте его снова.
Если двойной щелчок не открывает Claude, в Claude перейдите в Settings → Extensions → Advanced settings → Install Extension… и выберите скачанный файл. Затем начните новый чат и задайте вопрос.
Ничего делать не нужно — 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 (вариант 2). Доступ прекращается сразу. Также можно нажать Disconnect на коннекторе 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. Отозвать доступ можно в Settings → Developer → Connected Apps в 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 потеряет его при следующем вызове — мгновенно.
- Отзыв. Удалите ключ в Settings → Developer → API Keys, и доступ Claude прекращается сразу.
- Чёрный список. Конечные точки веб-хуков платёжных провайдеров, административные конечные точки клиентов OAuth, а также конечные точки входа, регистрации, пароля и двухфакторной аутентификации недоступны через MCP.
- Ограничение размера ответа. Один ответ инструмента ограничен 64 КБ, чтобы длинные списки не переполняли контекст Claude; в таком случае Claude сузит запрос фильтрами.
- Журнал аудита. Изменения проходят через тот же журнал аудита, что и действия в B1Admin; просмотреть их можно в Settings → Audit Log.
Устранение неполадок
Claude просит адрес электронной почты и пароль B1, чтобы использовать FreePlay: у вас версия 1.1.0 настольного расширения. Чтобы обновить её, скачайте и установите заново — в новых версиях достаточно только ключа.
Claude сообщает «Unauthorized» или 401: токен авторизации отсутствует, искажён или ключ отозван. Если вы использовали расширение, откройте в Claude Settings → Extensions → B1 (ChurchApps) и вставьте ключ заново. В остальных случаях проверьте заголовок Authorization: Bearer cak_… (обратите внимание на пробел и слово Bearer без изменений).
Вызов инструмента возвращает 403: у API-ключа нет области для этой конечной точки. Добавьте область в Settings → Developer → API Keys (придётся создать новый ключ — области у существующего ключа не меняются) и вставьте новый ключ в настройки расширения или в конфигурацию Claude.
Claude не может найти конечную точку: попросите его вызвать list_endpoints с фильтром, например: «используй list_endpoints с фильтром 'donations', чтобы найти нужный путь». Список маршрутов генерируется из работающего API, так что всё, к чему можно обратиться через curl, там есть.
Локальная разработка: замените https://api.churchapps.org/mcp на http://localhost:8084/mcp — та же аутентификация, те же инструменты.
Связанное
- Ключи API — полный справочник областей доступа
- Сервер MCP (справочник для разработчиков) — подробности протокола и схемы инструментов
- ChatGPT — то же самое, но для моделей OpenAI