Jak skonfigurować serwer MCP? Prosty przewodnik po konfiguracji serwera MCP

Wyobraź sobie, że masz asystenta, który może czytać internet za Ciebie i wyciągać dokładnie te informacje, których potrzebujesz. Właśnie w tym pomaga Ci serwer MCP.

To jak link łączący sztuczną inteligencję z prawdziwymi narzędziami, takimi jak web scraper, dzięki czemu może ona działać na podstawie świeżych, rzeczywistych danych. Jeśli kiedykolwiek marzyłeś o tym, aby Twój chatbot po prostu otrzymywał to, co najlepsze, gdy prosisz o coś na żywo, skonfigurowanie serwera MCP to jedyny sposób, aby to osiągnąć.

W tym poście opowiemy Ci o wszystkim powoli i jasno, dzięki czemu będziesz w stanie uruchomić serwer Decodo MCP z Cursor, VS Code lub Claude Desktop. 

Dowiesz się również, dlaczego każdy krok jest ważny, pokażemy przykłady poleceń, które będziesz wpisywać, a także udzielimy przydatnych wskazówek, jak unikać typowych problemów, dzięki czemu poczujesz się pewniej. 

Staraliśmy się, aby proces konfiguracji serwera MCP był prosty, a do tego celu posłużono się prostym językiem i pomocnymi szczegółami (np. zrzutami ekranu).

Czym jest serwer MCP?

Serwer MCP, znany również jako Model Context Protocol Server, to typ serwera, który pomaga modelom AI lepiej rozumieć rzeczywiste sytuacje. Można go postrzegać jako pomost łączący AI z zewnętrznymi narzędziami i źródłami danych. 

Działa jak posłaniec między Sztuczna inteligencja i Twoje narzędziaSerwer komunikuje się z odpowiednim narzędziem, pobiera wynik i przesyła go z powrotem do sztucznej inteligencji.

Możesz również uruchomić serwer MCP lokalnie na swoim komputerze. Dla większości użytkowników jest to najlepszy sposób uruchomienia serwera, ponieważ jest prostszy i bezpieczniejszy, ponieważ Twoje prywatne dane logowania pozostają na Twoim komputerze.

Jak skonfigurować serwer MCP?

Zanim zaczniesz cokolwiek konfigurować, musisz sprawdzić kilka podstawowych rzeczy na swoim komputerze. 

Należy zainstalować Node.js w wersji 18 lub nowszej, ponieważ serwer MCP firmy Decodo działa na Node. 

Jeśli jeszcze nie masz zainstalowanego Node, przejdź do oficjalnej strony node.js Strona >> Pobierz instalator dla swojego systemu operacyjnego >> Uruchom! Większość instalacji jest prosta, a strona internetowa zawiera jasne instrukcje.

Będziesz także potrzebować edytora tekstu lub środowiska IDE (świetnym, darmowym wyborem będzie VS Code) oraz terminala lub wiersza poleceń, z którego będziesz się swobodnie korzystać.

Krok 1)

Przejdźmy teraz do pierwszego kroku!

• Najpierw zarejestruj się na Dekodować i przygotuj się na skopiowanie nazwy użytkownika i hasła do Web Scraping API; te dane uwierzytelniające pozwolą serwerowi MCP wykorzystać możliwości Web Scraping API w Twoim imieniu.

• Następnym krokiem jest uzyskanie danych uwierzytelniających API Decodo.
• Załóż konto Decodo i wybierz subskrypcję lub rozpocznij bezpłatny okres próbny, jeśli jest dostępny.
• Po zalogowaniu się do pulpitu nawigacyjnego Decodo znajdź sekcję zawierającą Twoje dane uwierzytelniające API i skopiuj nazwę użytkownika i hasło.

• Traktuj je jak sekret: Przechowuj je w menedżerze haseł lub umieść w bezpiecznym pliku lokalnym, do którego tylko Ty masz dostęp. Użyjesz tych wartości później, aby umożliwić serwerowi MCP uwierzytelnienie się w Decodo.

Jeśli dane wyciekną, ktoś inny będzie mógł wykorzystać Twoje konto.

Krok 2)

Następnie pobierz kod serwera Decodo MCP, aby móc go uruchomić lokalnie. Otwórz terminal i użyj Gita, aby sklonować repozytorium za pomocą:

• To polecenie kopiuje pliki projektu do nowego folderu na Twoim komputerze o nazwie decodo-mcp-server.

Jeśli nie masz zainstalowanego gita, możesz najpierw zainstalować gita lub pobrać plik ZIP repozytorium z GitHub i rozpakować go do folderu.

Krok 3)

Po sklonowaniu lub rozpakowaniu przejdź do tego folderu poleceniem cd decodo-mcp-server, aby polecenia terminala były uruchamiane we właściwym miejscu:

