Gemini CLI · Serwer MCP
Serwer MCP dla Gemini CLI: wiadomości, e-mail i kalendarz
Jedno polecenie gemini mcp add łączy serwer MCP Unipile. Agent buduje potem w projekcie funkcje LinkedIn, WhatsApp, e-mail i kalendarza oraz testuje każde wywołanie w aplikacji Development. Nic do instalowania ani uruchamiania lokalnie.
7 dni za darmo, bez karty kredytowej.
Gemini CLI · booking-app
Unipile MCP połączony
Dodaj planowanie w kalendarzu do mojej aplikacji rezerwacyjnej.
Odczyt endpointuGET /v2/{account_id}/calendarsschemat wczytany
Dodano endpoint dostępności i endpoint rezerwacji. Wydarzenia trafiają do kalendarza podłączonego przez użytkownika.
Opisz kolejną funkcję…
Przypadek użycia
LinkedIn, WhatsApp i e-mail w Państwa produkcie, prosto z Gemini CLI
Dodaj do produktu LinkedIn, WhatsApp, e-mail lub kalendarz. Przez serwer MCP Unipile Gemini CLI czyta dokumentację API, pisze kod w używanym stacku i testuje każde zapytanie.
Podłącz serwer Unipile MCP do Gemini CLIUnipile 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
settings.json, użytkownik lub projekt
Dodaj serwer Unipile MCP do Gemini CLI
Serwer jest zdalny: jeden URL przez streamable HTTP i jeden nagłówek, nic do uruchamiania lokalnie. Jedno polecenie zapisuje go w settings.json, user lub project, a Gemini CLI łączy się przy starcie.
Przed startem: zalogowany Gemini CLI w zaufanym folderze, aplikacja Development w dashboardzie Unipile z kluczem Account API z zakresem oraz jedno konto testowe podłączone przez Hosted Auth.
gemini mcp add, jedna liniazapisuje settings.json automatycznie
Ustawienia użytkownika~/.gemini/settings.json
Ustawienia projektu.gemini/settings.json (zakres domyślny)
Klucz ze zmiennej środowiskowej$UNIPILE_API_KEY w headers
?
Użytkownik czy projekt?Polecenie domyślnie używa zakresu project (.gemini/settings.json). Dodaj --scope user, aby objąć wszystkie projekty na maszynie.
# Zarejestruj hostowany serwer Unipile MCP dla wszystkich projektów (zakres user)
gemini mcp add --transport http --scope user \
--header "X-API-KEY: your-scoped-api-key" \
unipile "https://developer.unipile.com/mcp?branch=v2.0"
# MCP server "unipile" added to user settings. (http)
# Weryfikacja, albo wpisz /mcp w sesji
gemini mcp list
# ✓ unipile: https://developer.unipile.com/mcp?branch=v2.0 (http) - Connected
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"type": "http",
"headers": { "X-API-KEY": "your-scoped-api-key" }
}
}
}
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"type": "http",
"headers": { "X-API-KEY": "$UNIPILE_API_KEY" }
}
}
}
// Commitowany z repozytorium: klucz trzymaj w środowisku, nie w pliku.
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"type": "http",
"headers": { "X-API-KEY": "${{UNIPILE_API_KEY}}" }
}
}
}
// export UNIPILE_API_KEY=your-scoped-api-key przed uruchomieniem gemini
Zapisz plik i uruchom gemini w zaufanym folderze. Sprawdzone na gemini-cli 0.60.0.
httpUrl czy url. Wpisz
httpUrl lub url z "type": "http": sam url jest odczytywany jako SSE i pokazuje Disconnected. Trzymaj klucz w $UNIPILE_API_KEY i nie ustawiaj opcji trust serwera, aby Gemini CLI nadal potwierdzał każdą akcję.Sprawdzenie połączenia
- 1W terminalu
gemini mcp listpokazuje unipile jako Connected; Disabled oznacza, że folder nie jest zaufany. - 2W sesji
/mcpwyświetla każdy serwer z jego stanem, a/mcp descopisuje każdą akcję. - 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 Gemini CLI, endpointy wywoływane przez agenta na
https://api.unipile.com z nagłówkiem X-API-KEY oraz to, co trafia do projektu.Dodaj planowanie w kalendarzu do mojej aplikacji rezerwacyjnej: odczytuj dostępność każdego użytkownika w ciągu tygodnia i twórz spotkanie w kalendarzu, który podłączył, Google lub Outlook.
Odczyt endpointuGET /v2/{account_id}/calendars/{calendar_id}/eventsschemat wczytany
Wykonaj zapytaniePOST /v2/{account_id}/calendars/{calendar_id}/events201 Created
Dodano
GET /api/availability (wydarzenia w żądanym przedziale, zajęte terminy liczone po stronie serwera) oraz POST /api/bookings, który tworzy wydarzenie z uczestnikami w kalendarzu użytkownika i zapisuje zwrócone ID wydarzenia. Strefy czasowe pochodzą z kalendarza. Utworzono testowe wydarzenie w aplikacji Development.Dostępność i tworzenie wydarzeń w kalendarzu podłączonym przez użytkownika
Google Calendar i Outlook Calendar korzystają z tych samych tras kalendarza. Gemini CLI czyta schematy kalendarza, wydarzenia i uczestników, pisze logikę dostępności i trasę rezerwacji, a potem tworzy jedno wydarzenie w kalendarzu testowym.
Endpointy używane przez agenta
Wszystkie kanały na serwerze Unipile MCP
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
Nasz inbox już synchronizuje LinkedIn i WhatsApp przez Unipile. Dodaj Instagram i Telegram z tym samym modelem wątków i tym samym endpointem odpowiedzi.
Wyszukiwanie endpointów"chats messages attendees"3 wyniki
Wykonaj zapytanieGET /v2/{account_id}/chats200 OK
Bez nowego modelu: czaty z Instagram i Telegram przychodzą tymi samymi endpointami czatów i wiadomości, więc zadanie synchronizacji iteruje teraz po wszystkich podłączonych kontach niezależnie od dostawcy, a endpoint odpowiedzi wysyła z konta, do którego należy czat. Dodano dwie etykiety dostawców i uruchomiono synchronizację w aplikacji Development z jednym testowym kontem Instagram i jednym Telegram.
Te same endpointy, dwa kolejne kanały, bez nowego modelu
Każdy dostawca komunikatorów używa tych samych tras czatu, więc rozszerzenie inboxu oznacza podłączenie kont przez Hosted Auth. Agent sprawdza pola specyficzne dla dostawcy i nie zmienia modelu wątków.
Endpointy używane przez agenta
Zbuduj ujednolicony inbox z agentem
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Przejrzyj moją obecną integrację Unipile pod kątem błędnych ID, niebezpiecznych ponowień i wywołań, które powinny być webhookami, i zaproponuj poprawki.
Odczyt endpointuPOST /v2/{account_id}/chats/{chat_id}/messages/sendschemat wczytany
Odczyt endpointuPOST /v2/webhooks/endpoints/schemat wczytany
Znaleziono trzy problemy: wywołanie wysyłki używało pierwszego konta workspace zamiast konta czatu; wrapper ponowień wysyłał wiadomości ponownie po timeoucie; inbox odpytywał endpoint czatów co 30 sekund. Zaproponowane poprawki: ID konta brane z czatu, ponowienia ograniczone do odczytów, endpoint webhooka dla zdarzeń wiadomości. Zastosowano i sprawdzono w aplikacji Development.
Audyt względem prawdziwego kontraktu, a nie pamięci
Agent porównuje kod z prawdziwymi schematami zapytań i odpowiedzi: pola kont, wywołania idempotentne, pętle odpytywania do zastąpienia webhookami. Przegląd trafia jako diff, przetestowany w aplikacji Development.
Endpointy używane przez agenta
Webhooki podłączone przez agenta
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Najpierw aplikacja Development
Gemini CLI 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
Co pokazują gemini mcp list i /mcp, gdy wpis jest nieprawidłowy, i poprawka dla każdego przypadku.
No MCP servers configured.
Umieść mcpServers na najwyższym poziomie ~/.gemini/settings.json lub .gemini/settings.json, bez końcowego przecinka.
Disconnected
Używaj httpUrl lub url wraz z "type": "http", bo sam url jest odczytywany jako SSE.
Disabled, niezaufany folder
Zaakceptuj pytanie o zaufanie przy pierwszym uruchomieniu lub uruchom gemini trust w projekcie.
Dodany w złym miejscu
Dodaj --scope user do gemini mcp add, które domyślnie zapisuje do pliku projektu .gemini/settings.json.
401 Unauthorized przy żądaniach
Connected nie sprawdza klucza: wyeksportuj zmienną wskazaną w headers i użyj klucza Account API z zakresem.
Przekroczony czas
Sprawdź sieć, ewentualne proxy i URL, zanim ustawisz timeout we wpisie.
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 Gemini CLI
Pytania, które ludzie naprawdę wpisują: httpUrl czy url, gdzie leży settings.json, jedno polecenie zamiast JSON-a, klucz poza plikiem, Disconnected, No MCP servers configured, rozszerzenie VS Code i klucze.
Dokumentacja definiuje
httpUrl jako endpoint streamable HTTP, a url jako endpoint SSE. Polecenie gemini mcp add --transport http zapisuje url razem z "type": "http", i obie formy łączą się w aktualnych wersjach. Przy ręcznym pisaniu pliku należy użyć httpUrl: samo url bez typu jest odczytywane jako SSE, co jest najczęściej wskazywaną przyczyną statusu Disconnected.Ustawienia użytkownika w
~/.gemini/settings.json, ustawienia projektu w .gemini/settings.json w katalogu głównym projektu, oba pod kluczem mcpServers i ustawienia projektu nadpisują ustawienia użytkownika. Uwaga na domyślne zachowanie polecenia: gemini mcp add zapisuje do zakresu project, chyba że poda się --scope user.Tak, i to zalecana droga:
gemini mcp add --transport http --scope user --header "X-API-KEY: your-scoped-api-key" unipile "https://developer.unipile.com/mcp?branch=v2.0". Flaga --header może się powtarzać i stać w dowolnym miejscu polecenia. Sprawdzone na gemini-cli 0.60.0.Wartość nagłówka należy zapisać jako
"$UNIPILE_API_KEY" lub "${UNIPILE_API_KEY}". Gemini CLI rozwija zmienne środowiskowe w settings.json, także w nagłówkach, więc plik projektu można zacommitować bez sekretu, a każdy developer eksportuje własny klucz Account API przypisany do Scope przed uruchomieniem gemini.Po kolei: klucz transportu (
httpUrl dla streamable HTTP albo url wraz z "type": "http"), plik settings.json projektu, który nadpisuje ustawienia użytkownika lub odwrotnie, zaufanie folderu (niezaufany folder wyłącza wszystkie serwery), a na końcu status Disconnected przy działających akcjach, który wynika z opcjonalnego pinga w specyfikacji. Uruchom gemini mcp list, a potem /mcp w sesji.Gemini CLI nie znajduje wpisu
mcpServers w konfiguracji, którą czyta z bieżącego folderu. Sprawdź, czy plik jest w ~/.gemini/ lub w .gemini/ w katalogu głównym projektu, czy mcpServers jest na najwyższym poziomie JSON-a i czy JSON jest poprawny: wystarczy przecinek na końcu, by plik został zignorowany.Ta strona dotyczy Gemini CLI w terminalu, a opisana konfiguracja to settings.json czytany przez CLI. Rozszerzenie ma własne ustawienia MCP w VS Code; przed założeniem, że plik jest współdzielony, warto sprawdzić jego dokumentację.
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.