Skip to main content
Connect BubblaV to OpenMausBot (also called MausBot), the open-source desktop app where every contact is an AI agent. Your bots can then read your BubblaV reports, conversations and knowledge base, and make the changes you ask for. The connection uses OAuth, so you do not need an API key.
A one-click BubblaV card in Plugins is submitted to the OpenMausBot project and waits for review. Until it ships in an OpenMausBot release, add BubblaV as an MCP server with its address. Both ways give the same tools.

Why Connect OpenMausBot?

  • A bot for your support chatbot: Ask a bot each morning which questions your chatbot could not answer, and let it add the missing answers.
  • Answers from your own data: Bots read your BubblaV reports, conversations, leads and knowledge base, which a browser cannot see without your login.
  • Change settings by chat: Update the chatbot instructions, widget, forms and Help Center articles.
  • Read only if you want: Give the connection access that can read but not change anything.

Prerequisites

  • A BubblaV account. You can sign up for free during the connection.
  • OpenMausBot on macOS, Windows or Ubuntu. See Install MausBot.

Connect BubblaV

1

Open the card

In OpenMausBot, open Plugins, search for BubblaV, and select Connect.
2

Sign in to BubblaV

Your browser opens the BubblaV sign-in page. Sign in, or create an account. If you have no chatbot yet, choose I don’t have a website to create one from text or a file.
3

Choose the chatbot and the access level

Select the chatbot (website) to connect. Then choose Full access or Read only, and select Authorize.
4

Choose which bots get BubblaV

Return to OpenMausBot. The card shows the connection. Select Bot access on the card to choose which bots can use BubblaV.
Then ask a bot, for example “Which questions could my BubblaV chatbot not answer last week?” or “Give me this month’s chatbot report.” An API key named MCP Client is created in your BubblaV account for this connection. The bots can only access the chatbot you selected.

Full access or Read only

  • Full access: bots can read your chatbot data and make the changes you ask for, including deletes.
  • Read only: bots get only the tools that read data. Every other tool returns an error.
On the BubblaV card, Bot access sets which bots can use BubblaV. Give it only to the bots that need it.

Tools

The connection gives your bots the full BubblaV MCP tool set: reports, unanswered questions, conversations, leads, knowledge, crawling, widget and chatbot settings, forms, Help Center, flows and custom webhook tools. See the MCP Server tool reference for each tool. Some tools need a Pro plan; on other plans they return a PLAN_REQUIRED error that says so.

Rate Limits

MCP calls are counted per BubblaV account, for each billing period, across all your websites: A routine that runs every day uses calls every day. When you reach the limit, BubblaV answers with HTTP 429 until the next billing period starts. See your usage under Settings → API Keys in the dashboard.

Disconnect or Change Access

To disconnect, select Disconnect on the BubblaV card, or remove the server in Plugins → MCP servers. Also revoke the MCP Client key under Settings → API Keys in the BubblaV dashboard. To connect a different chatbot or change between Full access and Read only, revoke the key and sign in again. The key expires after 1 year. OpenMausBot then shows Needs sign-in; sign in again to continue.

Troubleshooting

  • The card is visible after the OpenMausBot project accepts it and releases a new version. Add BubblaV with its address instead (see the MCP server address tab above).
  • This is expected when OpenMausBot runs on another computer. Copy the full address of the page that can’t load, paste it into Redirect URL in the sign-in panel, and select Complete sign-in.
  • You connected with Read only access. Revoke the MCP Client key in BubblaV and sign in again with Full access.
  • Revoke the MCP Client key in BubblaV, then sign in again and select the correct website.
  • Your plan’s limit on active API keys is reached. Revoke unused keys under Settings → API Keys, then sign in again. See API key limits.

Next Steps

MCP Server

Full tool reference, OAuth details and other MCP clients

Content Gaps

Find and fix the questions your chatbot cannot answer

AI Agent Workflows

Recipes to diagnose gaps and tune your bot