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
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.
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łączenia
developer.unipile.com/mcpPodłącz wszystkie kanały10 kanałów
↑↓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.
Zakres user--scope user · każdy projekt, tylko dla Państwa
Zakres project.mcp.json w katalogu głównym repozytorium, współdzielony
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.
# 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
- 1W terminalu
claude mcp listpokazuje ✔ Connected, aclaude mcp get unipileszczegóły. - 2W sesji
/mcppokazuje stan i za pierwszym razem zatwierdza .mcp.json w zakresie project. - 3Na czacie zapytaj:
Korzystając z Unipile MCP, wypisz endpointy wyszukiwania osób na LinkedIn i ich wymagane parametryi 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.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.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
API WhatsApp
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
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.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
API e-mail
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
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.
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
Konta, Scope'y i klucze
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
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
Certyfikat
Niezależnie audytowane mechanizmy bezpieczeństwa, które zapewniają ochronę danych i ciągłość działania.
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.