Connect Hyperleap to Claude Desktop in 5 Minutes (MCP Setup)
Step-by-step guide to connecting Hyperleap AI to Claude Desktop using MCP. Query your chatbot leads, conversations, and pipeline in plain English.
TL;DR: Create an MCP key in Hyperleap Studio, add Hyperleap as a custom connector in Claude Desktop with the URL https://api.hyperleapai.com/mcp, and paste the key when the connect page asks for it. There is nothing to install and no config file to edit. In under five minutes you can ask Claude questions like "What happened with my hottest lead this week?" and get an answer pulled live from your Hyperleap chatbot data — no dashboards, no exports, no SQL.
Connect Hyperleap to Claude Desktop Using MCP: Step-by-Step Tutorial
Your Hyperleap AI chatbots are having hundreds of conversations with leads every week. The data is all there — conversations, activities, pipeline stages, notes — but getting a clear answer out of it usually means logging into the dashboard, filtering by date, clicking through individual contacts, and mentally stitching together a picture.
The Model Context Protocol (MCP) changes that. MCP is an open standard that lets AI assistants like Claude connect directly to external data sources through a standardized interface. Hyperleap hosts its own MCP server, so Claude can query your chatbot data in real time, in plain English, without you touching a single filter.
This tutorial walks you through the Hyperleap Claude Desktop MCP setup from start to finish. If you follow each step in order, you will be querying your lead pipeline from Claude Desktop in about five minutes.
What You Will Have at the End
A working Claude Desktop MCP integration that connects to your Hyperleap account. Ask Claude natural-language questions about your leads, conversations, pipeline, and chatbot activity — and get answers drawn directly from your live data.
What You Will Build
By the end of this guide, Claude Desktop will have access to nine read-only tools connected to your Hyperleap account. You will be able to type questions like:
- "What happened with my hottest lead this week?"
- "Show me the leads that came in through our support chatbot."
- "Which pipeline stage has the most leads stuck right now?"
Claude will call the appropriate Hyperleap tools, pull the data, and give you a synthesized answer — in the same conversation window where you already work.
This is not a report export. It is a live, conversational interface to your CRM data. The integration is read-only, so Claude can query and summarize your data but cannot modify, delete, or write anything back to Hyperleap.
Prerequisites
Before you start, confirm you have the following:
- A paid Hyperleap plan. The MCP server is included on Plus, Pro, and Max. Learn more about Hyperleap's MCP integration.
- Claude Desktop. Download the latest version from claude.ai/download. The same connector also works in Claude on the web (claude.ai) and in Claude Code, and the steps are much the same there.
- Some leads in your Hyperleap CRM. The tools read leads your chatbots have captured. An empty CRM returns empty answers.
That's the whole list. Hyperleap hosts the MCP server, so there's no package to install, no Node.js, and no JSON config file to edit.
Step-by-Step Setup
Step 1: Create an MCP Key in Hyperleap Studio
An MCP key is how Claude proves it's acting for you. It's a personal key: it acts as you, so Claude sees the same leads you can see in Studio.
- In Hyperleap Studio, click your profile avatar in the top-right corner and choose My MCP Keys.
- Click Create MCP Key.
- Give the key a name you'll recognize later, like
Claude Desktop, and click Create. - Copy the key. Studio shows it only once, so store it somewhere safe before you close the dialog.
You should now have an MCP key copied to your clipboard. If you lose it, create a new one; there's no way to view it again.
Keep Your MCP Key Private
Anyone holding the key can connect an AI assistant to your Hyperleap CRM and read the same leads and conversations you can. Don't paste it into shared documents, chats, or a git repository.
Step 2: Add Hyperleap as a Custom Connector in Claude Desktop
- In Claude Desktop, open the sidebar menu and choose Customize.
- Select Connectors.
- Click the + button and choose Add custom connector.
- Fill in the two fields:
- Name:
hyperleap-mcp - URL:
https://api.hyperleapai.com/mcp
- Name:
- Click Add.
The URL must be exactly https://api.hyperleapai.com/mcp. Other addresses, including api.hyperleap.ai, won't work.
You should now see hyperleap-mcp in your list of connectors, marked as not connected yet.
Step 3: Connect With Your MCP Key
- Click Connect on the
hyperleap-mcpconnector. - Your browser opens the Connect to Hyperleap AI page. Paste the MCP key from Step 1 and click Connect.
- You're returned to Claude, and the connector now shows as connected.
You never paste the key into Claude itself. Hyperleap checks it on its own page and hands Claude a short-lived access token, which Claude renews in the background.
Step 4: Check the Hyperleap Tools
Once the connector is connected, Claude has nine read-only Hyperleap tools available:
list_leadsget_lead_detailsget_lead_conversationsget_conversationget_lead_activitiesget_lead_notesget_pipeline_stagesget_crm_dashboardextract_lead_insights
If the connector doesn't show as connected, jump to the Troubleshooting section below.
For a full description of what each tool does and what parameters it accepts, see the Hyperleap MCP tools reference.
Step 5: Run Your First Query
Start a new conversation and type a plain-English question. A good first query to confirm the connection is live:
Show me a summary of my current CRM dashboard — how many leads do I have and what's the pipeline breakdown?
Claude will call the get_crm_dashboard tool, retrieve the data from your Hyperleap account, and return a summary in the chat. The first time it uses a Hyperleap tool, Claude may ask you to allow it.
You should now see a response that reflects your actual Hyperleap data — lead counts, pipeline stages, and recent activity. The setup is complete.
First 5 Prompts to Try
Now that the connection is live, here are five prompts that demonstrate what the integration can do. Each one uses one or more of the nine Hyperleap tools under the hood. The sample responses are illustrative, written to show the shape of an answer; your numbers and names will come from your own data.
Prompt 1: Get your CRM dashboard overview
Give me a quick overview of my Hyperleap CRM — total leads, how many came in
this week, and which pipeline stage has the most contacts.
Sample response (illustrative): Claude calls
get_crm_dashboardand returns a structured summary. "You have 142 leads in total, 18 of them new this week. The largest group is in the 'Qualified' stage with 34 leads, followed by 'New' with 28."
Prompt 2: Surface your hottest recent lead
Who is my most recently active lead and what have they been talking about?
Sample response (illustrative): Claude calls
list_leadsto find recent activity, thenget_lead_conversationsandget_conversationto read the latest chat. "Your most recently active lead is Sarah Chen from Meridian Retail. She chatted with your website chatbot three hours ago about Pro plan features and pricing, and hasn't answered the follow-up question about team size yet."
Prompt 3: Review a specific lead's full history
Pull up everything you know about the lead named James Okafor —
their conversations, activities, and any notes my team has added.
Sample response (illustrative): Claude calls
list_leadsto find him, thenget_lead_details,get_lead_activities, andget_lead_notes, plus the conversation tools. "James Okafor came in through the WhatsApp chatbot on April 28 and asked about connecting Facebook Messenger. Your team added a note on April 30: 'Sent pricing deck, following up Friday.' No response since."
Prompt 4: Identify leads that need follow-up
Which leads have been active in the last 7 days but are still in the "New"
stage? I want to know who might need a follow-up.
Sample response (illustrative): Claude calls
get_pipeline_stagesto find the "New" stage, thenlist_leadsfor that stage, and checks each lead's last-activity time. "Three leads were active this week but are still in 'New': David Park (4 days ago), Lena Fischer (2 days ago), and Omar Al-Rashid (6 days ago). None have notes from your team."
Prompt 5: Find the unanswered question in a conversation
Look at the most recent conversation with jane@example.com and tell me what
her main concern was and which questions went unanswered.
Sample response (illustrative): Claude looks up the lead, lists her conversations, reads the latest one with
get_conversation, and can runextract_lead_insightsfor topics and intent. "Her main concern was response time: she asked twice whether a person could take over the chat. Her question about your refund policy wasn't answered before the conversation ended. A good follow-up: explain how handoff to your team works and share the refund terms."
Troubleshooting
The connector won't connect
Most likely cause: A typo in the connector URL.
Open the connector's settings and check that the URL is exactly https://api.hyperleapai.com/mcp, with no trailing characters. Other hostnames, including api.hyperleap.ai, will not work. Remove the connector and add it again if needed.
"Invalid MCP key" on the Connect to Hyperleap AI page
Cause: The key is mistyped, was deleted, or isn't a personal MCP key.
Copy the key again, with no extra spaces. If you're not sure you have the right one, open My MCP Keys from your profile menu in Studio, create a new key, and use that. Keys from anywhere else in Studio won't work here: the connector accepts only personal MCP keys.
The connection stops working later
Cause: Hyperleap rejects connections when the account's subscription is no longer active, or when your user has been removed from the account.
Confirm your plan is active and that you can still sign in to Studio. Then disconnect the connector in Claude and connect again with a current MCP key.
"No leads returned" when querying leads
Cause: Your account may have no leads yet, or you don't have access to the chatbots that captured them.
Try a broader query first: "List all leads in my Hyperleap account." If that also returns nothing, sign in to Studio and check that there are leads you can see there. Lead lookups return the same leads you can see in Studio, so a teammate with access to more workspaces may get more results. If leads appear in Studio but not in Claude, contact Hyperleap support with your key's name and the exact error text from Claude.
Claude answers without using the Hyperleap tools
Cause: The question was too general, or the connector is turned off for this conversation.
Check that the Hyperleap connector is enabled for the chat, then be explicit: "Use the Hyperleap CRM MCP to show me my dashboard."
What to Read Next
- Hyperleap MCP Tools Reference — A full breakdown of all nine tools, with example queries for each one.
- Connect Hyperleap to Cursor via MCP — The same integration, configured for Cursor IDE — useful if you want to query your Hyperleap data alongside your codebase.
- Run Your Sales Standup with Claude Desktop and MCP — A practical workflow for using Claude + Hyperleap MCP to run a five-minute weekly pipeline review without touching the dashboard.
- Hyperleap MCP Integration Overview — The product page for Hyperleap's MCP server, including supported plans and the full tool list.
- Hyperleap MCP Setup Docs — The official setup guide, with screenshots of every step.
Frequently Asked Questions
Does this work on Windows as well as macOS?
Yes. Nothing is installed on your computer: the connector points Claude at Hyperleap's hosted server, so the steps are the same on both. The nine Hyperleap tools behave the same way on both operating systems.
Do I need Node.js or a config file?
No. Older guides had you install Node.js and edit claude_desktop_config.json. Hyperleap now hosts the MCP server, so you add it as a custom connector and sign in with your MCP key. If you followed an older guide, remove the old hyperleap entry from your config file and set up the connector instead.
Is my data sent to Anthropic when I use the MCP integration?
When you ask Claude a question and it calls a Hyperleap MCP tool, the data returned by the tool (your lead details, conversations, etc.) is included in the context that Claude processes to generate its response. Anthropic's standard Claude data handling policies apply. For sensitive commercial data, review Anthropic's privacy policy and your organization's data sharing policies before using the integration with production data.
Can Claude modify or delete my Hyperleap data through MCP?
No. All nine Hyperleap MCP tools are read-only. Claude can query, retrieve, and summarize your data, but it has no ability to create, update, or delete leads, conversations, notes, or pipeline stages through this integration. The only thing any tool saves is the output of extract_lead_insights: the insights it finds are added to the lead's profile.
Which Hyperleap plans include MCP access?
The MCP server is included on every paid Hyperleap plan: Plus ($40/mo), Pro ($100/mo), and Max ($200/mo). See the MCP integration page for details.
How do I get my Hyperleap MCP key?
Sign in to Hyperleap Studio, click your profile avatar in the top-right corner, choose My MCP Keys, and click Create MCP Key. Copy the key right away — Hyperleap shows it only once. You'll paste it on the Connect to Hyperleap AI page when Claude connects.
Can I connect more than one Hyperleap account to Claude?
Yes. A key acts as you inside one Hyperleap account. If you work in more than one account, create a key in each and add a separate custom connector for each one, with a different name (for example hyperleap-agency and hyperleap-client).
What data sources do the Hyperleap MCP tools query?
The nine tools query data captured by your Hyperleap AI chatbots — leads who have interacted with your chatbot on Website, WhatsApp, Instagram DM, or Facebook Messenger. They do not connect to external CRMs, email, or ad platforms. The data is whatever your chatbot has collected and stored in Hyperleap's CRM layer.
What should I do if I see a "rate limit exceeded" error?
Hyperleap's API limits how many requests it accepts in a short window, to protect service stability. If you hit the limit, wait a minute before running your next query. If you're asking about many leads at once, ask a narrower question ("the five newest leads") so Claude calls fewer tools per turn.
Ready to Set Up MCP?
Head to the Hyperleap MCP setup docs for screenshots of every step, or visit the MCP integration overview to learn what's available on your plan.
Related Articles
Coach Sales Reps with AI Chatbot Transcripts (via MCP)
Use Claude Desktop to find chatbot conversations matching any coaching theme — objections, discovery, closing — and turn transcript review into a weekly ritual.
Run Sales Standups in Claude Desktop with Hyperleap MCP
Replace your Monday pipeline review with a 15-minute Claude Desktop session. 10 natural-language prompts that pull live data from your Hyperleap chatbot.
What is MCP (Model Context Protocol)? SMB Guide
MCP lets AI tools like Claude and Cursor query your business data directly. Here is what Model Context Protocol means, why it matters, and how to use it.
Qualify Leads in Claude Desktop with Hyperleap MCP
Stop scoring leads on gut feel. Connect Claude Desktop to Hyperleap via MCP and rank chatbot leads on what they actually said: prompts plus a scoring rubric.