Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Cursor · MCP Server
Cursor MCP Server: Messaging und E-Mail in Ihrer IDE
Eine URL und ein Header fügen den Unipile MCP-Server zu Cursor hinzu. Ihr Agent baut dann LinkedIn-, WhatsApp- und E-Mail-Features in Ihr Projekt ein und testet jeden Aufruf in Ihrer Development-App. Nichts zu installieren oder lokal zu starten.
7 Tage kostenlos testen, ohne Kreditkarte.
Cursor · crm-app
Unipile MCP verbunden
Verbinde LinkedIn-Konten mit meinem CRM.
Endpoint lesenPOST /v2/auth/linkSchema geladen
Connect-Route und Settings-Button ergänzt. Die Konto-ID wird am Nutzer gespeichert.
Nächstes Feature beschreiben…
Anwendungsfall
LinkedIn, WhatsApp und E-Mail aus Cursor in Ihr Produkt bringen
Bringen Sie LinkedIn, WhatsApp, E-Mail oder Kalender in Ihr Produkt. Über den Unipile MCP-Server liest Cursor die API-Referenz, schreibt den Code in Ihrem Stack und testet jede Anfrage.
Den Unipile MCP-Server mit Cursor verbindenUnipile MCP verbunden
Wählen Sie die Kanäle, die Sie verbinden möchten
developer.unipile.com/mcpAlle Kanäle verbinden10 Kanäle
↑↓navigieren Leertasteauswählen ↵verbindeneine URL, ein Header
mcp.json, global oder pro Projekt
Unipile MCP-Server für Cursor
Der Server ist remote: eine URL über streamable HTTP und ein Header, lokal läuft nichts. Wählen Sie global oder Projekt, fügen Sie den Block ein, speichern Sie, und Cursor lädt ihn.
Vorab: ein aktuelles Cursor, eine Development-Anwendung im Unipile-Dashboard mit einem Scoped Account API Key und ein Testkonto, das über Hosted Auth verknüpft ist.
Globale Konfiguration~/.cursor/mcp.json
Projektkonfiguration.cursor/mcp.json (Wurzelverzeichnis des Repositories)
Key aus einer Umgebungsvariablen${env:UNIPILE_API_KEY}
?
Global oder pro Projekt?Projekt, wenn jedes Repository einen eigenen Scoped Key braucht. Cursor liest zuerst Projekt, dann global.
{
"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}"
}
}
}
}
Speichern Sie die Datei, und Cursor lädt den Server. ${env:NAME} funktioniert in url und headers, der Key steht also nie in der Datei.
Die Verbindung prüfen
- 1Öffnen Sie Customize in der Sidebar: Der Server unipile ist gelistet und aktiviert.
- 2Führen Sie in der Cursor CLI
agent mcp listaus, oder/mcp listin einer Session. - 3Fragen Sie im Chat
Liste über den Unipile MCP die Endpoints für die LinkedIn-Personensuche und ihre Pflichtparameter auf: Zurück kommen echte Routen.
Optional: Installation mit einem Klick
Fügen Sie Ihren Scoped Account API Key ein, um einen Link zu erhalten, der Cursor mit vorausgefülltem Server öffnet. Der Key verlässt nie Ihren Browser.
Unipile zu Cursor hinzufügen
Prompts statt Glue Code
Geben Sie Ihrem Agenten den Prompt
Drei Integrationsaufgaben, jeweils mit dem Prompt für Cursor, den Endpoints, die der Agent auf
https://api.unipile.com mit Ihrem X-API-KEY aufruft, und dem, was in Ihrem Projekt landet.Ergänze mein ATS um LinkedIn-Messaging: Synchronisiere den Posteingang jedes Recruiters und lass ihn von der Kandidatenseite aus antworten.
Endpoints suchen"chats messages send"3 Treffer
Anfrage ausführenGET /v2/{account_id}/chats12 Chats
Erstellt:
linkedin/inbox-sync.ts (Chats und Nachrichten am Kandidaten upserted, Cursor-Pagination) und POST /candidates/:id/reply, das die Send-Route mit der Konto-ID des jeweiligen Chats aufruft. Sync in der Development-App ausgeführt: 12 Chats, 87 Nachrichten.Prompt einfügen, Diff prüfen
Cursor liest die Verträge für Chats und Nachrichten, schreibt den Sync-Job und den Antwort-Endpoint und führt die ersten Anfragen in Ihrer Development-Anwendung aus. WhatsApp, Instagram, Facebook und Telegram nutzen dieselben Chat-Routen.
Endpoints, die der Agent nutzt
Eine LinkedIn-Integration bauen
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Implementiere Unipile Hosted Auth in dieser React- und Fastify-App, damit Nutzer ihr eigenes LinkedIn-Konto aus den Settings verbinden.
Endpoint lesenPOST /v2/auth/linkSchema geladen
Anfrage ausführenPOST /v2/auth/link201 · link
Ergänzt
POST /api/accounts/connect in Fastify: erstellt den Auth-Link serverseitig und gibt die gehostete URL zurück. Die React-Settings-Seite öffnet sie und speichert bei der Rückkehr die neue account_id am Workspace. In der Development-App mit einem LinkedIn-Testkonto verifiziert.Ihre Nutzer verbinden ihre eigenen Konten, Ihre App erhält eine Konto-ID
Hosted Auth ist die Seite, die Unipile ausliefert, damit Ihre Nutzer ihre eigenen Konten verbinden. Der Agent verkabelt den Link im Backend, die Weiterleitung im Frontend und die Speicherung der Konto-ID.
Endpoints, die der Agent nutzt
Hosted Auth mit einem Agenten implementieren
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Abonniere die Webhooks für neue Nachrichten und baue eine Unified Inbox für LinkedIn, WhatsApp und E-Mail: eine Thread-Liste mit dem Kanal als Badge.
Endpoint lesenPOST /v2/webhooks/endpoints/Schema geladen
Anfrage ausführenGET /v2/{account_id}/emails200 OK
Webhook-Endpoint für Message-Events in der Development-App registriert,
POST /webhooks/unipile ergänzt, das sofort 200 zurückgibt und das Event in die Queue legt, dazu ein Modell Thread , das Chats und E-Mail-Threads auf eine Struktur abbildet, und die Thread-Liste mit Kanal-Badges. Testnachricht gesendet: Die Liste wurde in unter einer Sekunde aktualisiert.Echtzeit ohne Polling, eine Liste für Messaging und E-Mail
Der Agent liest die Verträge für Chats und E-Mails, entwirft ein gemeinsames Thread-Modell und schreibt den Sync und den Webhook-Empfänger. Danach prüft er das Delivery-Log über die Webhook-Conversations-Route.
Endpoints, die der Agent nutzt
Eine Unified Inbox mit einem Agenten bauen
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Zuerst eine Development-Anwendung
Geben Sie Cursor einen Scoped Key aus einer Development-Anwendung, getrennt von Production.
Testkonten, echte Anfragen
Der Agent führt Anfragen auf Testkonten aus, im Namen des authentifizierten Nutzers, der sie verknüpft hat, innerhalb der Limits jedes Anbieters.
Jeden Ablauf prüfen
Prüfen Sie den Verbindungsablauf, je einen Lese- und Schreibvorgang pro Funktion und eine Webhook-Zustellung.
Dann auf Production umstellen
Nichts berührt die Konten Ihrer Nutzer, bevor Sie den Key umstellen. Siehe Sicherheit und Compliance.
Fehlerbehebung
Häufige Fehler und was sie bedeuten
Die Meldungen, die Cursor zeigt, wenn ein MCP-Eintrag nicht stimmt, und die jeweilige Lösung.
No tools or prompts
Prüfen Sie die bearbeitete Datei (~/.cursor/mcp.json oder .cursor/mcp.json), entfernen Sie ein überzähliges Komma und laden Sie den Server dann aus Customize neu.
No server info found
Verwenden Sie einen Remote-Eintrag mit url exakt auf https://developer.unipile.com/mcp?branch=v2.0 und headers, ohne command oder type: "stdio".
Connection failed
Prüfen Sie Host und ?branch=v2.0 auf Tippfehler oder einen Unternehmens-Proxy: Die URL muss im Browser antworten, nicht 404 liefern.
401 Unauthorized bei Anfragen
Senden Sie einen Scoped Account API Key aus Ihrer Development-Anwendung in headers, exakt unter dem Namen X-API-KEY.
Die Projektkonfiguration wird ignoriert
Legen Sie .cursor/mcp.json in das Wurzelverzeichnis des in Cursor geöffneten Ordners, nicht in einen Unterordner.
Wo Sie die Logs finden
Öffnen Sie das Output-Panel (Cmd+Shift+U auf macOS, Ctrl+Shift+U auf Windows und Linux) und wählen Sie MCP Logs im Dropdown.
6000+
Unternehmen, die mit Unipile innovieren
Vertrauen bei Branchenführern
1 API
Rationalisierung der Abläufe für alle wichtigen Kommunikationskanäle
2 Tage
Schnelle Live-Integration mit minimaler Einrichtung
30%
Verringerung des Wartungsaufwands und der Ressourcen
Integrierte Sicherheit und Compliance
Unternehmensgerechter Schutz für Ihre Daten und Arbeitsabläufe Erfahren Sie mehr über unsere Sicherheit
SOC 2 Typ II
Zertifiziert
Unabhängig geprüfte Sicherheitskontrollen zur Gewährleistung des Datenschutzes und der betrieblichen Integrität.
GDPR
Konform
Vollständige Einhaltung der europäischen Datenschutzbestimmungen zum Schutz der Privatsphäre der Nutzer.
99.9%
Betriebszeit der Plattform in den letzten 24 Monaten
24/7
Globaler Support mit leistungsstarker API
FAQ zum Cursor MCP-Server
Die Fragen, die wirklich gestellt werden: wo mcp.json liegt, global oder pro Projekt, Remote-Server und Header, was zu prüfen ist, wenn nichts erscheint, Keys, Ein-Klick-Installation und die CLI.
An zwei Orten.
~/.cursor/mcp.json im Home-Verzeichnis ist die globale Konfiguration, in jedem Projekt verfügbar. .cursor/mcp.json im Wurzelverzeichnis des in Cursor geöffneten Ordners ist die Projektkonfiguration. Cursor liest zuerst die Projektdatei, dann die globale, dann die übergeordneten Verzeichnisse. Beide nehmen denselben mcpServers Block.Global, wenn Sie mehrere Unipile-Integrationen auf einer Maschine und mit einer Development-Anwendung bauen. Pro Projekt, wenn jedes Repository seinen eigenen Scoped Key braucht, was richtig ist, sobald Development- und Production-Integrationen in verschiedenen Repositories liegen. In beiden Fällen ist der Key ein Scoped Account API Key, nie ein Service- oder globaler Key.
Ja. Ein Remote-Eintrag in
mcp.json nimmt eine url und ein Objekt headers entgegen, und Cursor löst ${env:NAME} in beiden auf. Der Unipile-Server ist genau das: streamable HTTP unter https://developer.unipile.com/mcp?branch=v2.0 mit dem X-API-KEY Header. Kein npx, kein lokaler Prozess, keine Node-Version zu verwalten.In dieser Reihenfolge: die bearbeitete Datei (global oder Projekt, im Wurzelverzeichnis des Repositories), die Gültigkeit des JSON, ein Neuladen des Servers aus Customize oder ein Neustart von Cursor, danach die MCP Logs im Output-Panel (Cmd+Shift+U, MCP Logs wählen). Verbindet sich der Server, schlagen Anfragen aber mit 401 fehl, fehlt der Key im Header oder er ist kein Scoped Account API Key.
Der Server antwortet ohne Key, solange der Agent nur die API-Spezifikation liest. Für echte Anfragen erstellen Sie in Ihrer Development-Anwendung einen Scope, weisen die Testkonten zu und erzeugen einen Scoped Account API Key für diesen Scope. Geben Sie einem MCP-Client nie einen Service-Key oder einen globalen Account-Key.
Ja. Der Installationslink auf dieser Seite kodiert die Serverkonfiguration; er öffnet Cursor mit vorausgefülltem unipile-Eintrag, und Sie ersetzen den Platzhalter durch Ihren Scoped Key. Der optionale Generator oben baut denselben Link mit Ihrem Key, vollständig in Ihrem Browser.
Ja. Die CLI teilt sich die Konfiguration mit dem Editor, zuerst Projekt, dann global.
agent mcp list zeigt die konfigurierten Server und ihren Status, und /mcp list tut dasselbe innerhalb einer interaktiven Session. Der Agent nutzt den Unipile-Server dann, sobald eine Anfrage es erfordert.