• Gdy kod znajduje się już na Twoim komputerze, kolejnym krokiem jest instalacja jego zależności i skompilowanie projektu, aby mógł zostać uruchomiony. Z poziomu serwer decodo-mcp katalogu, uruchom npm install, aby pobrać pakiety Node potrzebne serwerowi.

• Ten krok może zająć trochę czasu, w zależności od szybkości łącza internetowego. Po zakończeniu instalacji npm uruchom polecenie npm run build, aby skompilować projekt. Spowoduje to utworzenie folderu kompilacji zawierającego gotowy do uruchomienia kod serwera.

Załóżmy, że jeśli oba polecenia zgłoszą błąd, uważnie przeczytaj wynik w terminalu! Typowe problemy to brakujące wersje Node lub problemy z siecią podczas pobierania pakietów. 

Naprawa tych usterek zazwyczaj rozwiązuje problem.

• Po zakończeniu kompilacji znajdź główny plik serwera w folderze kompilacji.
• Zazwyczaj głównym plikiem jest index.js, który znajduje się w katalogu build/index.js. Pełną ścieżkę można sprawdzić, uruchamiając polecenie cd build, a następnie pwd (w systemie macOS/Linux) lub cd build, a następnie echo %cd% w systemie Windows.
• Skopiuj pełną ścieżkę do pliku w jakieś łatwo dostępne miejsce! Konfiguracja klienta MCP poprosi o nią.

Znajomość dokładnej ścieżki jest istotna, ponieważ błędna ścieżka jest bardzo częstą przyczyną niepowodzenia w uruchomieniu serwera MCP przez klientów.

Krok 4)

Teraz nadszedł czas na utworzenie konfiguracji, która poinformuje klienta, jak uruchomić serwer MCP. 

• Utworzysz plik taki jak mcp.json i dołączysz do niego mały blok JSON wskazujący na Node i plik index.js, który ustawia zmienne środowiskowe dla nazwy użytkownika i hasła Decodo.
• Plik nakazuje klientowi uruchomienie serwera lokalnie za pomocą polecenia, takiego jak node, i przekazanie ścieżki do index.js jako argumentu.
• Eksportuje również zmienne środowiskowe SCRAPER_API_USERNAME i SCRAPER_API_PASSWORD, dzięki czemu serwer MCP może automatycznie uwierzytelniać się w Decodo.

Jeśli planujesz używać VS Code i chcesz mieć zdalny MCP, możesz użyć Smithery do zarządzania zdalnymi instalacjami. 

• Smithery poprowadzi Cię przez proces logowania do GitHub, a następnie poprosi o podanie danych logowania do Decodo.

• Po skonfigurowaniu Smithery udostępnia adres URL połączenia zdalnego, z którego klienci obsługujący protokół HTTP mogą korzystać w celu łączenia się z serwerem MCP.

• Zawiera także polecenie CLI umożliwiające automatyczną instalację serwera Decodo MCP w profilu programu VS Code: polecenie wykorzystuje npx i wymaga nazwy profilu Smithery oraz klucza.

• Korzystając z Smithery, pozbywasz się niektórych czynności wykonywanych ręcznie i ułatwiasz zarządzanie zdalnymi konfiguracjami, ale jest to opcjonalne, jeśli wszystko uruchamiasz lokalnie.
• Jeśli wolisz wykonać czynności ręcznie, skonfiguruj Cursor, otwierając jego ustawienia, przechodząc do sekcji Narzędzia i integracje, a następnie tworząc nowy serwer MCP.
• Wklej utworzoną konfigurację JSON do pola mcp.json i zapisz.

• Uruchom ponownie Cursor, aby odczytał nową konfigurację.

Po uruchomieniu Cursora ikona stanu serwera MCP powinna zmienić kolor z czerwonego na zielony, jeśli wszystko jest w porządku. 

Jeśli nadal świeci na czerwono, sprawdź, czy polecenie, ścieżka argumentów do pliku index.js i zmienne środowiskowe są poprawne. Upewnij się również, że Node jest dostępny z poziomu ścieżki PATH, którą widzi Cursor. 

Czasami aplikacje uruchamiane z pulpitu nie korzystają z tej samej ścieżki PATH, co terminal.

• W przypadku aplikacji Claude Desktop otwórz aplikację Claude i przejdź do Ustawienia >> Deweloper >> Edytuj konfigurację.

• W pliku konfiguracyjnym dodaj lub zaktualizuj sekcję mcpServers, używając tego samego wpisu JSON, którego użyłeś w przypadku Cursor.

Jeśli nie możesz znaleźć tego interfejsu użytkownika, możesz bezpośrednio edytować plik claude_desktop_config.json: 

• Na macOS zwykle jest to ~/Biblioteka/Wsparcie aplikacji/Claude/claude_desktop_config.json
• W systemie Windows w %APPDATA%/Claude/claude_desktop_config.json
• Na Linuksie w ~/.config/Claude/claude_desktop_config.json.

