> ## Documentation Index > Fetch the complete documentation index at: https://docs.bubblav.com/llms.txt > Use this file to discover all available pages before exploring further. # OpenMausBot > Connect BubblaV to OpenMausBot (MausBot) so your bots can check chatbot performance, find unanswered questions, and teach your chatbot 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. > [!NOTE] > > 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](https://docs.openmausbot.com/docs/getting-started/installation). ## Connect BubblaV > [tab] BubblaV card > > **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. > [tab] MCP server address > > **1. Add the server** > > In OpenMausBot, open **Plugins → MCP servers → Add server** and paste: > > ```text theme={null} > https://www.bubblav.com/mcp > ``` > > Select **Add**. The server asks you to sign in. > > **2. Sign in to BubblaV** > > Select **Sign in**. Your browser opens the BubblaV sign-in page. Sign in, or create an account. > > **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. Check the connection** > > Return to OpenMausBot. The server shows **Signed in** and lists its tools. 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](https://docs.bubblav.com/developer-guide/mcp-server.md) 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: | Plan | MCP calls per billing period | | - | - | | Free | 100 | | Pro | 5,000 | | Custom | Set in your contract | 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 > [accordion] I cannot find the BubblaV card > > * 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). > [accordion] Sign-in on MausBot Cloud or a server shows a page that can't load > > * 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**. > [accordion] Bots say they cannot make changes > > * You connected with **Read only** access. Revoke the **MCP Client** key in BubblaV and sign in again with **Full access**. > [accordion] I connected the wrong chatbot > > * Revoke the **MCP Client** key in BubblaV, then sign in again and select the correct website. > [accordion] Sign-in fails with an API key limit > > * 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](https://docs.bubblav.com/developer-guide/mcp-server.md#api-key-limits). ## Next Steps > [card] [MCP Server](https://docs.bubblav.com/developer-guide/mcp-server.md) > > Full tool reference, OAuth details and other MCP clients > [card] [Content Gaps](https://docs.bubblav.com/user-guide/knowledge/content-gaps.md) > > Find and fix the questions your chatbot cannot answer > [card] [AI Agent Workflows](https://docs.bubblav.com/user-guide/ai-agent-workflows.md) > > Recipes to diagnose gaps and tune your bot This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.