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

# ChatGPT

> Connect BubblaV to ChatGPT via MCP to search your knowledge base, view analytics, and manage your chatbot

Connect BubblaV to ChatGPT through the BubblaV MCP Server. Ask ChatGPT to search your knowledge base, pull analytics, find content gaps, and tune your chatbot — no API key required.

<Note title="What's live">
  Install the BubblaV app from the [ChatGPT apps page](https://chatgpt.com/apps/bubblav-ai-chatbot/asdk_app_69c3e9a175b481919947b413dee0979f), or add `https://www.bubblav.com/mcp` as an MCP connector in ChatGPT. OAuth runs automatically — sign in to BubblaV and pick a website. ChatGPT is granted the `mcp:read` and `mcp:tools:execute` scopes.
</Note>

## Why Connect ChatGPT?

* **Ask your knowledge base in chat**: Search and manage content without opening the dashboard
* **Analytics on demand**: Full reports for any date range, summarized in plain language
* **Close content gaps**: See what your bot couldn't answer and add the missing answers
* **Tune the persona**: Change the chatbot's voice, greetings, and widget appearance from ChatGPT
* **Inspect conversations & leads**: Filter and full-text search across chats
* **No API key**: OAuth handles everything

## Prerequisites

* A BubblaV account with at least one website set up and some content indexed
* A ChatGPT plan that supports MCP apps/connectors

## Install the BubblaV ChatGPT App

<Steps>
  <Step title="Open the app">
    Click **Add to ChatGPT** on the [ChatGPT apps page](https://chatgpt.com/apps/bubblav-ai-chatbot/asdk_app_69c3e9a175b481919947b413dee0979f); *or* in ChatGPT go to **Settings → Connectors → Add connector** and enter `https://www.bubblav.com/mcp`.
  </Step>

  <Step title="Authorize BubblaV">
    ChatGPT starts OAuth automatically. Sign in to BubblaV, select the website to connect, and approve the requested scopes. No API key is needed.
  </Step>

  <Step title="Confirm the connection">
    The BubblaV connector shows as connected in ChatGPT. An API key labeled **ChatGPT** is created in your BubblaV account to power the connection.
  </Step>

  <Step title="Try it">
    Ask ChatGPT something like *"Search my knowledge base for our return policy"* or *"Give me this month's chatbot report."*
  </Step>
</Steps>

<Info>
  ChatGPT is one of several MCP clients. For API-key setup, other clients (Claude Desktop, Google Antigravity), and the full tool reference, see the [MCP Server developer guide](/developer-guide/mcp-server). To add other MCP servers inside BubblaV, see [MCP Servers](/user-guide/integrations/mcp-servers).
</Info>

## What You Can Ask

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

| Tool                               | What it does                                    | Example prompt                                            |
| ---------------------------------- | ----------------------------------------------- | --------------------------------------------------------- |
| `bubblav_search_knowledge`         | Search your knowledge base                      | "What does our returns policy say?"                       |
| `bubblav_add_knowledge`            | Add a knowledge entry                           | "Add a FAQ about holiday shipping deadlines"              |
| `bubblav_list_knowledge_sources`   | List everything your bot is trained on          | "What sources is my bot trained on?"                      |
| `bubblav_upload_knowledge_file`    | Upload a PDF/DOCX/TXT/MD file (≤10 MB) to index | "Index this product spec PDF"                             |
| `bubblav_sync_ticket_to_knowledge` | Turn a resolved ticket into an article (Pro+)   | "Save last week's refund ticket as a knowledge article"   |
| `bubblav_add_crawl_url`            | Add a URL to crawl and index                    | "Index our new pricing page"                              |
| `bubblav_get_crawl_status`         | Check indexing progress                         | "How many pages are indexed so far?"                      |
| `bubblav_list_conversations`       | List/filter conversations by channel or status  | "Show me Instagram conversations this week"               |
| `bubblav_search_conversations`     | Full-text search across chats                   | "Find chats mentioning 'billing error'"                   |
| `bubblav_list_leads`               | List visitors who shared their email            | "Show me leads from the last 7 days"                      |
| `bubblav_get_content_gaps`         | Questions your bot couldn't answer well         | "What should I add to my knowledge base?"                 |
| `bubblav_get_most_asked_questions` | Trending visitor questions                      | "What are people asking most this month?"                 |
| `bubblav_read_report`              | Full analytics report for a date range          | "Give me June's chatbot performance report"               |
| `bubblav_get_hourly_activity`      | Hourly activity breakdown                       | "When are my busiest support hours?"                      |
| `bubblav_update_website_settings`  | Update the chatbot persona / settings           | "Make the bot more friendly and concise"                  |
| `bubblav_update_widget_appearance` | Update bot name, greetings, colors, position    | "Rename the bot to 'Sunny' and use a teal bubble"         |
| `bubblav_create_custom_tool`       | Create a webhook custom tool (Pro+)             | "Add a tool that checks order status from our API"        |
| `bubblav_create_handoff_scenario`  | Route a topic to a live agent (Pro+)            | "Hand off to a human when someone mentions large refunds" |

<Note>
  This is a representative subset. ChatGPT always receives the full, current tool list via the MCP `tools/list` method.
</Note>

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

## Reconnecting

To disconnect or switch the website ChatGPT is linked to, revoke the **ChatGPT** API key from your BubblaV dashboard, then add the connector again in ChatGPT and pick the website you want during OAuth.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connector not appearing in ChatGPT">
    * Make sure your ChatGPT plan supports MCP apps/connectors.
    * Try removing the connector and re-adding `https://www.bubblav.com/mcp`.
  </Accordion>

  <Accordion title="Authorized the wrong website">
    * Revoke the ChatGPT API key in BubblaV and reconnect, picking the correct website during OAuth.
  </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>

  <Accordion title="I asked ChatGPT to scrape a URL and it couldn't">
    * The ChatGPT app intentionally does not expose arbitrary URL scraping. To add new content, use `bubblav_add_crawl_url`, `bubblav_upload_knowledge_file`, or `bubblav_add_knowledge` instead.
  </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="Custom Tools" icon="wrench" href="/user-guide/integrations/custom-tools">
    Webhook tools you can create from ChatGPT
  </Card>

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