Skip to main content
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.
Install the BubblaV app from the ChatGPT apps page, 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.

​
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

1

Open the app

Click Add to ChatGPT on the ChatGPT apps page; or in ChatGPT go to Settings → Connectors → Add connector and enter https://www.bubblav.com/mcp.
2

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

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

Try it

Ask ChatGPT something like “Search my knowledge base for our return policy” or “Give me this month’s chatbot report.”
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. To add other MCP servers inside BubblaV, see MCP Servers.

​
What You Can Ask

ChatGPT receives BubblaV’s tools automatically and picks the right one for your request. A representative subset:
ToolWhat it doesExample prompt
bubblav_search_knowledgeSearch your knowledge base”What does our returns policy say?”
bubblav_add_knowledgeAdd a knowledge entry”Add a FAQ about holiday shipping deadlines”
bubblav_list_knowledge_sourcesList everything your bot is trained on”What sources is my bot trained on?”
bubblav_upload_knowledge_fileUpload a PDF/DOCX/TXT/MD file (≤10 MB) to index”Index this product spec PDF”
bubblav_sync_ticket_to_knowledgeTurn a resolved ticket into an article (Pro+)“Save last week’s refund ticket as a knowledge article”
bubblav_add_crawl_urlAdd a URL to crawl and index”Index our new pricing page”
bubblav_get_crawl_statusCheck indexing progress”How many pages are indexed so far?”
bubblav_list_conversationsList/filter conversations by channel or status”Show me Instagram conversations this week”
bubblav_search_conversationsFull-text search across chats”Find chats mentioning ‘billing error‘“
bubblav_list_leadsList visitors who shared their email”Show me leads from the last 7 days”
bubblav_get_content_gapsQuestions your bot couldn’t answer well”What should I add to my knowledge base?”
bubblav_get_most_asked_questionsTrending visitor questions”What are people asking most this month?”
bubblav_read_reportFull analytics report for a date range”Give me June’s chatbot performance report”
bubblav_get_hourly_activityHourly activity breakdown”When are my busiest support hours?”
bubblav_update_website_settingsUpdate the chatbot persona / settings”Make the bot more friendly and concise”
bubblav_update_widget_appearanceUpdate bot name, greetings, colors, position”Rename the bot to ‘Sunny’ and use a teal bubble”
bubblav_create_custom_toolCreate a webhook custom tool (Pro+)“Add a tool that checks order status from our API”
bubblav_create_handoff_scenarioRoute a topic to a live agent (Pro+)“Hand off to a human when someone mentions large refunds”
This is a representative subset. ChatGPT always receives the full, current tool list via the MCP tools/list method.

​
Rate Limits

MCP calls are metered separately from your chatbot messages, on a rolling 30-day window:
PlanMCP calls / month
Free100
Pro5,000
CustomUnlimited
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

  • Make sure your ChatGPT plan supports MCP apps/connectors.
  • Try removing the connector and re-adding https://www.bubblav.com/mcp.
  • Revoke the ChatGPT API key in BubblaV and reconnect, picking the correct website during OAuth.
  • Check usage under Integrations → MCP Settings, wait for the 30-day window to reset, or upgrade your plan.
  • 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.

​
Next Steps

MCP Server

Full tool reference and other MCP clients

Custom Tools

Webhook tools you can create from ChatGPT

AI Agent Workflows

Recipes to diagnose gaps and tune your bot