Complete User Guide
Everything you need to know about using BuildBetter MCP Server
BuildBetter MCP Server - Complete Guide
This comprehensive guide covers everything you need to know about the BuildBetter MCP Server, from setup to advanced usage.
Overview
The BuildBetter MCP (Model Context Protocol) server provides secure, read-only access to BuildBetter’s GraphQL API, enabling AI assistants like Claude to query and analyze your customer conversation data, insights, and signals.
Read-Only Access
No data modifications possible
Remote Server
No local installation required
API Authentication
Secure API key protection
Real-time Data
Access current information
Getting Started
Prerequisites
- Node.js v18 or higher installed on your system
- A BuildBetter API key (see Getting Your API Key)
- Claude Desktop or another MCP-compatible client
Check Your Node.js Version
If you see a version lower than v18, please update Node.js before continuing.
Setup Instructions
For Claude Desktop
Locate Configuration File
Find your Claude Desktop configuration file based on your operating system:
Add BuildBetter Configuration
Add the BuildBetter MCP server to your configuration:
Replace YOUR_API_KEY_HERE with your actual API key.
Restart Claude Desktop
Completely quit and restart Claude Desktop for changes to take effect.
Verify Connection
Test the connection by asking Claude:
“Can you list the available BuildBetter tools?”
For Other MCP Clients
Test the connection using the official MCP Inspector:
Then connect to: https://mcp.buildbetter.ai?apikey=YOUR_API_KEY
Test the connection using the official MCP Inspector:
Then connect to: https://mcp.buildbetter.ai?apikey=YOUR_API_KEY
For developers building custom integrations:
Getting Your API Key
Email Support Team
Send an email to support@buildbetter.ai
Include Required Information
- Your company name
- Your BuildBetter account email
- Intended use case (e.g., “Claude Desktop integration”)
Receive Your Key
You’ll receive your API key within 1-2 business days
API keys are tied to your BuildBetter organization and provide access to your organization’s data only.
What You Can Do
The BuildBetter MCP server enables AI assistants to:
Use Cases
🎯 Customer Success Teams
Weekly Customer Health Reports
“Show me all critical issues mentioned by Enterprise customers in the last 7 days”
Account Reviews
“Find all conversations with Acme Corp and summarize their main pain points”
Churn Risk Analysis
“Identify customers who’ve expressed frustration in recent calls”
💼 Product Management
Feature Request Tracking
“List all feature requests mentioned in the last month, grouped by theme”
User Feedback Analysis
“Find all feedback about our onboarding process”
Competitive Intelligence
“Show mentions of competitors in customer calls”
🛠️ Engineering Teams
Bug Report Aggregation
“Find all technical issues mentioned by customers this week”
Integration Feedback
“Search for problems users are having with our API”
Performance Complaints
“List all mentions of slow performance or timeouts”
📊 Executive Leadership
Strategic Insights
“Summarize the top 5 themes from customer conversations this quarter”
Market Trends
“What new use cases are customers asking about?”
Customer Sentiment
“How has overall customer sentiment changed over the last 30 days?”
Common Queries
“Show me the 10 most recent customer calls”
“Show me the 10 most recent customer calls”
“Find all customer issues related to billing in the last 2 weeks”
“Get all information about interactions with [Customer Name]”
“Show me all negative feedback from the last 7 days”
“List all feature requests grouped by product area”
“Which team members have been mentioned positively by customers?”
Available Tools
The MCP server provides these tools to Claude:
run-query
Execute custom GraphQL queries
list-types
Explore available data types
build-query
Generate queries for specific data types
search-extractions
Search customer signals and feedback
find-fields
Discover fields available for each data type
Security & Privacy
🔒 Read-Only Access
- The MCP server provides read-only access to your data
- No mutations or data modifications are possible
- All write operations are blocked at the server level
🔑 API Key Security
- Each API key is tied to a specific BuildBetter organization
- Keys only provide access to your organization’s data
- Store your API key securely - treat it like a password
- Never commit API keys to version control
🌐 Network Security
- All connections use HTTPS encryption
- Server hosted on Cloudflare’s secure infrastructure
- No data is stored or cached by the MCP server
⚠️ Best Practices
Rotate keys periodically
Contact support for new keys
Limit key distribution
Only share with authorized team members
Monitor usage
Review Claude’s queries regularly
Report issues
Contact support if you suspect unauthorized access
Limitations
- Read-only - Cannot create, update, or delete data
- Organization-scoped - Access limited to your organization’s data
- No bulk exports - Designed for targeted queries, not data dumps
- Read-only - Cannot create, update, or delete data
- Organization-scoped - Access limited to your organization’s data
- No bulk exports - Designed for targeted queries, not data dumps
- GraphQL depth limits - Deeply nested queries may be restricted
- Result size limits - Very large result sets may be truncated
- Rate limiting - Excessive requests may be throttled
- No real-time subscriptions - Polling required for updates
- No file access - Cannot retrieve call recordings or attachments
- No webhook support - Cannot set up automated notifications
Troubleshooting
Connection Issues
Claude Desktop Issues
Data Access Issues
Support
Getting Help
API Keys & Account
Email support@buildbetter.ai
- Include organization name
- Include account email
Technical Issues
Check Troubleshooting first
- Include error messages
- Specify Node.js version and OS
Resources
Last updated: January 2025
BuildBetter MCP Server v0.0.1