Cursor · Serwer MCP
Serwer MCP dla Cursor: wiadomości i e-mail w IDE
Jeden URL i jeden nagłówek dodają serwer MCP Unipile do Cursor. Agent 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.
Cursor · 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 Cursor
Dodaj do produktu LinkedIn, WhatsApp, e-mail lub kalendarz. Przez serwer MCP Unipile Cursor czyta dokumentację API, pisze kod w używanym stacku i testuje każde zapytanie.
Podłącz serwer Unipile MCP do CursorUnipile 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
mcp.json, globalnie lub w projekcie
Dodaj serwer Unipile MCP do Cursor
Serwer jest zdalny: jeden URL przez streamable HTTP i jeden nagłówek, nic do uruchamiania lokalnie. Wybierz global lub project, wklej blok, zapisz, a Cursor go załaduje.
Przed startem: aktualny Cursor, aplikacja Development w dashboardzie Unipile z kluczem Account API z zakresem oraz jedno konto testowe podłączone przez Hosted Auth.
Konfiguracja globalna~/.cursor/mcp.json
Konfiguracja projektu.cursor/mcp.json (katalog główny repozytorium)
Klucz ze zmiennej środowiskowej${env:UNIPILE_API_KEY}
?
Globalnie czy w projekcie?Project, gdy każde repozytorium potrzebuje własnego klucza z zakresem. Cursor czyta najpierw project, potem 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}"
}
}
}
}
Zapisz plik, a Cursor załaduje serwer. ${env:NAME} działa w url i headers, więc klucz nigdy nie trafia do pliku.
Sprawdzenie połączenia
- 1Otwórz Customize na pasku bocznym: serwer unipile jest na liście i jest włączony.
- 2W Cursor CLI uruchom
agent mcp listlub/mcp listw sesji. - 3Na czacie zapytaj:
Korzystając z Unipile MCP, wypisz endpointy wyszukiwania osób na LinkedIn i ich wymagane parametryi oczekuj w odpowiedzi prawdziwych tras.
Opcjonalnie: instalacja jednym kliknięciem
Wklej klucz Account API z zakresem, aby otrzymać link, który otwiera Cursor z wstępnie wypełnionym serwerem. Klucz nigdy nie opuszcza przeglądarki.
Dodaj Unipile do Cursor
Prompty zamiast kodu klejącego
Prompt dla agenta
Trzy zadania integracyjne, a przy każdym prompt do wklejenia w Cursor, 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 LinkedIn do mojego ATS: synchronizuj inbox każdego rekrutera i pozwól mu odpowiadać ze strony kandydata.
Wyszukiwanie endpointów"chats messages send"3 wyniki
Wykonaj zapytanieGET /v2/{account_id}/chats12 czatów
Utworzono
linkedin/inbox-sync.ts (czaty i wiadomości zapisywane przy kandydacie metodą upsert, paginacja kursorem) oraz POST /candidates/:id/reply, który wywołuje endpoint wysyłki z ID konta, do którego należy czat. Synchronizacja uruchomiona w aplikacji Development: 12 czatów, 87 wiadomości.Wklej prompt, przejrzyj diff
Cursor czyta kontrakty czatów i wiadomości, pisze zadanie synchronizacji i endpoint odpowiedzi, a potem wykonuje pierwsze zapytania w aplikacji Development. WhatsApp, Instagram, Facebook i Telegram korzystają z tych samych tras czatu.
Endpointy używane przez agenta
Zbuduj integrację z LinkedIn
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Zaimplementuj Hosted Auth Unipile w tej aplikacji React i Fastify, aby użytkownicy podłączali własne konto LinkedIn z poziomu Ustawień.
Odczyt endpointuPOST /v2/auth/linkschemat wczytany
Wykonaj zapytaniePOST /v2/auth/link201 · link
Dodano
POST /api/accounts/connect w Fastify: tworzy link auth po stronie serwera i zwraca hostowany URL. Strona Settings w React otwiera go, a po powrocie zapisuje nowe account_id przy workspace. Sprawdzone w aplikacji Development z testowym kontem LinkedIn.Użytkownicy podłączają własne konta, aplikacja dostaje ID konta
Hosted Auth to strona udostępniana przez Unipile, na której użytkownicy sami podłączają swoje konta. Agent podpina link w backendzie, przekierowanie we frontendzie i zapis ID konta.
Endpointy używane przez agenta
Hosted Auth wdrożony przez agenta
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Zasubskrybuj webhooki nowych wiadomości i zbuduj ujednolicony inbox dla LinkedIn, WhatsApp i e-maila: jedna lista wątków z kanałem jako etykietą.
Odczyt endpointuPOST /v2/webhooks/endpoints/schemat wczytany
Wykonaj zapytanieGET /v2/{account_id}/emails200 OK
Zarejestrowano endpoint webhooka dla zdarzeń wiadomości w aplikacji Development, dodano
POST /webhooks/unipile zwracający od razu 200 i kolejkujący zdarzenie, model Thread mapujący czaty i wątki e-mail na jeden format oraz listę wątków z etykietami kanałów. Wysłano testową wiadomość: lista zaktualizowała się w mniej niż sekundę.Czas rzeczywisty bez odpytywania, jedna lista dla wiadomości i e-maili
Agent czyta kontrakty czatów i e-maili, projektuje jeden model wątków i pisze synchronizację oraz odbiornik webhooków. Następnie sprawdza log dostarczeń przez trasę konwersacji webhooków.
Endpointy używane przez agenta
Zbuduj ujednolicony inbox z agentem
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Najpierw aplikacja Development
Cursor 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
Komunikaty, które Cursor pokazuje, gdy wpis MCP jest nieprawidłowy, i poprawka dla każdego z nich.
No tools or prompts
Sprawdź edytowany plik (~/.cursor/mcp.json lub .cursor/mcp.json), usuń końcowy przecinek, a potem przeładuj serwer z Customize.
No server info found
Użyj zdalnego wpisu z url ustawionym dokładnie na https://developer.unipile.com/mcp?branch=v2.0 i headers, bez command lub type: "stdio".
Connection failed
Sprawdź host i ?branch=v2.0 pod kątem literówki albo sprawdź firmowe proxy: URL musi odpowiadać w przeglądarce, a nie zwracać 404.
401 Unauthorized przy żądaniach
Wyślij klucz Account API z zakresem z aplikacji Development w headers, dokładnie pod nazwą X-API-KEY.
Konfiguracja projektu jest ignorowana
Umieść .cursor/mcp.json w katalogu głównym folderu otwartego w Cursor, a nie w podfolderze.
Gdzie czytać logi
Otwórz panel Output (Cmd+Shift+U na macOS, Ctrl+Shift+U na Windows i Linux) i wybierz MCP Logs z listy rozwijanej.
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 Cursor
Pytania, które ludzie naprawdę wpisują: gdzie leży mcp.json, globalnie czy w projekcie, zdalne serwery i nagłówki, co sprawdzić, gdy nic się nie pojawia, klucze, instalacja jednym kliknięciem i CLI.
W dwóch miejscach.
~/.cursor/mcp.json w folderze domowym to konfiguracja globalna, dostępna w każdym projekcie. .cursor/mcp.json w katalogu głównym folderu otwartego w Cursor to konfiguracja projektu. Cursor czyta najpierw plik projektu, potem globalny, a potem katalogi nadrzędne. Oba pliki zawierają blok mcpServers o tej samej strukturze.Globalnie, gdy buduje się kilka integracji Unipile na jednej maszynie i z jedną aplikacją Development. Per projekt, gdy każde repozytorium potrzebuje własnego klucza przypisanego do Scope, co jest właściwym wyborem, gdy integracje Development i Production żyją w różnych repozytoriach. W obu przypadkach klucz to klucz Account API przypisany do Scope, nigdy klucz Service ani globalny.
Tak. Zdalny wpis w
mcp.json przyjmuje pole url oraz obiekt headers i Cursor rozwija w obu zmienne ${env:NAME} bez dodatkowej konfiguracji. Serwer Unipile to dokładnie taki przypadek: streamable HTTP pod adresem https://developer.unipile.com/mcp?branch=v2.0 i nagłówek X-API-KEY do uwierzytelnienia. Bez npx, bez lokalnego procesu, bez wersji Node do utrzymywania.W tej kolejności: edytowany plik (globalny lub projektowy, w katalogu głównym repozytorium), poprawność JSON-a, przeładowanie serwera w Customize lub restart Cursor, a potem MCP Logs w panelu Output (Cmd+Shift+U, wybierz MCP Logs). Jeśli serwer się łączy, ale żądania kończą się błędem 401, w nagłówku brakuje klucza albo nie jest to klucz Account API przypisany do Scope.
Serwer odpowiada bez klucza, gdy agent tylko czyta specyfikację API. Aby wykonywać prawdziwe żądania, należy utworzyć Scope w aplikacji Development, przypisać konta testowe i wygenerować dla tego Scope klucz Account API. Klientowi MCP nigdy nie należy dawać klucza Service ani globalnego klucza Account.
Tak. Link instalacyjny na tej stronie koduje konfigurację serwera; otwiera Cursor z wstępnie wypełnionym wpisem unipile, a placeholder zastępuje się własnym kluczem przypisanym do Scope. Opcjonalny generator powyżej buduje ten sam link z kluczem już w środku, w całości w przeglądarce.
Tak. CLI współdzieli konfigurację edytora: najpierw projekt, potem globalna.
agent mcp list pokazuje skonfigurowane serwery i ich stan, a /mcp list robi to samo w sesji interaktywnej. Agent korzysta potem z serwera Unipile, gdy wymaga tego zadanie.