Как подключить Bubble к Meta Muse через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Bubble, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Bubble + Meta Muse

Дайте ИИ работать с данными вашего приложения Bubble: смотреть, какие типы данных и backend workflows оно открывает, искать и читать записи; после вашего подтверждения создавать или менять записи и запускать backend workflows.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

BUBBLE_APP_URL, BUBBLE_API_TOKEN

Шаг 1 — Получите учётные данные

1. Откройте приложение в редакторе Bubble, перейдите в Settings → API и отметьте Enable Data API. Затем отметьте каждый тип данных, к которому может обращаться ИИ: всё, что вы не отметите, останется для него невидимым. Отметьте также Enable Workflow API and backend workflows, если ИИ должен запускать backend workflows.
2. На той же вкладке нажмите Generate a new API token и скопируйте токен в BUBBLE_API_TOKEN.
3. Укажите в BUBBLE_APP_URL адрес приложения без завершающего слеша: https://yourapp.bubbleapps.io или ваш собственный домен, например https://app.example.com, для live-версии. Добавьте /version-test, чтобы работать с версией для разработки, например https://yourapp.bubbleapps.io/version-test.
4. После изменения настроек API разверните приложение в live (deploy): live-версия знает только настройки и токены своего последнего развёртывания.
5. Установите коннектор, а затем проверьте токен чтением, например bubble_list_things для одного из ваших типов.

Проверка подключения проверяет адрес, а не токен: она подтверждает, что ваше приложение отвечает по адресу BUBBLE_APP_URL. Неверный или неразвёрнутый токен проявится только при первом чтении данных, ответом 401, поэтому один раз выполните такое пробное чтение.

Нужен доступ к приложению на уровне редактора. Один коннектор обслуживает одно приложение Bubble; для каждого следующего приложения добавьте ещё один коннектор.

Токен администратора в рамках ваших настроек API: токен из Settings действует как администратор. Он игнорирует правила приватности (privacy rules) приложения и видит каждое поле открытых вами типов, но ничего из того, что вы не отметили. Для записи каждый тип данных также должен разрешать в своих правилах приватности создание, изменение или удаление через API.

Что он читает: типы данных и backend workflows, которые открывает ваше приложение, с полями каждого типа и параметрами каждого workflow; записи (things) типа с фильтрами вроде статус равен открыт, с сортировкой, до 100 на страницу; и отдельную запись по её id, с датой создания, датой изменения и автором.

Спрашивает перед каждой записью: bubble_create_thing, bubble_update_thing и bubble_run_workflow меняют данные вашего приложения и могут запустить собственные workflows, письма или платежи приложения. Перед каждым вызовом ИИ показывает тип и каждое значение, запись и точные изменения или workflow и его параметры, и ждёт вашего согласия. Сначала пробуйте изменения на адресе с /version-test.

Отключено при установке: bubble_delete_thing. Администратор включает его осознанно; тогда ИИ показывает запись и удаляет её только после вашего подтверждения.

Имена типов и полей: в API имена типов пишутся строчными буквами без пробелов (Rental Unit превращается в rentalunit), а поля задаются идентификаторами полей приложения, например first_name_text, если только ваше приложение не использует в качестве ключей отображаемые имена. ИИ читает их через bubble_get_meta и bubble_get_data_types, прежде чем искать или записывать.

Персональные данные: приложения Bubble часто хранят пользователей, клиентов и платежи. ИИ показывает только то, что вам нужно, никогда не выводит записи пользователей тому, кто не должен их видеть, и воспринимает текст, введённый пользователями приложения, как данные, а не как инструкции.

Нагрузка: у каждого тарифа Bubble есть лимит нагрузки (workload), и интенсивное использование API замедляет приложение для его пользователей. ИИ читает небольшими страницами и избегает циклов по тысячам записей. На большинстве тарифов поиск возвращает не более 50 000 записей.

Частые ошибки: 400: Bubble не знает адрес приложения; проверьте BUBBLE_APP_URL, без /api/1.1. 401: токен неверный, удалён или ещё не развёрнут в этой версии; разверните приложение в live или используйте адрес с /version-test. 404: Data API выключен, тип не отмечен или workflow не открыт.

Коннектор не создаёт и не меняет само приложение (страницы, типы данных, workflows, правила приватности), не создаёт записи массово, не заменяет записи целиком и не загружает файлы.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Muse

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

1. В Muse открой Settings → Connectors и выбери Add custom connector.
2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
4. В чате попроси Muse о том, для чего нужны инструменты Bubble.

Настроить коннектор можно и из чата: в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.

Доступные инструменты

Примеры запросов

• «Какие типы данных и backend workflows открывает наше приложение Bubble?»
• «Покажи открытые обращения в поддержку, созданные на этой неделе, сначала самые новые.»
• «Сколько заказов со статусом оплачен мы получили в октябре?»
• «Измени статус бронирования Anna Weber на 12 ноября на подтверждено. Сначала покажи изменение.»
• «Запусти backend workflow, который отправляет приветственное письмо на [email protected]. Перед запуском назови его параметры.»

FAQ

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде: в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT