MCP: Hoe je de Leadconnector MCP-server instelt en gebruikt
Koppel je AI-assistent aan Voluit Suite, zodat die CRM-gegevens kan vinden en ondersteunde acties kan uitvoeren op basis van jouw opdrachten. De LeadConnector MCP-server werkt via OAuth: je logt in, kiest het account dat je wilt koppelen en geeft toestemming voor de gevraagde toegang.
In dit artikel lees je hoe je Claude, ChatGPT, Codex, Cursor, Muse en Grok Bot koppelt en hoe je ontdekt welke acties beschikbaar zijn.
Wat is de LeadConnector MCP-server?
MCP staat voor Model Context Protocol. Het geeft AI-assistenten een standaardmanier om tools van gekoppelde apps te vinden en te gebruiken. Via de LeadConnector MCP-server kan je assistent met ondersteunde CRM-gegevens en acties werken, zonder dat je de achterliggende API hoeft te kennen.
De actieve catalogus bevat meer dan 550 acties voor lezen, aanmaken, wijzigen en verwijderen, verdeeld over 38 gebieden. Welke acties je verbinding kan gebruiken, hangt af van de OAuth-toegangsrechten en toestemmingen die je goedkeurt.
Voordat je begint
Je hebt toegang nodig tot het Voluit Suite-account dat je wilt koppelen en een ondersteunde AI-app. Gebruik voor een aangepaste MCP-koppeling de URL voor jouw app hieronder. Muse en Grok Bot bieden een officieel vermelde app aan.
| AI-app | Verbindingsmethode |
|---|---|
| Claude.ai, Claude Code en Claude Cowork | https://services.leadconnectorhq.com/mcp/anthropic/v2 |
| ChatGPT, Codex en andere compatibele OpenAI-apps | https://services.leadconnectorhq.com/mcp/openai/v2/ |
| Cursor | https://services.leadconnectorhq.com/mcp/cursor/v2 |
| Muse | Koppel de officiële app in Muse. Het OAuth-eindpunt is https://services.leadconnectorhq.com/mcp/muse/v2/. |
| Grok Bot | Voeg de app HighLevel toe via Connect apps (Apps koppelen). |
Deze verbindingen gebruiken OAuth. Tijdens het koppelen log je in bij LeadConnector, selecteer je het beschikbare account en keur je de gevraagde toegangsrechten goed. Alle verbindingsopties gebruiken de actieve catalogus met LeadConnector MCP-acties.
Je AI-app koppelen
Claude.ai
- Open Claude.ai en ga naar Settings → Connectors → Add custom connector (Instellingen → Koppelingen → Aangepaste koppeling toevoegen).
- Vul deze server-URL in: https://services.leadconnectorhq.com/mcp/anthropic/v2.
- Klik op Connect (Koppelen) en doorloop het aanmeld- en toestemmingsproces van LeadConnector.
- Kies het account dat je wilt koppelen en geef toestemming voor toegang.
- Start een nieuwe chat om de LeadConnector-tools te gebruiken.
Claude Code
Voer dit commando uit in je terminal:
claude mcp add --transport http leadconnector https://services.leadconnectorhq.com/mcp/anthropic/v2
Je kunt ook deze configuratie toevoegen aan .mcp.json in de hoofdmap van je project:
{
"mcpServers": {
"leadconnector": {
"type": "http",
"url": "https://services.leadconnectorhq.com/mcp/anthropic/v2"
}
}
}
Bij het eerste gebruik opent Claude Code een browser om toegang tot LeadConnector te autoriseren. Log in, kies je account en geef toestemming voor toegang. Controleer de verbinding met:
claude mcp list
Claude Cowork
- Open de instellingen voor connectors / integrations (koppelingen / integraties) in Claude Cowork.
- Kies Add custom connector (Aangepaste koppeling toevoegen).
- Vul https://services.leadconnectorhq.com/mcp/anthropic/v2 in.
- Doorloop het OAuth-proces van LeadConnector: log in, kies je account en geef toestemming voor toegang.
Je Cowork-agenten kunnen daarna de LeadConnector-tools gebruiken.
ChatGPT
- Open in ChatGPT Settings → Security and login (Instellingen → Beveiliging en aanmelden) en zet Developer mode (Ontwikkelaarsmodus) aan.
- Open ChatGPT Plugins, klik op de plusknop en maak een nieuwe plugin.
- Vul een naam en beschrijving in. Voeg onder Connection (Verbinding) deze MCP-server-URL toe en maak de verbinding: https://services.leadconnectorhq.com/mcp/openai/v2/.
- Doorloop het OAuth-proces van LeadConnector: log in, kies je account en geef toestemming voor toegang.
- Start een nieuw gesprek en voeg de LeadConnector-verbinding toe via het toolmenu.
Codex
Voeg de server toe en start de OAuth-autorisatie:
codex mcp add leadconnector --url https://services.leadconnectorhq.com/mcp/openai/v2/ codex mcp login leadconnector
Open in de Codex IDE extension (Codex IDE-extensie) het tandwielmenu → MCP servers → Add server (tandwielmenu → MCP-servers → Server toevoegen). Kies Streamable HTTP en vul dezelfde URL in. Kies Authenticate (Authenticeren) wanneer je daarom wordt gevraagd om OAuth af te ronden.
Andere compatibele OpenAI-apps kunnen deze URL gebruiken als externe Streamable HTTP MCP-server. Doorloop het OAuth-proces van LeadConnector wanneer je daarom wordt gevraagd.
Cursor
Voeg deze configuratie toe aan .cursor/mcp.json in je project, of aan ~/.cursor/mcp.json om de verbinding in meerdere projecten beschikbaar te maken:
{
"mcpServers": {
"leadconnector": {
"url": "https://services.leadconnectorhq.com/mcp/cursor/v2"
}
}
}
Heb je al andere servers ingesteld? Voeg dan de regel leadconnector toe aan het bestaande mcpServers -object.
Doorloop het OAuth-proces van LeadConnector wanneer Cursor daarom vraagt: log in, kies je account en geef toestemming voor toegang.
Muse
LeadConnector is beschikbaar als officiële app in Muse. Koppel de app en doorloop het OAuth-proces van LeadConnector: log in, kies je account en geef toestemming voor toegang.
Muse gebruikt https://services.leadconnectorhq.com/mcp/muse/v2/ voor de OAuth-verbinding.
Grok Bot
- Open Grok Bot → Connect apps (Grok Bot → Apps koppelen).
- Zoek op HighLevel en kies Add (Toevoegen).
- Doorloop het OAuth-proces van LeadConnector: log in, kies je account en geef toestemming voor toegang.
Wil je de app aan een specifieke taak koppelen? Typ dan @ in de chat en selecteer HighLevel.
Controleer je verbinding
Begin met een eenvoudige opdracht, bijvoorbeeld:
Zoek de laatste 5 contacten die ik in Voluit Suite heb toegevoegd.
Je assistent kan de beschikbare contactacties opzoeken en gegevens ophalen binnen de rechten die je hebt gegeven.
Je account gebruiken
Een verbinding voor één account blijft gekoppeld aan het account dat je tijdens de OAuth-autorisatie hebt gekozen, zolang de verbinding bestaat.
Hoe werken de vier MCP-tools?
De server biedt vier centrale tools. Je assistent gebruikt deze tools om de beschikbare acties voor je verbinding te vinden en uit te voeren.
| Tool | Doel |
|---|---|
list_locations |
De accounts vinden die beschikbaar zijn voor de verbinding, of het ene gekoppelde account ophalen. |
search_operations |
Actieve acties voor de taak vinden, zoals gegevens zoeken, lezen, aanmaken, wijzigen en verwijderen. |
describe_operation |
De invoer, een voorbeeld van de gegevens, de vereiste toegangsrechten en veiligheidsinformatie van een actie bekijken. |
execute_operation |
Een actie uitvoeren binnen de OAuth-toegangsrechten, toestemmingen, accountgrenzen en ingebouwde veiligheidscontroles. |
Je kunt je assistent op elk moment vragen om met search_operations te controleren wat er voor jouw verbinding beschikbaar is.
Wat kun je doen?
De actieve catalogus bevat de onderstaande onderdelen. Wat beschikbaar is, hangt af van je OAuth-toegangsrechten en toestemmingen.
| Onderdeel | Voorbeelden van ondersteunde acties |
|---|---|
| Contacten (Contacts) | Contacten zoeken en beheren, dubbele contacten opzoeken, tags, notities, taken, volgers, campagnes, afspraken, bedrijfstoewijzingen en contacten aan workflows toevoegen. |
| Gesprekken (Conversations) en berichten | Gesprekken beheren, berichten lezen en versturen en werken met bijlagen, geplande berichten, statusupdates, opnames, transcripties, exports en typindicatoren. |
| Leads (Opportunities) en Pijplijnen (Pipelines) | Pijplijnen en redenen voor verlies beheren, leads zoeken, aanmaken, wijzigen, verwijderen of aanmaken/bijwerken, en werken met volgers en statuswijzigingen. |
| Kalenders (Calendars) en afspraken | Werken met kalenders, groepen, afspraken, evenementen, notities, meldingen, beschikbare en geblokkeerde tijdsblokken, middelen, beschikbaarheidsschema's, Diensten (Services), dienstlocaties en boekingen. |
| Betalingen (Payments) | Coupons, instellingen voor betaalproviders, integraties, bestellingen, afhandeling, geregistreerde betalingen, abonnementen en transacties beheren. |
| Producten en online shop | Werken met producten, prijzen, collecties, voorraad, recensies, plaatsing in de online shop, vervoerders, verzendzones en -tarieven en instellingen van de online shop. |
| Facturen, Offertes (Estimates) en documenten | Werken met facturen, offertes, Sjablonen (Templates), schema's, handmatige betalingen, versturen en ongeldig maken, facturen aanmaken vanuit offertes, voorstellen en documentlinks. |
| Social Planner | Werken met socialmedia-accounts, posts, opmerkingen, categorieën, tags, CSV-imports, wachtrijen per categorie, kalenderweergaven, bewerksessies en statistieken. |
| Blogs | Werken met blogsites, auteurs, categorieën, posts en controles van slugs. |
| E-mails | Werken met e-mailsjablonen, mappen, imports, campagnes, planning, campagnestatistieken, bulkactiecampagnes, workflowcampagnes en e-mailverificatie. |
| Formulieren (Forms) en Enquêtes (Surveys) | Formulieren, enquêtes en inzendingen ophalen. |
| Trechters (Funnels) | Werken met trechters, trechterpagina's, aantallen pagina's en omleidingen. |
| Workflows | Workflows weergeven en zoeken, staptypen bekijken, workflowdefinities lezen, aanmaken, valideren, wijzigen, publiceren en verwijderen, en uitvoeringslogboeken en stapstatistieken bekijken. Contacten toevoegen aan of verwijderen uit een workflow gebeurt via contactacties. |
| Spraak-AI (Voice AI) | Werken met agenten, agentacties en gesprekslogboeken. |
| Telefoonsysteem (Phone System) | Werken met nummerpools, actieve en beschikbare nummers en telefoonnummers aankopen. |
| Kennisbank (Knowledge Base) | Werken met kennisbanken, websites doorzoeken en gebruiken voor training, de crawlstatus, veelgestelde vragen en bestanden. |
| Mediabibliotheek (Media Storage) en bestanden | Werken met bestanden en mappen, mappen aanmaken en mediabestanden in bulk wijzigen of verwijderen. |
| Merkborden (Brand Boards) | Werken met ontwerpsets, merkstemmen en standaard merkinstellingen. |
| Aangepaste objecten, Aangepaste velden (Custom Fields) en associaties | Werken met objectschema's, records, zoekopdrachten naar records, aangepaste velden en mappen, associatiedefinities en relaties tussen records. |
| Accounts en CRM-instellingen | Accounts zoeken en ophalen en werken met gesprekskanalen, Aangepaste waarden (Custom Values), terugkerende taken, tags, sjablonen, tijdzones en zoekopdrachten naar taken. |
| Bedrijven en gebruikers | Bedrijven en gebruikers zoeken, aanmaken, wijzigen en verwijderen. |
| App-marketplace (App Marketplace) en wallet | Installatiegegevens ophalen, werken met wallet-afschrijvingen en saldo-controles en wallet-transacties van je account ophalen. |
| Advertenties en Affiliate Manager | Ondersteunde advertentieacties voor Facebook, Google en LinkedIn gebruiken en werken met doelgroepen, leadformulieren, rapportages, affiliates, commissies en uitbetalingen. |
| Overige CRM-onderdelen | Ondersteunde acties uitvoeren voor chatwidgets, links, campagnes en cursussen. |
Voorbeeld: een taak uitvoeren met één opdracht
Na het koppelen kun je je assistent bijvoorbeeld deze opdracht geven:
Zoek het contact met e-mailadres jane@jouwbedrijf.nl, voeg de tag ‘vip-2026’ toe en maak voor dit contact een lead aan in ‘Sales Pipeline’ met een waarde van € 5.000.
De assistent gebruikt search_operations om de acties voor contact opzoeken, een tag toevoegen en een lead aanmaken te vinden. Met describe_operation controleert de assistent de invoer, toegangsrechten en veiligheidsinformatie. Daarna gebruikt de assistent execute_operation om het contact te vinden en de ondersteunde acties uit te voeren. Je krijgt de resultaten terug in gewone taal.
Toegang en veiligheid
- Jij kiest het account. Elke aanvraag wordt gecontroleerd tegen de installatie en kan alleen een account gebruiken dat in de verbinding is opgenomen.
- OAuth-toegangsrechten beperken de acties. De assistent kan alleen acties uitvoeren waarvoor je toestemming hebt gegeven.
- Gevoelige acties krijgen extra controles. Voor gevoelige en onomkeerbare acties gelden bevestigings- en veiligheidscontroles voordat ze worden uitgevoerd.
- Jij houdt controle over de toegang. Bekijk of trek de toegang van de verbinding in via je LeadConnector-account.
Veelgestelde vragen
V: Heb ik een Private Integration Token nodig?
Antwoord: De verbindingen in dit artikel gebruiken OAuth. Doorloop het aanmeld- en toestemmingsproces van LeadConnector om toegang te geven. Je hoeft voor deze verbindingen niet zelf een token aan te maken of te vernieuwen.
V: Welke server-URL moet ik gebruiken?
Antwoord: Gebruik de URL voor jouw app in de verbindingstabel hierboven. Claude gebruikt het Anthropic-eindpunt, ChatGPT en Codex gebruiken het OpenAI-eindpunt en Cursor heeft een eigen eindpunt. Muse en Grok Bot bieden ook een officieel vermelde app aan.
V: Waarom zie ik vier tools in plaats van honderden?
Antwoord: Met de vier tools kan de assistent de actieve catalogus met acties doorzoeken en acties uitvoeren. Afzonderlijke CRM-acties worden gevonden via search_operations , bekeken via describe_operation en uitgevoerd via execute_operation .
V: Hoeveel acties zijn beschikbaar?
Antwoord: De actieve catalogus bevat meer dan 550 acties in 38 gebieden. Je verbinding kan alleen de acties gebruiken die zijn toegestaan door de OAuth-toegangsrechten en toestemmingen. Vraag je assistent om de actie te zoeken die je nodig hebt.
V: Kan mijn assistent gegevens aanmaken, wijzigen of verwijderen?
Antwoord: Ja, als de actie wordt ondersteund en je OAuth-toestemming dit toelaat. Voor gevoelige en onomkeerbare acties gelden ook bevestigings- en veiligheidscontroles.
V: Kan de assistent een account gebruiken dat ik niet heb geselecteerd?
Antwoord: Nee. Aanvragen voor accounts die niet in de installatie zijn opgenomen, worden geweigerd.
V: Hoe verwijder ik de toegang?
Antwoord: Bekijk of trek de toegang van de koppeling in via je LeadConnector-account.
Technische documentatie
Bekijk de technische documentatie van de LeadConnector MCP-server.