インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Bubble をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
Bubble アプリのデータを AI で使えます。アプリが公開しているデータタイプとバックエンドワークフローの確認、レコードの検索と参照ができ、確認のうえでレコードの作成や変更、バックエンドワークフローの実行もできます。
こう聞いてみよう
Bubble のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Bubble をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Bubble + ChatGPT
Bubble アプリのデータを AI で使えます。アプリが公開しているデータタイプとバックエンドワークフローの確認、レコードの検索と参照ができ、確認のうえでレコードの作成や変更、バックエンドワークフローの実行もできます。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
BUBBLE_APP_URL, BUBBLE_API_TOKEN
ステップ 1 — 認証情報を取得
- Bubble エディターでアプリを開き、Settings → API で Enable Data API にチェックを入れます。続いて、AI にアクセスさせるデータタイプにそれぞれチェックを入れます。チェックしなかったものは AI からは見えません。AI にバックエンドワークフローを実行させる場合は、Enable Workflow API and backend workflows にもチェックを入れます。
- 同じタブで Generate a new API token をクリックし、トークンを
BUBBLE_API_TOKENに貼り付けます。 BUBBLE_APP_URLに、末尾のスラッシュを付けずにアプリのアドレスを設定します。本番（live）版ならhttps://yourapp.bubbleapps.ioか、https://app.example.comのような独自ドメインです。開発版を使う場合は/version-testを付けます（例:https://yourapp.bubbleapps.io/version-test）。- API 設定を変更したら、アプリを live にデプロイします。live 版が認識するのは、最後にデプロイした時点の設定とトークンだけです。
- コネクタをインストールしたら、データタイプのどれかに
bubble_list_thingsを実行するなど、読み取りでトークンを確認します。
接続テストで確認されるのはアドレスで、トークンではありません: テストでは、アプリが BUBBLE_APP_URL で応答することを確認します。トークンが間違っている、またはデプロイされていない場合は、最初にデータを読み取ったときに初めて 401 として現れます。そのため、このテスト読み取りを一度実行してください。
アプリのエディター権限が必要です。1 つのコネクタで扱えるのは 1 つの Bubble アプリです。ほかのアプリにはそれぞれコネクタを追加してください。
API 設定の範囲に限られる管理者トークン: Settings で発行したトークンは管理者として動作します。アプリのプライバシールール（privacy rules）は無視され、公開したデータタイプのすべてのフィールドが見えますが、チェックしていないものは見えません。書き込みには、各データタイプのプライバシールールで API 経由の作成、変更、削除も許可されている必要があります。
参照できるもの: アプリが公開しているデータタイプとバックエンドワークフロー、および各タイプのフィールドと各ワークフローのパラメーター。あるタイプのレコード（things）。ステータスがオープンに等しい、といった条件での絞り込みと並べ替えができ、1 ページ最大 100 件です。ID を指定した 1 件のレコード。作成日、更新日、作成者を含みます。
書き込みの前には必ず確認します: bubble_create_thing、bubble_update_thing、bubble_run_workflow はアプリのデータを変更し、アプリ自身のワークフロー、メール、支払いを起動することがあります。AI はそれぞれの前に、タイプとすべての値、対象のレコードと正確な変更内容、またはワークフローとそのパラメーターを示し、あなたの承認を待ちます。書き込みはまず /version-test のアドレスで試してください。
インストール時に無効: bubble_delete_thing。管理者が意図して有効にします。有効にした場合も、AI はレコードを示し、あなたが確認してから削除します。
タイプ名とフィールド名: API では、タイプ名は小文字でスペースなしになり（Rental Unit は rentalunit）、フィールドは first_name_text のようなアプリのフィールド ID で指定します。ただし、アプリが表示名をキーとして使っている場合は表示名です。AI は検索や書き込みの前に、bubble_get_meta と bubble_get_data_types でこれらを確認します。
個人データ: Bubble アプリには、ユーザー、顧客、支払いが保存されていることがよくあります。AI は必要なものだけを表示し、見るべきでない人にユーザーのレコードを一覧表示することはありません。また、アプリのユーザーが入力したテキストは指示ではなくデータとして扱います。
処理能力: Bubble のどのプランにもワークロードの上限があり、API を多用するとユーザーにとってアプリの動作が遅くなります。AI は小さなページ単位で読み取り、何千件ものレコードを繰り返し処理することは避けます。ほとんどのプランで、1 回の検索で返されるのは最大 50,000 件です。
よくあるエラー: 400: Bubble がアプリのアドレスを認識していません。BUBBLE_APP_URL を /api/1.1 なしで設定しているか確認してください。401: トークンが間違っている、削除された、またはこのバージョンにまだデプロイされていません。live にデプロイするか、/version-test のアドレスを使ってください。404: Data API がオフになっている、タイプにチェックが入っていない、またはワークフローが公開されていません。
このコネクタは、アプリの構築や変更（ページ、データタイプ、ワークフロー、プライバシールール）、レコードの一括作成、レコード全体の置き換え、ファイルのアップロードには対応していません。
ステップ 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 — ChatGPT にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、+ をクリックして Add custom MCP server を選びます。
- 名前を入力します（例: Name:
Bubble）。 - Connection の Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| Tool | What it does |
|---|---|
bubble_get_meta | Read what the Bubble app exposes through its API: the data types the Data API can reach (dataTypes), and the backend workflows the Workflow… |
bubble_get_data_types | Read the data types of the Bubble app with their fields: for each type its display name and fields with id (the key to use in constraints… |
bubble_list_things | List or search the things (records) of one data type, up to 100 per call |
bubble_get_thing | Read one thing of a data type by its unique id: all fields the token may see, plus _id, Created Date, Modified Date and Created By |
bubble_create_thing | Create a new thing of a data type |
bubble_update_thing | Change fields of an existing thing; fields left out keep their value |
bubble_run_workflow | Run a backend workflow exposed through the app's Workflow API |
bubble_delete_thing | Delete one thing for good |
プロンプトの例
- 「私たちの Bubble アプリが公開しているデータタイプとバックエンドワークフローは何ですか？」
- 「今週作成された未対応のサポート依頼を、新しい順に見せてください。」
- 「10 月に支払い済みステータスの注文は何件ありましたか？」
- 「11 月 12 日の Anna Weber さんの予約のステータスを確定に変更してください。先に変更内容を見せてください。」
- 「[email protected] にウェルカムメールを送るバックエンドワークフローを実行してください。開始する前にパラメーターを教えてください。」
FAQ
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?
