Guides

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:

.cursor/mcp.json
{
  "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:

ToolWhat it does
list_agentsLists the agents in your organizations
get_setup_guideShows what is already set up and the steps to finish
get_agentReads the agent's brand, tone, custom instructions and bubble settings
update_agentSets the brand name, logo, website, tone, custom instructions and fallback
add_websiteImports your website, or one page
add_documentsAdds Markdown documents (up to 20 at a time)
add_faqsAdds questions and answers (up to 50 at a time)
list_knowledgeLists what the agent knows, to avoid duplicates
remove_knowledgeDeletes items by ID, only with explicit confirmation
update_bubbleSets the bubble's colours, position, welcome message and suggested questions
get_install_snippetReturns the install code for Next.js, React, Astro, Vue, SvelteKit, HTML or a site builder
check_installReports whether the bubble has loaded on your site
set_allowed_domainsSets the website and staging domain the bubble answers on
ask_agentAsks the agent a test question and shows the sources it used
get_dashboard_linksLinks 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.

On this page