PL
Claude Code · Serwer MCP

Serwer MCP dla Claude Code: wiadomości i e-mail w aplikacji

Jedno polecenie claude mcp add łączy serwer MCP Unipile. Claude Code buduje potem w projekcie funkcje LinkedIn, WhatsApp i e-mail oraz testuje każde wywołanie w aplikacji Development. Nic do instalowania ani uruchamiania lokalnie.
7 dni za darmo, bez karty kredytowej.
Claude Code · crm-app
Unipile MCP połączony
Sarah
Dodaj do mojego CRM połączenie konta LinkedIn.
Odczyt endpointuPOST /v2/auth/linkschemat wczytany
Dodano endpoint połączenia i przycisk w Ustawieniach. ID konta jest zapisywane przy użytkowniku.
3 zmienione pliki · przetestowane w aplikacji Development
Opisz kolejną funkcję…
Przypadek użycia

LinkedIn, WhatsApp i e-mail w Państwa produkcie, prosto z Claude Code

Dodaj do produktu LinkedIn, WhatsApp, e-mail lub kalendarz. Przez serwer MCP Unipile Claude Code czyta dokumentację API, pisze kod w używanym stacku i testuje każde zapytanie.
Podłącz serwer Unipile MCP do Claude CodeUnipile MCP połączony
Wybierz kanały do podłączeniadeveloper.unipile.com/mcp
Podłącz wszystkie kanały10 kanałów
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
↑↓nawigacja spacjawybór ↵połączjeden URL, jeden nagłówek
claude mcp add, trzy zakresy

Dodaj serwer Unipile MCP do Claude Code

Serwer jest zdalny: jeden URL przez streamable HTTP i jeden nagłówek, nic do uruchamiania lokalnie. Rejestruje go jedno polecenie; wybrany zakres decyduje, gdzie się ładuje.
Przed startem: zainstalowany i zalogowany Claude Code, aplikacja Development w dashboardzie Unipile z kluczem Account API z zakresem oraz jedno konto testowe podłączone przez Hosted Auth.
U
Zakres user--scope user · każdy projekt, tylko dla Państwa
P
Zakres project.mcp.json w katalogu głównym repozytorium, współdzielony
L
Zakres local (domyślny)tylko ten projekt, prywatnie, w ~/.claude.json
?
Który zakres?User dla wszystkich projektów, project, by współdzielić .mcp.json z zespołem, local do jednorazowej próby.
terminal
# Zakres user: każdy projekt na tej maszynie, prywatnie 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 wyświetli "Added …", potem: claude mcp list
// Zakres project: commitowany w katalogu głównym repozytorium, współdzielony z zespołem { "mcpServers": { "unipile": { "type": "http", "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "${UNIPILE_API_KEY}" } } } } // "type": "http" jest wymagane; każdy developer eksportuje UNIPILE_API_KEY
# Zakres local (domyślny): tylko ten projekt, prywatnie, zapisany w ~/.claude.json claude mcp add --transport http \ unipile "https://developer.unipile.com/mcp?branch=v2.0" \ --header "X-API-KEY: your-scoped-api-key"
Sprawdzone na Claude Code 2.1. URL trzeba ująć w cudzysłów (zsh traktuje ? jako wzorzec), a --header zostawić na końcu.

Sprawdzenie połączenia

  1. 1W terminalu claude mcp list pokazuje ✔ Connected, a claude mcp get unipile szczegóły.
  2. 2W sesji /mcp pokazuje stan i za pierwszym razem zatwierdza .mcp.json w zakresie project.
  3. 3Na czacie zapytaj: Korzystając z Unipile MCP, wypisz endpointy wyszukiwania osób na LinkedIn i ich wymagane parametry i oczekuj w odpowiedzi prawdziwych tras.
Prompty zamiast kodu klejącego

Prompt dla agenta

Trzy zadania integracyjne, a przy każdym prompt do wklejenia w Claude Code, endpointy wywoływane przez agenta na https://api.unipile.com z nagłówkiem X-API-KEY oraz to, co trafia do projektu.
Claude Code · support-consoleAplikacja Development
Dodaj wiadomości WhatsApp do naszej konsoli supportu: synchronizuj rozmowy każdego agenta i pozwól mu odpowiadać z poziomu zgłoszenia.
Wyszukiwanie endpointów"chats messages send"3 wyniki
Wykonaj zapytanieGET /v2/{account_id}/chats9 czatów
Utworzono whatsapp/chat-sync.ts (czaty i wiadomości zapisywane przy zgłoszeniu metodą upsert, paginacja kursorem) oraz POST /tickets/:id/reply wywołujący endpoint wysyłki na koncie, do którego należy czat. Synchronizacja uruchomiona w aplikacji Development: 9 czatów, 41 wiadomości.3 zmienione pliki · przetestowane w aplikacji Development

Inbox WhatsApp w produkcie, z jednego promptu

