MCP to standard gniazdka między Claude Desktop a Państwa narzędziami. Zamiast dziesięciu własnościowych integracji aplikacja i narzędzie rozmawiają tym samym protokołem – i podłączają Państwo pocztę, kalendarz czy system plików bezpośrednio, zamiast przez kopiuj-wklej.
Zrozumieć plik konfiguracyjny
Jeden jedyny plik decyduje o tym, jakie serwery zna Claude Desktop: claude_desktop_config.json. W macOS leży w ~/Library/Application Support/Claude, w Windows w %APPDATA%\Claude, w Linux w ~/.config/Claude.
Na każdy serwer jeden wpis z nazwą, poleceniem i argumentami. Opcjonalnie zmienne środowiskowe, opcjonalnie inny transport. Po każdej zmianie aplikację trzeba uruchomić ponownie w całości – w macOS zamknięcie okna nie wystarczy.
Przed włączeniem warto uruchomić JSON-Lint. Jeden brakujący przecinek sprawia, że znika cała lista serwerów.
Sześć serwerów, od których najczęściej zaczynam
Serwer systemu plików. Claude czyta i zapisuje w jasno wydzielonym folderze. Udostępniać wyłącznie jawnie wybraną ścieżkę.
Serwer GitHub lub GitLab. Kontekst repozytorium, pull requesty, zgłoszenia – dedykowane konto bota z minimalnymi uprawnieniami jest tu obowiązkowe.
Serwer Notion lub Confluence. Czytanie i uzupełnianie bazy wiedzy. Uprawnienia do stron trzeba wyjaśnić wcześniej, inaczej Claude nadpisze całe obszary.
Serwer Gmail lub Outlook. Przeszukiwanie skrzynki i zapisywanie wersji roboczych. Zaczynać w trybie tylko do odczytu, wysyłka dopiero wtedy, gdy reguły gry są ustalone.
Serwer Google Drive lub OneDrive. Streszczanie PDF-ów, odpytywanie tabel, porównywanie wersji. Nigdy nie udostępniać całego dysku.
Serwer JIRA lub Linear. Zgłoszenia jako kontekst. Preferować tokeny do odczytu, zapis tylko przy jasno określonych zadaniach.
Gdy ikona młotka pozostaje pusta
Cztery obrazy błędów odpowiadają w praktyce za 90 % przypadków.
Błąd składni JSON. Wystarczy zapomniany przecinek albo podwójny nawias. Przed zapisaniem wrzucić do lintera JSON.
Zła ścieżka do pliku wykonywalnego. Używać ścieżek bezwzględnych, nie względnych. W macOS i Linux sprawdzić prawa do wykonywania.
Brakujące zmienne środowiskowe. Tokeny i ścieżki należą do bloku env w konfiguracji serwera. Na profil powłoki aplikacja nie polega.
Serwer zawiesza się przy starcie. Sprawdzić w pliku logu, czy proces nie czeka na dane wejściowe. Częsta przyczyna: interaktywny przepływ OAuth, który trzeba jednorazowo przejść.