Перейти к основному содержимому

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​

  1. Перейдите на claude.ai и войдите (или создайте бесплатную учётную запись).
  2. Нажмите на ваше имя в левом нижнем углу, затем Customize → Connectors.

Шаг 2 — Добавьте B1​

  1. Нажмите Add, затем Add custom connector.
  2. Name: введите B1.
  3. URL: вставьте https://api.churchapps.org/mcp
  4. Остальные параметры оставьте как есть и нажмите Add.

Шаг 3 — Войдите в B1​

  1. Нажмите Connect. Откроется страница входа B1.
  2. Войдите с вашей учётной записью B1. Если вы состоите в нескольких церквях, проверьте, что на странице указана нужная церковь («Would you like to access the following data from your church…»).
  3. 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.

  1. Войдите в B1 Admin и перейдите в Settings → Developer.
  2. На вкладке API Keys нажмите New API Key.
  3. Name: введите Claude.
  4. Scopes: отметьте, что Claude может делать. У большинства разделов есть флажок read (только просмотр) и флажок write (вносить изменения); у форм есть только forms:write. Не уверены? Начните, отметив только флажки read — позже вы сможете создать новый ключ с большими правами.
  5. Нажмите Save, затем Copy ключ. Он показывается только один раз, поэтому сразу переходите к шагу 3.

Шаг 3 — Добавьте B1 в Claude​

  1. Скачайте расширение B1.
  2. Дважды щёлкните по скачанному файлу (b1-churchapps.mcpb). Откроется Claude и покажет B1 (ChurchApps).
  3. Нажмите Install.
  4. Когда появится запрос B1 API key, вставьте ключ из шага 2 и сохраните.
  5. Полностью закройте 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 — та же аутентификация, те же инструменты.