Claude Code czyta kontrakty czatów i wiadomości, pisze zadanie synchronizacji i endpoint odpowiedzi, a potem wykonuje pierwsze zapytania w aplikacji Development. LinkedIn, Instagram, Facebook i Telegram korzystają z tych samych tras czatu.
Endpointy używane przez agenta
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
API WhatsApp
Claude Code · crm-appAplikacja Development
Pozwól użytkownikom wysyłać e-maile ze strony kontaktu przez ich własną skrzynkę Gmail lub Outlook i grupuj odpowiedzi w wątku przy kontakcie.
Odczyt endpointuPOST /v2/{account_id}/emails/sendschemat wczytany
Wykonaj zapytanieGET /v2/{account_id}/emails200 OK
Dodano POST /contacts/:id/email wywołujący endpoint wysyłki na koncie skrzynki użytkownika, a także opcję odpowiedzi w wątku z użyciem ID wątku i synchronizację przychodzących wiadomości, która przypina odpowiedzi do kontaktu. Wysłano testowy e-mail ze skrzynki aplikacji Development, odpowiedź trafiła do wątku.4 zmienione pliki · wysyłka i wątki przetestowane od początku do końca

E-mail z własnej skrzynki użytkownika, w wątku w CRM

Gmail, Outlook i IMAP mają wspólny schemat e-maila. Agent podpina akcję wysyłki do skrzynki podłączonej przez użytkownika i zachowuje ID wątku, aby odpowiedzi trafiały do właściwego kontaktu.
Endpointy używane przez agenta
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
API e-mail
Claude Code · saas-backendAplikacja Development
Każdy workspace w moim SaaS ma kilku użytkowników z własnymi kontami LinkedIn i e-mail. Odizoluj ich: jeden Scope i jeden klucz przypisany do Scope na workspace.
Wyszukiwanie endpointów"scopes api-keys"4 wyniki
Wykonaj zapytaniePOST /v2/scopes/201 · scope
Przy tworzeniu workspace backend tworzy teraz Scope oraz klucz Account API przypisany do Scope, zapisany w postaci zaszyfrowanej przy workspace, a każde konto podłączone przez członka zespołu trafia do tego Scope. Wszystkie wywołania kont używają klucza workspace. Przetestowane na dwóch workspace'ach w aplikacji Development.5 zmienionych plików · izolacja sprawdzona

Wielu użytkowników, wiele kont, jedna granica na tenanta

Klucz z zakresem widzi tylko konta przypisane do jego Scope. Agent przekłada tę granicę na model tenantów, więc logika wielu kont żyje w API, a nie w kodzie.
Endpointy używane przez agenta
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
Konta, Scope'y i klucze
Najpierw aplikacja Development Claude Code dostaje klucz z zakresem z aplikacji Development, oddzielonej od Production.
Konta testowe, prawdziwe zapytania Agent wykonuje zapytania na kontach testowych, w imieniu uwierzytelnionego użytkownika, który je podłączył, w granicach limitów każdego dostawcy.
Sprawdź każdy przepływ Sprawdź przepływ połączenia, jeden odczyt i jeden zapis na funkcję oraz dostarczenie webhooka.
Potem przełączenie na Production Nic nie dotyka kont użytkowników, dopóki klucz nie zostanie przełączony. Zobacz bezpieczeństwo i zgodność.
Rozwiązywanie problemów

Częste błędy i ich znaczenie

Statusy, które wyświetlają claude mcp list i /mcp, gdy wpis jest nieprawidłowy, i poprawka dla każdego z nich.
✘ Failed to connect
Użyj dokładnie https://developer.unipile.com/mcp?branch=v2.0 wraz z --transport http, a potem sprawdź przez claude mcp get unipile.
⏸ Pending approval
Uruchom claude w folderze, zaakceptuj okno zaufania workspace, a potem zatwierdź serwer w /mcp.
401 przy żądaniach
Wyślij klucz Account API z zakresem z aplikacji Development, dokładnie pod nazwą nagłówka X-API-KEY.
Ostrzeżenie o brakującej zmiennej
Wyeksportuj UNIPILE_API_KEY w powłoce, która uruchamia Claude Code, lub ustaw wartość domyślną przez ${UNIPILE_API_KEY:-}.
Ukryte białe znaki w headers.X-API-KEY
Dodaj serwer ponownie z przyciętym kluczem: Claude Code używa wartości dokładnie w zapisanej postaci.
Ta sama nazwa w kilku zakresach
Zostaw jedną definicję, na przykład przez claude mcp remove unipile --scope user: local ma pierwszeństwo przed project, a ten przed user.
MCP endpoint not found at <origin>
Użyj pełnego URL https://developer.unipile.com/mcp?branch=v2.0, sprawdź go przez curl -I, a następnie uruchom claude mcp get unipile.
/mcp pokazuje No MCP servers configured
Używaj ~/.claude.json lub .mcp.json w katalogu głównym projektu, nigdy ~/.claude/mcp.json, a potem zrestartuj sesję.
Powłoka odrzuca URL albo brakuje parametru branch
URL zawsze trzeba ująć w cudzysłów w claude mcp add, inaczej zsh odpowie „no matches found”, a bash może pominąć parametr.
Wolny start lub timeout
Zwiększ limit dla sesji przez MCP_TIMEOUT=60000 claude.
6000+ Firmy, które wprowadzają innowacje z Unipile
Zaufali nam liderzy branży
1 API
Usprawnij obsługę wszystkich głównych kanałów komunikacji
2 dni
Szybkie uruchomienie integracji przy minimalnej konfiguracji
30%
Mniej pracy i zasobów na utrzymanie

