Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Claude Code · MCP Server
Claude Code MCP Server: Messaging und E-Mail in Ihrer App
Ein einziger claude mcp add Befehl verbindet den Unipile MCP-Server. Claude Code 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.
Claude Code · 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 Claude Code in Ihr Produkt bringen
Bringen Sie LinkedIn, WhatsApp, E-Mail oder Kalender in Ihr Produkt. Über den Unipile MCP-Server liest Claude Code die API-Referenz, schreibt den Code in Ihrem Stack und testet jede Anfrage.
Den Unipile MCP-Server mit Claude Code 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
claude mcp add, drei Scopes
Unipile MCP-Server für Claude Code
Der Server ist remote: eine URL über streamable HTTP und ein Header, lokal läuft nichts. Ein Befehl registriert ihn; der gewählte Scope entscheidet, wo er lädt.
Vorab: Claude Code installiert und angemeldet, eine Development-Anwendung im Unipile-Dashboard mit einem Scoped Account API Key und ein Testkonto, das über Hosted Auth verknüpft ist.
User-Scope--scope user · jedes Projekt, privat für Sie
Projekt-Scope.mcp.json im Wurzelverzeichnis des Repositories, geteilt
Lokaler Scope (Standard)nur dieses Projekt, privat, in ~/.claude.json
?
Welcher Scope?User für alle Projekte, Projekt, um .mcp.json mit dem Team zu teilen, lokal für einen einmaligen Test.
# User-Scope: jedes Projekt auf dieser Maschine, privat für Sie
claude mcp add --transport http --scope user \
unipile "https://developer.unipile.com/mcp?branch=v2.0" \
--header "X-API-KEY: your-scoped-api-key"
# Claude Code gibt "Added …" aus, danach: claude mcp list
// Projekt-Scope: im Wurzelverzeichnis des Repositories eingecheckt, mit dem Team geteilt
{
"mcpServers": {
"unipile": {
"type": "http",
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "${UNIPILE_API_KEY}"
}
}
}
}
// "type": "http" ist Pflicht; jeder Entwickler exportiert UNIPILE_API_KEY
# Lokaler Scope (Standard): nur dieses Projekt, privat, gespeichert in ~/.claude.json
claude mcp add --transport http \
unipile "https://developer.unipile.com/mcp?branch=v2.0" \
--header "X-API-KEY: your-scoped-api-key"
Geprüft mit Claude Code 2.1. Setzen Sie die URL in Anführungszeichen (zsh liest das ? als Muster) und --header ans Ende.
Die Verbindung prüfen
- 1Im Terminal zeigt
claude mcp list✔ Connected an undclaude mcp get unipiledie Details. - 2In einer Session zeigt
/mcpden Status und genehmigt beim ersten Mal eine .mcp.json mit Projekt-Scope. - 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.
Prompts statt Glue Code
Geben Sie Ihrem Agenten den Prompt
Drei Integrationsaufgaben, jeweils mit dem Prompt für Claude Code, 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 unsere Support-Konsole um WhatsApp-Messaging: Synchronisiere die Konversationen jedes Agents und lass ihn aus dem Ticket heraus antworten.
Endpoints suchen"chats messages send"3 Treffer
Anfrage ausführenGET /v2/{account_id}/chats9 Chats
Erstellt:
whatsapp/chat-sync.ts (Chats und Nachrichten am Ticket upserted, Cursor-Pagination) und POST /tickets/:id/reply , das die Send-Route über das Konto des jeweiligen Chats aufruft. Sync in der Development-App ausgeführt: 9 Chats, 41 Nachrichten.Ein WhatsApp-Posteingang in Ihrem Produkt, aus einem Prompt
Claude Code 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. LinkedIn, Instagram, Facebook und Telegram nutzen dieselben Chat-Routen.
Endpoints, die der Agent nutzt
WhatsApp API
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Lass Nutzer E-Mails von der Kontaktseite über ihr eigenes Gmail- oder Outlook-Postfach senden und threade die Antworten am Kontakt.
Endpoint lesenPOST /v2/{account_id}/emails/sendSchema geladen
Anfrage ausführenGET /v2/{account_id}/emails200 OK
Ergänzt
POST /contacts/:id/email , das die Send-Route über das Postfachkonto des Nutzers aufruft, die Option „Im Thread antworten“ über die Thread-ID und den eingehenden Sync, der Antworten am Kontakt anhängt. Test-E-Mail aus dem Postfach der Development-App gesendet und die Antwort im Thread gesehen.E-Mail aus dem eigenen Postfach des Nutzers, in Ihrem CRM gethreadet
Gmail, Outlook und IMAP teilen sich ein E-Mail-Schema. Der Agent verkabelt die Send-Aktion mit dem Postfach, das der Nutzer verbunden hat, und behält die Thread-ID, damit Antworten beim richtigen Kontakt landen.
Endpoints, die der Agent nutzt
E-Mail-API
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
Jeder Workspace in meinem SaaS hat mehrere Nutzer mit eigenen LinkedIn- und E-Mail-Konten. Isoliere sie: ein Scope und ein Scoped Key pro Workspace.
Endpoints suchen"scopes api-keys"4 Treffer
Anfrage ausführenPOST /v2/scopes/201 · scope
Beim Anlegen eines Workspace erstellt das Backend jetzt einen Scope und einen Scoped Account API Key, der verschlüsselt am Workspace gespeichert wird; jedes Konto, das ein Mitglied verbindet, wird diesem Scope zugewiesen. Alle Konto-Aufrufe nutzen den Workspace-Key. Mit zwei Workspaces in der Development-App getestet.
Viele Nutzer, viele Konten, eine Grenze pro Mandant
Ein Scoped Key sieht nur die Konten, die seinem Scope zugewiesen sind. Der Agent macht aus dieser Grenze Ihr Mandantenmodell, sodass die Multi-Konto-Logik in der API liegt, nicht in Ihrem Code.
Endpoints, die der Agent nutzt
Konten, Scopes und Keys
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
Zuerst eine Development-Anwendung
Geben Sie Claude Code 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 Status, die claude mcp list und /mcp ausgeben, wenn ein Eintrag nicht stimmt, und die jeweilige Lösung.
✘ Failed to connect
Verwenden Sie exakt https://developer.unipile.com/mcp?branch=v2.0 mit --transport http und prüfen Sie dann mit claude mcp get unipile.
⏸ Pending approval
Führen Sie claude im Ordner aus, bestätigen Sie den Trust-Dialog des Workspace und genehmigen Sie den Server dann über /mcp.
401 bei Anfragen
Senden Sie einen Scoped Account API Key aus Ihrer Development-Anwendung, exakt unter dem Header-Namen X-API-KEY.
Warnung zu fehlender Variable
Exportieren Sie UNIPILE_API_KEY in der Shell, die Claude Code startet, oder setzen Sie einen Standardwert mit ${UNIPILE_API_KEY:-}.
Verstecktes Whitespace in headers.X-API-KEY
Fügen Sie den Server mit getrimmtem Key erneut hinzu: Claude Code übernimmt Werte exakt so, wie sie geschrieben sind.
Derselbe Name in mehreren Scopes
Behalten Sie nur eine Definition, zum Beispiel mit claude mcp remove unipile --scope user: Lokal gewinnt vor Projekt, dann User.
MCP endpoint not found at <origin>
Verwenden Sie die vollständige URL https://developer.unipile.com/mcp?branch=v2.0, prüfen Sie sie mit curl -I und führen Sie dann claude mcp get unipile aus.
/mcp zeigt No MCP servers configured
Verwenden Sie ~/.claude.json oder .mcp.json im Projektwurzelverzeichnis, nie ~/.claude/mcp.json, und starten Sie dann die Session neu.
Die Shell lehnt die URL ab, oder branch fehlt
Setzen Sie die URL in claude mcp add immer in Anführungszeichen, sonst antwortet zsh mit „no matches found“ und bash kann den Parameter verwerfen.
Langsamer Start oder Timeout
Erhöhen Sie das Limit für die Session mit MCP_TIMEOUT=60000 claude.
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 Claude Code MCP-Server
Die Fragen, die wirklich gestellt werden: Scopes, wo die Konfiguration liegt, Keys außerhalb des Repositories, eigene Header, Failed to connect, die URL in Anführungszeichen, Änderungen an .mcp.json und API Keys.
Lokal ist der Standard: gespeichert in
~/.claude.json unter dem aktuellen Projekt, privat und auf dieses Projekt begrenzt. Projekt schreibt .mcp.json ins Wurzelverzeichnis des Repositories und teilt die Datei über die Versionsverwaltung. User schreibt ~/.claude.json unter den Root-Key mcpServers und gilt für alle Ihre Projekte. Die Priorität ist lokal, dann Projekt, dann User. Für Unipile: --scope user für Ihren persönlichen Entwicklungs-Key, --scope project , wenn das ganze Team an derselben Integration arbeitet.In
~/.claude.json (unter Windows %USERPROFILE%\.claude.json) für den lokalen und den User-Scope, und in .mcp.json im Projektwurzelverzeichnis für den Projekt-Scope. Claude Code liest weder ~/.claude/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json oder %APPDATA%\Claude\mcp.json. claude mcp get unipile sagt Ihnen, in welchem Scope ein Eintrag liegt.Claude Code löst
${VAR} und ${VAR:-default} in command, args, env, url und headersauf. Schreiben Sie "X-API-KEY": "${UNIPILE_API_KEY}" in .mcp.json, checken Sie die Datei ein, und jeder Entwickler liefert seinen eigenen Scoped Key über seine Umgebung. Ist die Variable ohne Standardwert nicht gesetzt, lädt die Konfiguration trotzdem, und claude mcp list zeigt eine Warnung.Ja:
--header "X-API-KEY: your-scoped-api-key", wiederholbar für mehrere Header, Kurzform -H. Setzen Sie es hinter die URL, weil das Flag mehrere Werte akzeptiert. Der Unipile-Server ist ein Remote-HTTP-Server: nichts lokal zu installieren, kein npx, kein Node zu verwalten.Führen Sie
claude mcp get unipile für das Detail aus (HTTP-Status und Fehlertext), achten Sie auf die Warnungen zu führendem oder nachgestelltem Whitespace, die claude mcp list nach einem eingefügten Key ausgibt, und bestätigen Sie mit curl -I, dass die URL von Ihrer Maschine antwortet. Ein 404 gibt MCP endpoint not found at <origin>aus: Der Pfad ist falsch, die vollständige URL lautet https://developer.unipile.com/mcp?branch=v2.0, inklusive branch-Parameter.Die URL enthält ein
?, das zsh als Musterzeichen liest. Setzen Sie die URL in claude mcp addimmer in Anführungszeichen. Ohne Anführungszeichen antwortet zsh mit "no matches found", und bash kann den Parameter branch verwerfen, was Sie mit der falschen Version des Servers verbindet.Claude Code liest
.mcp.json beim Start der Session: beenden und neu starten. Ein fehlerhafter Eintrag wird stillschweigend ignoriert, und claude mcp list gibt die Parsing-Warnung mit dem fehlerhaften Feld aus. Wenn Sie den Server im Genehmigungsdialog des Projekts abgelehnt haben, führen Sie aus: claude mcp reset-project-choices.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 nur die betroffenen Konten 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.