DE
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
Sarah
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.
3 Dateien geändert · in der Development-App getestet
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öchtendeveloper.unipile.com/mcp
Alle Kanäle verbinden10 Kanäle
LinkedInLinkedIn/v2/{account_id}/chats
WhatsAppWhatsApp/v2/{account_id}/chats
InstagramInstagram/v2/{account_id}/chats
TelegramTelegram/v2/{account_id}/chats
GmailGmail/v2/{account_id}/emails
OutlookOutlook/v2/{account_id}/emails
IMAPIMAP/v2/{account_id}/emails
Google CalendarGoogle Calendar/v2/{account_id}/calendars
Outlook CalendarOutlook Calendar/v2/{account_id}/calendars
↑↓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.
U
User-Scope--scope user · jedes Projekt, privat für Sie
P
Projekt-Scope.mcp.json im Wurzelverzeichnis des Repositories, geteilt
L
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.
Terminal
# 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

  1. 1Im Terminal zeigt claude mcp list ✔ Connected an und claude mcp get unipile die Details.
  2. 2In einer Session zeigt /mcp den Status und genehmigt beim ersten Mal eine .mcp.json mit Projekt-Scope.
  3. 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.
Claude Code · support-consoleDevelopment-App
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.3 Dateien geändert · in der Development-App getestet

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
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
WhatsApp API
Claude Code · crm-appDevelopment-App
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.4 Dateien geändert · Senden und Threading end-to-end getestet

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
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
E-Mail-API
Claude Code · saas-backendDevelopment-App
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.5 Dateien geändert · Isolation verifiziert

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
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
Konten, Scopes und Keys
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
SOC 2 Typ II
Zertifiziert
Unabhängig geprüfte Sicherheitskontrollen zur Gewährleistung des Datenschutzes und der betrieblichen Integrität.
GDPR
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.