Jak połączyć serwer MCP Vereel z Claude, Cursorem i innymi agentami AI

Co dostajesz

MCP (Model Context Protocol) pozwala asystentowi AI korzystać z narzędzi spoza czatu. Serwer MCP Vereel to taki zestaw narzędzi: mały program o otwartym kodzie (Apache-2.0), który działa na Twoim komputerze, uruchamia się razem z asystentem i rozmawia z publicznym API Vereel z użyciem Twojego tokenu. Ma 8 narzędzi:

• vereel_list_categories: pokazuje kategorie, pod którymi są oferty
• vereel_search_offers: wyszukuje publiczne oferty według słów, kategorii, typu, platformy i języka
• vereel_get_offer: pokazuje jedną publiczną ofertę z tym, co widać na jej stronie
• vereel_list_my_offers: wyświetla Twoje oferty i etap, na którym jest każda
• vereel_get_my_offer: pokazuje jedną z Twoich ofert w całości, z tym, czego jeszcze brakuje, i uwagą weryfikującego
• vereel_create_offer: tworzy ofertę, która potem czeka na weryfikację
• vereel_update_offer: zmienia ofertę, gdy jest w weryfikacji
• vereel_add_offer_image: dodaje zdjęcie z linku albo z pliku na Twoim komputerze

Czego potrzebujesz

Trzech rzeczy, bez programowania:

• Node.js 20 lub nowszego. Asystent uruchamia serwer przez npx, który jest częścią Node.js. Sprawdź poleceniem node --version.
• Do czegokolwiek poza wyszukiwaniem: konta marki w Vereel i tokenu do odczytu i zapisu z Ustawienia › Tokeny API. Pokazujemy go tylko raz, więc skopiuj go od razu.
• Aplikacji, która potrafi uruchamiać serwery MCP. Poniżej opisujemy Claude Desktop, Claude Code i Cursora.

Claude Desktop

Otwórz Settings w Claude Desktop, wybierz Developer, a potem Edit Config. Otworzy się plik claude_desktop_config.json. Dodaj ten blok, zastępując YOUR_TOKEN swoim tokenem. Jeśli plik ma już sekcję mcpServers, dodaj wpis vereel do niej. Zapisz plik i uruchom Claude Desktop ponownie.

W Windows, jeśli Claude nie potrafi uruchomić npx, ustaw "command" na "cmd", a "args" na ["/c", "npx", "-y", "github:hans100x-dotcom/vereel-mcp"].

{
  "mcpServers": {
    "vereel": {
      "command": "npx",
      "args": [
        "-y",
        "github:hans100x-dotcom/vereel-mcp"
      ],
      "env": {
        "VEREEL_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Claude Code

W Claude Code serwer dodaje jedno polecenie. Uruchom je w terminalu, zastępując YOUR_TOKEN:

claude mcp add vereel --env VEREEL_API_TOKEN=YOUR_TOKEN -- npx -y github:hans100x-dotcom/vereel-mcp

Cursor i inne aplikacje

Cursor przyjmuje ten sam blok co Claude Desktop, w pliku .cursor/mcp.json w projekcie albo w ustawieniach MCP. Każda inna aplikacja, która potrafi uruchomić serwer MCP poleceniem, potrzebuje tych samych trzech rzeczy: polecenia npx, argumentów -y github:hans100x-dotcom/vereel-mcp i zmiennej środowiskowej VEREEL_API_TOKEN.

Ustawienia, które warto znać

Serwer czyta ustawienia ze zmiennych środowiskowych, które w powyższym bloku są w polu env.

• VEREEL_API_TOKEN: Twój token. Bez niego serwer tylko wyszukuje publiczne oferty.
• VEREEL_READ_ONLY=1: ukrywa narzędzia, które tworzą lub zmieniają oferty. Użyj, gdy chcesz, żeby asystent tylko patrzył.
• VEREEL_IMAGE_DIRS: foldery, z których asystent może wgrywać zdjęcia, na przykład folder ze zdjęciami do kampanii. Ustaw je: inaczej asystent może dostać polecenie wgrania dowolnego obrazu z Twojego komputera. Kilka folderów rozdziel znakiem ; w Windows i znakiem : w pozostałych systemach.

Sprawdź, czy działa

Uruchom aplikację ponownie i zapytaj: „Pokaż mi kategorie Vereel”. Jeśli wróci lista kategorii, serwer jest podłączony. Jeśli w konfiguracji jest token, spróbuj: „Które z moich ofert w Vereel czekają na weryfikację?”

Jeśli coś jest nie tak, asystent powie, co i co zrobić. Najczęstsze przypadki:

• Publiczne API Vereel jest wyłączone: Vereel może je wyłączyć w każdej chwili. Do czasu włączenia nic nie da się odczytać ani zmienić, więc spróbuj później.
• Token jest nieprawidłowy, wygasł albo został unieważniony: utwórz nowy w Ustawieniach › Tokeny API i wpisz go do konfiguracji.
• Token może tylko odczytywać: utwórz token do odczytu i zapisu.
• Brak narzędzi Vereel w aplikacji: sprawdź, czy node --version pokazuje 20 lub więcej, czy konfiguracja jest poprawnym JSON-em, i uruchom aplikację ponownie.

Dbaj o token

Token leży w pliku konfiguracji na Twoim komputerze i to jest właściwe miejsce. Nie wklejaj go do czatów, repozytoriów ani zrzutów ekranu, daj mu tylko potrzebny dostęp i unieważnij w Ustawieniach › Tokeny API, jeśli kiedykolwiek wycieknie. Przejdziemy przez to w artykule o bezpiecznym przechowywaniu tokenu API Vereel.