> ## 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.

# Claude

> Connect BubblaV to Claude via MCP to check chatbot performance, find unanswered questions, add knowledge, and manage your chatbot

Connect BubblaV to Claude through the BubblaV MCP Server. Ask Claude to check your chatbot's performance, find the questions it could not answer, teach it new knowledge, and change its settings. You do not need an API key.

BubblaV works in claude.ai, Claude Desktop, Claude mobile, Cowork, and Claude Code.

## Why Connect Claude?

* **Analytics on demand**: Get a full report for any date range, summarized in plain language
* **Close content gaps**: See what your bot could not answer and add the missing answers
* **Manage knowledge**: Search, add, and remove knowledge, upload files, and add pages to crawl
* **Review conversations and leads**: Filter, read, and search chats and captured leads
* **Tune the chatbot**: Change the persona, greetings, widget appearance, forms, flows, and custom tools
* **No API key**: OAuth handles the connection

## Prerequisites

* A BubblaV account. You can create one during the sign-in step
* A Claude plan that supports connectors

## Connect BubblaV

<Tabs>
  <Tab title="claude.ai / Desktop / Cowork">
    <Steps>
      <Step title="Add the connector">
        In Claude, open **Customize → Connectors** and search the directory for **BubblaV**. Or select **+**, then **Add custom connector**, and enter `https://www.bubblav.com/mcp`.
      </Step>

      <Step title="Authorize BubblaV">
        Claude opens the BubblaV sign-in page. Sign in, select the website (chatbot) to connect, and approve. If you do not have a website, choose to create a chatbot without one.
      </Step>

      <Step title="Try it">
        Ask Claude *"How is my chatbot performing this month?"* or *"Which questions could my chatbot not answer last week?"*
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    Install the BubblaV plugin. It adds the MCP server and two skills: **add-chat-widget** and **manage-custom-tools**.

    ```bash theme={null}
    /plugin marketplace add bubblav-org/bubblav-claude
    /plugin install bubblav@bubblav
    ```

    Or add only the MCP server:

    ```bash theme={null}
    claude mcp add --transport http bubblav https://www.bubblav.com/mcp
    ```

    The first time Claude calls a BubblaV tool, your browser opens the BubblaV sign-in page. Sign in, select the website, and approve. You can also run `/mcp` and select **bubblav** to sign in.
  </Tab>
</Tabs>

After you approve, BubblaV creates an API key labeled **Claude** in your account for the connection.

## What You Can Ask

Claude receives BubblaV's tools automatically and picks the right one for your request. A representative subset:

| Tool | What it does | Example prompt |
| - | - | - |
| `bubblav_read_report` | Full analytics report for a date range | "Give me last month's chatbot performance report" |
| `bubblav_list_unanswered_questions` | Questions the bot answered badly | "Which questions could my chatbot not answer last week?" |
| `bubblav_get_content_gaps` | Topics your knowledge base is missing | "What should I add to my knowledge base?" |
| `bubblav_search_knowledge` | Search your knowledge base | "Does my chatbot know our refund policy?" |
| `bubblav_add_knowledge` | Add a knowledge entry | "Add to my chatbot's knowledge: we are open Monday to Friday, 9 AM to 5 PM." |
| `bubblav_upload_knowledge_file` | Upload a PDF/DOCX/TXT/MD file (≤10 MB) to index | "Index this product spec PDF" |
| `bubblav_add_crawl_url` | Add a URL to crawl and index | "Index our new pricing page" |
| `bubblav_search_conversations` | Full-text search across chats | "Find chats that mention 'billing error'" |
| `bubblav_list_leads` | Visitors who left their email | "List the leads from this week" |
| `bubblav_update_website_settings` | Update the chatbot persona and instructions | "Make the bot friendlier and more concise" |
| `bubblav_update_widget_appearance` | Update bot name, greetings, colors, position | "Rename the bot to 'Sunny' and use a teal bubble" |
| `bubblav_get_widget_snippet` | Get the code that adds the chat widget to your site | "How do I add the chat widget to my website?" |
| `bubblav_create_custom_tool` | Create a webhook custom tool (Pro+) | "Add a tool that checks order status from our API" |

<Info>
  For the full tool reference, see the [MCP Server developer guide](/developer-guide/mcp-server). For ready-to-use prompts, see [AI Agent Workflows](/user-guide/ai-agent-workflows).
</Info>

## Permissions

Claude asks before it runs a tool that changes or deletes data, such as `bubblav_delete_knowledge` or `bubblav_update_widget_appearance`. Read-only tools, such as reports and searches, can run without a prompt. You can change this per tool in the connector settings.

## Privacy

* One connection gives access to one website (chatbot)
* Conversations and leads can contain your visitors' names, email addresses, and messages. Claude sees this data when a tool returns it
* BubblaV logs every tool call. See **Integrations → MCP Settings → Audit Logs**
* See the [Privacy Policy](https://www.bubblav.com/privacy)

## Rate Limits

MCP calls are metered separately from your chatbot messages, on a rolling 30-day window:

| Plan | MCP calls / month |
| - | - |
| Free | 100 |
| Pro | 5,000 |
| Custom | Unlimited |

When you exceed the limit, requests return a `429` with a `Retry-After` header. Check your usage under **Integrations → MCP Settings** in the dashboard.

## Disconnect or Switch Website

Revoke the **Claude** API key in your BubblaV dashboard. Then connect BubblaV again in Claude and pick the website you want during sign-in.

## Troubleshooting

<AccordionGroup>
  <Accordion title="BubblaV shows 'Needs authentication'">
    * In claude.ai, open **Customize → Connectors**, select BubblaV, and select **Connect**.
    * In Claude Code, run `/mcp`, select **bubblav**, and sign in.
  </Accordion>

  <Accordion title="Authorized the wrong website">
    * Revoke the Claude API key in BubblaV and connect again. Pick the correct website during sign-in.
  </Accordion>

  <Accordion title="Rate limit exceeded">
    * Check usage under **Integrations → MCP Settings**, wait for the 30-day window to reset, or upgrade your plan.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={3}>
  <Card title="MCP Server" icon="server" href="/developer-guide/mcp-server">
    Full tool reference and other MCP clients
  </Card>

  <Card title="Cursor" icon="code" href="/user-guide/integrations/cursor">
    Use BubblaV from the Cursor agent
  </Card>

  <Card title="AI Agent Workflows" icon="robot" href="/user-guide/ai-agent-workflows">
    Recipes to find gaps and tune your bot
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.