Set up with your coding agent
Let Claude Code, Cursor or another coding agent teach your FutureBase agent about your product, style the chat bubble and add it to your site
If you build your product with a coding agent like Claude Code, Cursor or Codex, it can set up your FutureBase agent for you. It already knows your codebase: your docs, pricing page, plan limits, error messages and brand colours. Connect it to FutureBase and it can:
- teach your agent what your customers need to know, from your repository and your public website
- style the chat bubble to match your product: colour, welcome message, suggested questions
- add the chat bubble to your code with the right snippet for your framework
- test the agent with questions a real customer would ask, and fill the gaps it finds
All you do is sign in to FutureBase once and review the code change it proposes.
How it works
Your coding agent connects to the FutureBase setup MCP server at https://api.futurebase.io/v1/mcp/setup. MCP is the standard way coding agents talk to other tools. The server uses OAuth: when your coding agent connects, your browser opens and you sign in to FutureBase. Your coding agent never sees a password or API key, and it can only reach the agents in your own organizations.
Everything it does goes through the same checks as the dashboard, including your plan's limits, and shows up live on your agent's Channels page.
Set it up
Copy the command
Open Channels in your FutureBase dashboard. Under Let your coding agent set it up, pick your coding agent and copy the command or the prompt. The prompt is already filled in with your agent's name and ID.
Run it in your project
For Claude Code, run the copied command in your project's folder. It adds the FutureBase server and starts Claude Code with the setup prompt:
claude mcp add --transport http futurebase https://api.futurebase.io/v1/mcp/setup; claude "$(curl -fsSL https://api.futurebase.io/v1/setup/YOUR_AGENT_ID/prompt)"For Cursor, add the server to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project), then paste the prompt into the Agent chat:
{
"mcpServers": {
"futurebase": {
"url": "https://api.futurebase.io/v1/mcp/setup"
}
}
}For any other coding agent (Codex, VS Code, Windsurf and others), add https://api.futurebase.io/v1/mcp/setup as a remote MCP server using the Streamable HTTP transport, then paste the prompt.
Sign in
When your coding agent first uses the FutureBase tools, it asks you to sign in. In Claude Code, run /mcp, choose futurebase and then Authenticate. Your browser opens the FutureBase sign-in and consent page.
Review and deploy
Your coding agent shows you the change that adds the chat bubble before it commits anything. Review it, then deploy as usual. The Channels page switches to Live as soon as the bubble loads on your website.
The chat bubble doesn't chat on localhost in production; it shows Embed works instead. Your
coding agent can still confirm the install from a local build, and the bubble starts answering
once it loads on your real website.
What it adds to your agent
The prompt asks your coding agent to look for facts customers ask about: docs, README, pricing and plan limits, FAQ and help pages, legal pages such as refunds and terms, error messages users see, and the changelog. It adds:
- your public website, which FutureBase imports and keeps fresh
- documents for what isn't on the website, one per topic, written for customers
- FAQs for short question and answer pairs
It is told never to add secrets, credentials, customer data, internal notes or source code. Everything it adds appears on your Knowledge page, where you can review, edit or delete it.
Tools
The setup server gives your coding agent these tools:
| Tool | What it does |
|---|---|
list_agents | Lists the agents in your organizations |
get_setup_guide | Shows what is already set up and the steps to finish |
get_agent | Reads the agent's brand, tone, custom instructions and bubble settings |
update_agent | Sets the brand name, logo, website, tone, custom instructions and fallback |
add_website | Imports your website, or one page |
add_documents | Adds Markdown documents (up to 20 at a time) |
add_faqs | Adds questions and answers (up to 50 at a time) |
list_knowledge | Lists what the agent knows, to avoid duplicates |
remove_knowledge | Deletes items by ID, only with explicit confirmation |
update_bubble | Sets the bubble's colours, position, welcome message and suggested questions |
get_install_snippet | Returns the install code for Next.js, React, Astro, Vue, SvelteKit, HTML or a site builder |
check_install | Reports whether the bubble has loaded on your site |
set_allowed_domains | Sets the website and staging domain the bubble answers on |
ask_agent | Asks the agent a test question and shows the sources it used |
get_dashboard_links | Links to dashboard steps that need a browser, like connecting Slack |
Connecting messaging apps such as Slack or WhatsApp needs a browser, so your coding agent gives you the link instead.
Limits
The setup server allows 120 calls per minute per user. Test questions from ask_agent count toward your plan's AI usage like any other answer.