Po zapisaniu zmian zamknij aplikację Claude (nie zamykaj tylko jej okna), a następnie otwórz ją ponownie, aby konfiguracja została ponownie załadowana.

Krok 5)

Po skonfigurowaniu serwera MCP należy go natychmiast przetestować, aby upewnić się, że wszystko działa. Prostym testem jest poproszenie sztucznej inteligencji o zeskanowanie publicznej, prostej strony, takiej jak https://news.ycombinator.com, i poproszenie o „najnowsze wiadomości technologiczne”. 

Jeśli serwer jest uruchomiony, sztuczna inteligencja powinna wywołać narzędzie scrape_as_markdown i zwrócić sformatowane wyniki. 

Obserwuj logi klienta lub dane wyjściowe terminala w poszukiwaniu przydatnych komunikatów debugowania: udane wywołania zwykle wyświetlają nazwę narzędzia i żądany adres URL, a w przypadku niepowodzeń pojawi się stos błędów, który poinformuje Cię, co poszło nie tak.

Podczas testów może zaistnieć konieczność zaakceptowania monitu o zezwolenie na korzystanie z narzędzia w kliencie. 

Wielu klientów prosi o potwierdzenie przy pierwszym kontakcie z MCP narzędzie Próbuje się uruchomić. To funkcja bezpieczeństwa zapobiegająca przypadkowym wywołaniom zewnętrznym. Podczas pierwszych kilku testów akceptuj każde żądanie ręcznie, aby zobaczyć, co się stanie.

Gdy już zatwierdzisz konfigurację, możesz włączyć automatyczne zatwierdzanie. Zachowaj jednak ostrożność, jeśli komputer jest współdzielony lub widoczny.

Jakie narzędzia udostępnia serwer Decodo MCP?

Decodo Serwer MCP udostępnia kilka wbudowanych narzędzi, które mogą okazać się przydatne. 

• Narzędzie scrape_as_markdown pobiera stronę internetową i zwraca jej główną zawartość w postaci czytelnie sformatowanego kodu Markdown.
• google_search_parsed uruchamia wyszukiwanie w Google i zwraca ustrukturyzowane wyniki, dzięki czemu sztuczna inteligencja może wybrać najbardziej trafny link lub fragment.
• amazon_search_parsed pomaga pobrać produkt dane z Amazon i zwraca informacje takie jak tytuły produktów, ceny i oceny w przejrzystym formacie.

Wiedza o tym, które narzędzie jest najlepsze do danego zadania, pomaga sztucznej inteligencji automatycznie wybierać właściwe narzędzie.

Dlaczego powinniśmy używać serwera MCP firmy Decodo?

Platforma MCP firmy Decodo to inteligentny pomocnik, który w potężny sposób łączy Twoją sztuczną inteligencję z siecią:

• Decodo jest znane z szybkich, bezpiecznych i niezawodnych narzędzi do scrapowania stron internetowych, a dzięki MCP możesz podłączyć te narzędzia bezpośrednio do swoich modeli AI. Oznacza to, że Twoja AI może połączyć się z internetem, zbierać rzeczywiste dane ze stron internetowych i natychmiast wykorzystywać je w odpowiedziach lub analizach.
• Dzięki platformie Decodo MCP możesz pozyskiwać informacje z niemal każdej strony internetowej, nawet tych, które korzystają z JavaScript lub dynamicznego ładowania. Jest to możliwe, ponieważ Decodo korzysta z ogromnej sieci ponad 125 milionów adresów IP w 195 krajach, automatycznie je zmieniając, aby pozostać niewykrytym.
• Konfiguracja działa w systemie macOS, Windows i Linuxi możesz dostosować sposób renderowania lub analizowania danych zależnie od swoich potrzeb.
• Co więcej, posiada wbudowaną obsługę błędów! Jeśli coś się nie powiedzie, automatycznie ponawia próbę, inteligentnie zarządza prędkością żądań i generuje szczegółowe raporty o błędach, dzięki czemu scrapowanie przebiega płynnie i wydajnie.

Wniosek

MCP firmy Decodo zmienia Twoją sztuczną inteligencję w potężną narzędzie do scrapowania stron internetowychPo skonfigurowaniu wystarczy wpisać polecenie, takie jak „Otrzymuj najnowsze wiadomości” lub „Pobierz dzisiejsze ceny kryptowalut”, a sztuczna inteligencja zrobi to automatycznie. 

Chociaż konfiguracja wymaga wykonania kilku czynności technicznych (takich jak instalacja Node.js i konfiguracja poświadczeń), efekt końcowy jest tego wart. 

Otrzymasz inteligentny, bezpieczny i niezawodny system, który może zbierać dane internetowe w czasie rzeczywistym, omijając ograniczenia i obsługując złożone witryny, a wszystko to za pośrednictwem prostego interfejsu czatu w Cursor, VS Code lub Claude Desktop.