BuildBetter Docs

Complete User Guide

BuildBetter MCP Server - Complete Guide

Info: This guide covers everything you need to know about the BuildBetter MCP Server, from setup to what you can ask and troubleshooting.

Overview

The BuildBetter MCP Server lets AI assistants like Claude and ChatGPT securely access your BuildBetter data. Once connected, you can ask questions about your calls, customer feedback, contacts, and companies in plain language — the assistant handles everything behind the scenes.

Getting Started

Prerequisites

Success:

  • A BuildBetter account
  • A supported AI client: Claude Desktop, Claude Code, Cursor, or ChatGPT

How Sign-In Works

When you first connect an interactive AI client, it opens a browser window where you sign in with your BuildBetter account. After that, the client uses OAuth and does not need an API key.

SSO-First Sign-In: The MCP login page offers an SSO-first experience. Enter your work email and you'll be routed to the right identity provider automatically when one is configured for your organization. You can still fall back to email/password if needed.

Server-Side Encrypted Config: Your MCP server configuration is stored server-side with encryption (no more browser local storage). Existing sessions were migrated automatically — sign-in is simpler and your config survives across browsers and devices.

Connection URL

You can connect using either:

Both forms route to the same MCP server.

Authentication Options

Choose the authentication method that matches your client:

POST https://mcp.buildbetter.app/mcp
X-BuildBetter-Api-Key: YOUR_ORGANIZATION_API_KEY

Keep the API key in a secret manager. Configure your automation platform or MCP gateway to inject the header at request time. API-key requests use an organization principal, so tools that require an OAuth user are not available.

Setup Instructions

Claude Desktop

1. Open Settings

In Claude Desktop, go to Settings > Connectors and click Add Custom Connector.

2. Add BuildBetter

Enter a name (e.g., "BuildBetter") and paste the following URL:

https://mcp.buildbetter.app/mcp

Then click Add.

3. Sign In

Ask Claude something about your BuildBetter data. On first use, your browser will open to sign in.

Claude Code

1. Add the Server

claude mcp add buildbetter --transport http https://mcp.buildbetter.app/mcp

2. Sign In

On first use, your browser will open to sign in with your BuildBetter account.

Cursor

1. Open MCP Settings

Go to Cursor Settings > MCP and click Add new MCP server.

2. Configure

3. Sign In

On first use, you'll be prompted to sign in with your BuildBetter account.

ChatGPT

1. Add MCP Server

In ChatGPT, navigate to MCP server settings and add:

https://mcp.buildbetter.app/mcp

2. Sign In

You'll be redirected to sign in with your BuildBetter account.

What You Can Ask About

Once connected, just ask questions in plain language. Here's what data is available:

Calls & Meetings

Access your recorded calls, meetings, and conversations — including summaries, participants, and timestamps.

Example questions:

Customer Signals & Feedback

Search through extracted insights from your conversations — issues, feature requests, praise, complaints, and more.

Example questions:

People & Contacts

Look up customers and team members, and see their associated calls and feedback.

Example questions:

Companies & Accounts

Access company information and see all associated people, calls, and signals.

Example questions:

Documents

Search and retrieve AI-generated documents and imported content like Notion pages.

Example questions:

Knowledge Base

Browse and search your internal knowledge base wiki pages.

Example questions:

Advanced GraphQL Queries

Run custom queries against the full BuildBetter data model for advanced use cases.

Example questions:

Tip: For a complete list of all 21 tools with parameters and examples, see the Tool Reference.

Use Cases by Team

Customer Success

Product Management

Engineering

Leadership

More Example Questions

Recent Activity

"Show me the 10 most recent customer calls"

Issue Investigation

"Find all customer issues related to billing in the last 2 weeks"

Customer Deep Dive

"Get all information about interactions with [Customer Name]"

Sentiment Analysis

"Show me all negative feedback from the last 7 days"

Feature Requests

"List all feature requests grouped by product area"

Team Performance

"Which team members have been mentioned positively by customers?"

Security & Privacy

Read-Only Access

Success:

  • The MCP server provides read-only access to your data
  • No one can modify, delete, or create data through this connection

Authentication

Info:

  • Interactive clients use your existing BuildBetter account through OAuth
  • SSO-first: work emails can be automatically routed to your identity provider
  • Unattended automation uses an organization API key in the X-BuildBetter-Api-Key header
  • Access is scoped to your organization's data only
  • Store organization API keys in a secret manager and rotate them when needed
  • Config is stored server-side with encryption — not in browser local storage
  • Sessions can be revoked from your BuildBetter account settings

Network Security

Info:

  • All connections use HTTPS encryption
  • No data is stored or cached by the MCP server

Best Practices

1. Review connected apps

Periodically check which AI clients have access in your account settings

2. Revoke unused sessions

Remove access for AI clients you no longer use

3. Report issues

Contact support if you suspect unauthorized access

Limitations

Data Access

Query Limits

What's Not Supported

Troubleshooting

Connection Issues

Connection refused or timeout errors

  1. Check that you have internet connectivity
  2. Verify the URL is https://mcp.buildbetter.app/mcp
  3. Try restarting your AI client

Authentication errors

  1. Ensure you're signing in with the correct BuildBetter account
  2. Try signing out and back in to refresh your session
  3. Check that your BuildBetter account is active

Client Issues

MCP server not appearing in Claude Desktop

  1. Open Settings > Connectors and verify the BuildBetter connector is listed
  2. Try removing and re-adding the connector
  3. Restart Claude Desktop completely

Sign-in popup not appearing

  1. Check that your browser is not blocking popups
  2. Ensure your default browser is set correctly
  3. Try manually navigating to the sign-in URL if shown in logs

Data Issues

No data returned

  1. Verify you have data in your BuildBetter account
  2. Try broadening your question (e.g., remove date filters)

Unexpected results

  1. Try rephrasing your question to be more specific
  2. Ask the assistant to clarify what data it found

Support

Note: Last updated May 2026