Cursor · MCP Server
Cursor MCP-server: messaging en e-mail in uw IDE
Met één URL en één header voegt u de Unipile MCP-server toe aan Cursor. Daarna bouwt uw agent LinkedIn-, WhatsApp- en e-mailfuncties in uw project en test hij elke call op uw Development-app. Niets te installeren of lokaal te draaien.
7 dagen gratis proberen, geen creditcard nodig.
Cursor · crm-app
Unipile MCP verbonden
Voeg het koppelen van LinkedIn-accounts toe aan mijn CRM.
Endpoint lezenPOST /v2/auth/linkschema geladen
De connect-route en de knop in Instellingen toegevoegd. De account-ID wordt bij de gebruiker opgeslagen.
Beschrijf de volgende feature…
Use case
Voeg LinkedIn, WhatsApp en e-mail toe aan uw product vanuit Cursor
Voeg LinkedIn, WhatsApp, e-mail of agenda toe aan uw product. Via de Unipile MCP-server leest Cursor de API-referentie, schrijft de code in uw stack en test elke request.
Koppel de Unipile MCP-server aan CursorUnipile MCP verbonden
Selecteer de kanalen die u wilt koppelen
developer.unipile.com/mcpAlle kanalen koppelen10 kanalen
↑↓navigeren spatieselecteren ↵koppelenéén URL, één header
mcp.json, globaal of per project
Voeg de Unipile MCP-server toe aan Cursor
De server draait remote: één URL via streamable HTTP en één header, niets om lokaal te draaien. Kies globaal of project, plak het blok, sla op, en Cursor laadt hem.
Voordat u begint: een actuele Cursor, een Development-applicatie in het Unipile-dashboard met een scoped Account API key, en één testaccount gekoppeld via Hosted Auth.
Globale configuratie~/.cursor/mcp.json
Projectconfiguratie.cursor/mcp.json (root van de repository)
Key uit een omgevingsvariabele${env:UNIPILE_API_KEY}
?
Globaal of project?Project wanneer elke repository een eigen scoped key nodig heeft. Cursor leest eerst project, daarna globaal.
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "your-scoped-api-key"
}
}
}
}
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "your-scoped-api-key"
}
}
}
}
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "${env:UNIPILE_API_KEY}"
}
}
}
}
Sla het bestand op en Cursor laadt de server. ${env:NAME} werkt in url en headers, dus de sleutel staat nooit in het bestand.
De verbinding controleren
- 1Open Customize in de zijbalk: de unipile-server staat in de lijst en is ingeschakeld.
- 2Voer in de Cursor CLI
agent mcp listuit, of/mcp listin een sessie. - 3Vraag in een chat
Using the Unipile MCP, list the endpoints for LinkedIn people search and their required parametersen verwacht echte routes terug.
Optioneel: installeren met één klik
Plak uw scoped Account API key om een link te krijgen die Cursor opent met de server al ingevuld. De sleutel verlaat uw browser nooit.
Unipile toevoegen aan Cursor
Prompts, geen lijmcode
Geef uw agent de prompt
Drie integratietaken, elk met de prompt om in Cursor te plakken, de endpoints die de agent aanroept op
https://api.unipile.com met uw X-API-KEY, en wat er in uw project terechtkomt.Voeg LinkedIn-messaging toe aan mijn ATS: synchroniseer de inbox van elke recruiter en laat ze antwoorden vanaf de kandidaatpagina.
Endpoints zoeken"chats messages send"3 resultaten
Request uitvoerenGET /v2/{account_id}/chats12 chats
Aangemaakt
linkedin/inbox-sync.ts (chats en berichten ge-upsert op de kandidaat, cursorpaginering) en POST /candidates/:id/reply, dat de verzendroute aanroept met de eigen account-ID van de chat. Sync uitgevoerd op de Development-app: 12 chats, 87 berichten.Plak de prompt, review de diff
Cursor leest de contracten voor chats en berichten, schrijft de synchronisatietaak en het antwoord-endpoint, en voert de eerste requests uit op uw Development-applicatie. WhatsApp, Instagram, Facebook en Telegram gebruiken dezelfde chatroutes.
Endpoints die de agent gebruikt
Bouw een LinkedIn-integratie
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Implementeer Unipile Hosted Auth in deze React- en Fastify-app, zodat gebruikers hun eigen LinkedIn-account koppelen vanuit Instellingen.
Endpoint lezenPOST /v2/auth/linkschema geladen
Request uitvoerenPOST /v2/auth/link201 · link
Toegevoegd
POST /api/accounts/connect in Fastify: maakt de auth-link server-side aan en geeft de gehoste URL terug. De React-pagina Instellingen opent die en slaat bij terugkeer de nieuwe account_id op bij de workspace. Gecontroleerd op de Development-app met een LinkedIn-testaccount.Uw gebruikers koppelen hun eigen accounts, uw app krijgt een account-ID
Hosted Auth is de pagina die Unipile aanbiedt zodat uw gebruikers hun eigen accounts koppelen. De agent bouwt de link in uw backend, de redirect in uw frontend en de opslag van de account-ID.
Endpoints die de agent gebruikt
Hosted Auth implementeren met een agent
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Abonneer op webhooks voor nieuwe berichten en bouw een unified inbox voor LinkedIn, WhatsApp en e-mail: één threadlijst met het kanaal als badge.
Endpoint lezenPOST /v2/webhooks/endpoints/schema geladen
Request uitvoerenGET /v2/{account_id}/emails200 OK
Een webhook-endpoint voor berichtevents geregistreerd op de Development-app, en toegevoegd:
POST /webhooks/unipile dat direct 200 teruggeeft en het event in de wachtrij zet, een Thread model dat chats en e-mailthreads naar één vorm omzet, en de threadlijst met kanaalbadges. Testbericht verstuurd: de lijst werd binnen een seconde bijgewerkt.Realtime zonder polling, één lijst voor messaging en e-mail
De agent leest de contracten voor chats en e-mails, ontwerpt één threadmodel en schrijft de synchronisatie en de webhookontvanger. Daarna controleert hij het leveringslog via de route voor webhookgesprekken.
Endpoints die de agent gebruikt
Bouw een unified inbox met een agent
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Eerst een Development-applicatie
Geef Cursor een scoped key uit een Development-applicatie, gescheiden van Production.
Testaccounts, echte requests
De agent voert requests uit op testaccounts, namens de geauthenticeerde gebruiker die ze heeft gekoppeld, binnen de limieten van elke provider.
Valideer elke flow
Controleer de koppelingsflow, één lees- en één schrijfactie per feature, en een webhooklevering.
Zet daarna over naar Production
Niets raakt de accounts van uw gebruikers totdat u de sleutel omzet. Zie beveiliging en compliance.
Probleemoplossing
Veelvoorkomende fouten en wat ze betekenen
De meldingen die Cursor toont als een MCP-entry niet klopt, en de oplossing voor elk.
No tools or prompts
Controleer het bestand dat u hebt bewerkt (~/.cursor/mcp.json of .cursor/mcp.json), verwijder een eventuele komma aan het eind en laad de server opnieuw via Customize.
No server info found
Gebruik een remote entry met url ingesteld op exact https://developer.unipile.com/mcp?branch=v2.0 en headers, zonder command of type: "stdio".
Connection failed
Controleer de host en ?branch=v2.0 op een typefout, of een bedrijfsproxy: de URL moet in een browser antwoorden, niet met een 404.
401 Unauthorized bij requests
Stuur een scoped Account API key uit uw Development-applicatie mee in headers, onder exact de naam X-API-KEY.
De projectconfiguratie wordt genegeerd
Zet .cursor/mcp.json in de root van de map die u in Cursor hebt geopend, niet in een submap.
Waar u de logs leest
Open het Output-paneel (Cmd+Shift+U op macOS, Ctrl+Shift+U op Windows en Linux) en kies MCP Logs in de dropdown.
6000+
Bedrijven innoveren met Unipile
Vertrouwd door marktleiders
1 API
Activiteiten stroomlijnen voor alle belangrijke communicatiekanalen
2 dagen
Snel live integratie bereiken met minimale installatie
30%
Vermindering van onderhoudsinspanningen en -middelen
Ingebouwde beveiliging en compliance
Enterprise-bescherming voor uw gegevens en workflows Meer informatie over onze beveiliging
SOC 2 type II
Gecertificeerd
Onafhankelijk gecontroleerde beveiligingscontroles voor gegevensbescherming en operationele integriteit.
GDPR
Conform
Volledige naleving van de Europese regelgeving voor gegevensbescherming voor de privacy van gebruikers.
99.9%
Platform Uptime over de laatste 24 maanden
24/7
Wereldwijde ondersteuning met krachtige API
FAQ Cursor MCP-server
De vragen die mensen echt intypen: waar mcp.json staat, globaal of per project, remote servers en headers, wat u controleert als er niets verschijnt, keys, installatie met één klik en de CLI.
Op twee plaatsen.
~/.cursor/mcp.json in uw thuismap is de globale configuratie, beschikbaar in elk project. .cursor/mcp.json in de root van de map die u in Cursor hebt geopend, is de projectconfiguratie. Cursor leest eerst het projectbestand, daarna het globale bestand, daarna bovenliggende mappen. Beide gebruiken hetzelfde mcpServers blok.Globaal als u meerdere Unipile-integraties bouwt vanaf één machine en één Development-applicatie. Per project als elke repository een eigen scoped key nodig heeft, wat de juiste keuze is wanneer de Development- en Production-integraties in verschillende repositories staan. In beide gevallen is de key een scoped Account API key, nooit een Service key of globale key.
Ja. Een remote entry in
mcp.json bevat een url en een headers object, en Cursor vult ${env:NAME} in beide in. De Unipile-server is precies dat: streamable HTTP op https://developer.unipile.com/mcp?branch=v2.0 met de X-API-KEY header. Geen npx, geen lokaal proces, geen Node-versie om te beheren.In deze volgorde: het bestand dat u bewerkte (globaal of project, in de root van de repository), de geldigheid van de JSON, de server herladen vanuit Customize of Cursor herstarten, en daarna de MCP Logs in het Output-paneel (Cmd+Shift+U, kies MCP Logs). Maakt de server verbinding maar mislukken requests met 401, dan ontbreekt de key in de header of is het geen scoped Account API key.
De server antwoordt zonder key zolang de agent alleen de API-specificatie leest. Om echte requests uit te voeren, maakt u een Scope aan in uw Development-applicatie, wijst u de testaccounts toe en genereert u een scoped Account API key voor die Scope. Geef een MCP-client nooit een Service key of een globale Account key.
Ja. De installatielink op deze pagina codeert de serverconfiguratie; hij opent Cursor met de unipile-entry al ingevuld, en u vervangt de placeholder door uw scoped key. De optionele generator hierboven maakt dezelfde link met uw key er al in, volledig in uw browser.
Ja. De CLI deelt de configuratie van de editor: eerst het project, daarna de globale config.
agent mcp list toont de geconfigureerde servers en hun status, en /mcp list doet hetzelfde binnen een interactieve sessie. De agent gebruikt de Unipile-server daarna zodra een request erom vraagt.