Jak zainstalować MCP w Voicie (na przykładzie Gmaila)

Przewodnik krok po kroku jak podłączyć MCP do agenta Voicie Desktop. Na przykładzie Gmail MCP: klient OAuth w Google Cloud, pobranie paczki, autoryzacja i rozwiązywanie problemów.

MCP to połączenie, które daje agentowi Voicie dostęp do Twoich narzędzi — skrzynki, bazy danych, systemu do zadań. Inaczej niż skill, nie jest plikiem z instrukcją; to mała paczka, którą podłączasz raz, a potem konfigurujesz przez okno w aplikacji.

Pokażę to na Voicie Gmail MCP, bo to pierwszy gotowy MCP i konkretny przykład. Inne MCP instaluje się tym samym schematem — różni się tylko to, jakie poświadczenia wpisujesz.

Nie wiesz, czym właściwie jest MCP i czym różni się od skilla? Zacznij od tego, czym jest MCP, a potem wróć tutaj po instalację.

Czego potrzebujesz

Zainstalowana aplikacja Voicie Desktop
Konto Google, którego Gmaila chcesz używać
Około 10 minut na jednorazowe ustawienie klienta Google Cloud OAuth

Część 1. Klient OAuth w Google Cloud Console (raz, ~10 min)

To jednorazowa robota. Tworzysz własny klucz do Google, żeby agent łączył się z Twoją skrzynką na Twoich poświadczeniach, nie na żadnym koncie Voicie.

1. Utwórz projekt

Wejdź do Google Cloud Console i utwórz nowy projekt albo wybierz istniejący.

2. Włącz Gmail API

Przejdź do APIs & Services → Library, wyszukaj „Gmail API” i kliknij Enable.

W OAuth consent screen wybierz User type External, uzupełnij nazwę aplikacji i adresy e-mail, a w sekcji Test users dodaj swój własny adres.

Ważne: dopóki aplikacja siedzi w trybie Testing, Google wygasza refresh token co 7 dni — i będziesz musiał logować się od nowa co tydzień. Kliknij Publish app (Production), żeby tego uniknąć. Do własnego, jednokontowego użytku działa nawet jako „unverified”, więc weryfikacja Google nie jest tu potrzebna.

4. Utwórz klienta OAuth

W Credentials kliknij Create credentials → OAuth client ID i wybierz typ Desktop app. Dostajesz Client ID i Client secret — te dwie wartości wpiszesz za chwilę w Voicie.

Część 2. Pobierz i wrzuć MCP

5. Pobierz paczkę

Ze strony Releases repozytorium pobierz tarball gmail-mcp-v<wersja>.tar.gz.

6. Otwórz folder MCP

W Voicie wejdź w Settings → MCPs → Open MCPs folder. Na macOS otworzy się katalog:

~/Library/Application Support/com.voicie.desktop/mcps/

7. Rozpakuj do tego folderu

Tarball owija już folder gmail-mcp/, więc po prostu rozpakuj go do katalogu MCP:

tar -xzf ~/Downloads/gmail-mcp-v<wersja>.tar.gz \
  -C ~/Library/Application\ Support/com.voicie.desktop/mcps/

Albo przeciągnij rozpakowany folder w Finderze. Efekt ma być taki, że w folderze MCP leży katalog gmail-mcp/.

Część 3. Połącz w Voicie (bez edycji plików)

8. Odśwież listę

Zrestartuj Voicie albo poczekaj, aż file watcher sam wykryje nowy folder. Karta Gmail pojawi się w Settings → MCPs.

9. Wpisz poświadczenia

Na karcie Gmail kliknij Configure i wpisz Gmail OAuth client ID oraz Gmail OAuth client secret z kroku 4. Wpisujesz je w okno aplikacji — żadnej edycji plików.

10. Autoryzuj

Kliknij Connect / Authorize. Otworzy się ekran zgody Google — wybierz konto i przyznaj dostęp. Status karty przejdzie ścieżkę Needs config → Needs auth → Active.

11. Używaj

Otwórz czat i poproś agenta:

pokaż moje ostatnie 5 maili

Działa? Gotowe. Skrzynka jest teraz w zasięgu agenta.

Rozwiązywanie problemów

Problem	Co zrobić
„Access blocked: app not verified”	Kliknij Advanced → Go to <app> (unsafe) albo dodaj swój e-mail w Test users
Musisz logować się co ~7 dni	Aplikacja siedzi w trybie Testing — opublikuj ją na Production
`GMAIL_AUTH_EXPIRED`	Autoryzuj ponownie: Configure → Authorize
`GMAIL_INSUFFICIENT_SCOPE`	Token nie ma uprawnień modify/send — autoryzuj ponownie z odczytem i zapisem
`GMAIL_RATE_LIMIT_SPAWN`	Trafiłeś w limit 100 wywołań na sesję — zrestartuj Voicie
Karta utknęła na Needs config	Wpisz oba pola: Client ID i Client secret

A inne MCP?

Schemat jest ten sam: pobierz paczkę, wrzuć do folderu MCP, otwórz Configure na karcie i wpisz poświadczenia, autoryzuj. Zmienia się tylko to, jakie wartości wklejasz — bo każde narzędzie ma własny sposób logowania. Konkretne kroki znajdziesz na stronie danego MCP w katalogu.

Chcesz szerszy obraz tego, czym jest MCP i kiedy go użyć? Przeczytaj Czym jest MCP?. Po szczegóły premiery zajrzyj do Przedstawiamy MCP w Voicie.

Pytania? voicie.com/kontakt

Autor Voicie