Wbudowane bezpieczeństwo i zgodność

Ochrona klasy enterprise dla danych i procesów Więcej o naszym bezpieczeństwie
SOC 2 Type II
SOC 2 Type II
Certyfikat
Niezależnie audytowane mechanizmy bezpieczeństwa, które zapewniają ochronę danych i ciągłość działania.
GDPR
GDPR
Zgodność
Pełna zgodność z europejskimi przepisami o ochronie danych osobowych.
99.9%
Dostępności platformy w ciągu ostatnich 24 miesięcy
24/7
Globalne wsparcie i wydajne API

FAQ: serwer MCP w Claude Code

Pytania, które ludzie naprawdę wpisują: zakresy, gdzie leży konfiguracja, klucze poza repozytorium, własne nagłówki, Failed to connect, cudzysłów wokół URL, zmiany w .mcp.json i klucze API.
Local jest domyślny: zapisany w ~/.claude.json pod bieżącym projektem, prywatny i ograniczony do tego projektu. Project zapisuje .mcp.json w katalogu głównym repozytorium i jest współdzielony przez system kontroli wersji. User zapisuje w ~/.claude.json pod głównym kluczem mcpServers i obowiązuje we wszystkich projektach. Priorytet: local, potem project, potem user. Dla Unipile: --scope user dla osobistego klucza deweloperskiego, --scope project gdy cały zespół pracuje nad tą samą integracją.
W ~/.claude.json (w Windows %USERPROFILE%\.claude.json) dla zakresów local i user oraz w .mcp.json w katalogu głównym projektu dla zakresu project. Claude Code nie czyta ~/.claude/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json lub %APPDATA%\Claude\mcp.json. claude mcp get unipile pokazuje, w którym zakresie znajduje się wpis.
Claude Code rozwija ${VAR} i ${VAR:-default} w command, args, env, url i headers. Wystarczy wpisać "X-API-KEY": "${UNIPILE_API_KEY}" w .mcp.json, zacommitować plik, a każdy developer poda własny klucz przypisany do Scope przez swoje środowisko. Jeśli zmienna nie jest ustawiona i nie ma wartości domyślnej, konfiguracja i tak się wczyta, a claude mcp list pokaże ostrzeżenie.
Tak: --header "X-API-KEY: your-scoped-api-key", można powtórzyć dla kilku nagłówków, krótka forma -H. Należy ją umieścić po URL, bo flaga przyjmuje kilka wartości. Serwer Unipile to zdalny serwer HTTP: nic do instalowania lokalnie, bez npx, bez Node do utrzymywania.
Uruchom claude mcp get unipile i zobacz szczegóły (status HTTP i treść błędu), sprawdź ostrzeżenia o białych znakach na początku lub końcu, które claude mcp list wyświetla po wklejeniu klucza, i potwierdź, że URL odpowiada z lokalnej maszyny, poleceniem curl -I. 404 wyświetla MCP endpoint not found at <origin>: ścieżka jest błędna, pełny URL to https://developer.unipile.com/mcp?branch=v2.0, łącznie z parametrem branch.
URL zawiera znak ?, który zsh odczytuje jako znak wzorca. URL zawsze trzeba ująć w cudzysłów w claude mcp add. Bez cudzysłowu zsh odpowiada „no matches found”, a bash może pominąć parametr branch i połączyć z niewłaściwą wersją serwera.
Claude Code czyta .mcp.json przy starcie sesji: trzeba wyjść i uruchomić ponownie. Błędny wpis jest ignorowany bez komunikatu, a claude mcp list wyświetla ostrzeżenie parsowania z błędnym polem. Jeśli serwer został odrzucony w oknie zatwierdzania projektu, należy uruchomić claude mcp reset-project-choices.
Serwer odpowiada bez klucza, gdy agent tylko czyta specyfikację API. Aby wykonywać prawdziwe żądania, należy utworzyć Scope w aplikacji Development, przypisać do niego tylko potrzebne konta i wygenerować dla tego Scope klucz Account API. Klientowi MCP nigdy nie należy dawać klucza Service ani globalnego klucza Account.