Vinotify i MCP: alerty Vinted w narzędziach AI

← Wróć do bloga

3 września 2026

Vinotify udostępnia bezpośredni serwer MCP w trybie Streamable HTTP, który przenosi Twoje alerty Vinted do zgodnych narzędzi AI. Korzysta z tokenu bearer i wyraźnie oddziela Twoje konto Vinotify od asystenta.

Serwer udostępnia narzędzia odczytu do wykrywania wyszukiwań i odczytywania nowych pasujących ogłoszeń. Token jest domyślnie tylko do odczytu; jeśli wyraźnie utworzysz token z zakresem zapisu, a narzędzia zapisu są włączone, może on także tworzyć, aktualizować, wstrzymywać, wznawiać lub usuwać wyszukiwania. Sekret umieść w lokalnej konfiguracji swojego klienta MCP, a nie w czacie AI.

Co potrafi serwer MCP Vinotify

Za pomocą tokenu integracji Pro bezpośredni serwer umożliwia:

  • Wykrywanie aktywnych wyszukiwań za pomocą list_searches i odczytywanie nowych przedmiotów przez get_new_items lub whats_new.
  • Odczytywanie pasujących ogłoszeń z linkami, cenami, rynkami, walutami i dostępnymi szczegółami.
  • Wznawianie każdego strumienia zdarzeń od zapisanego kursora; zdarzenia są dostarczane co najmniej raz, więc klienci powinni usuwać duplikaty identyfikatorów zdarzeń.
  • Ograniczenie tokenu do wszystkich wyszukiwań, które Twoje konto ma teraz, oraz tych, które utworzysz później; klienci mogą odświeżać wykrywanie, aby uwzględniać zmiany w aktywnych wyszukiwaniach.

Prosty sposób, by to zrozumieć

  1. Tworzysz wyszukiwania i zarządzasz nimi w Vinotify; tokeny są powiązane z kontem i nie wybiera się ich dla pojedynczych wyszukiwań.
  2. Tworzysz token integracji. Domyślnie jest tylko do odczytu; w razie potrzeby wyraźnie zezwalasz na zapis, a narzędzia zapisu nadal wymagają włączonej opcji po stronie serwera.
  3. Umieszczasz token w lokalnej konfiguracji klienta, w nagłówku Authorization: Bearer, dla https://vinotify.me/api/v1/mcp. Instrukcje konfiguracji bez tokenu możesz przekazać asystentowi, ale sekretu nie należy wklejać do czatu.
  4. Asystent korzysta z dostępnych narzędzi MCP, aby odczytywać dopasowania lub, gdy jest to włączone, tworzyć, aktualizować, wstrzymywać, wznawiać albo usuwać wyszukiwania; Ty zachowujesz kontrolę.

Domyślnie tylko do odczytu, z wąskim, opcjonalnym zakresem zapisu

Standardowy token może używać tylko narzędzi odczytu. Opcjonalny token z zakresem zapisu może używać create_search, update_search, pause_search, resume_search i delete_search, gdy narzędzia zapisu są włączone, a zasady planu Vinotify na to pozwalają. Żaden token nie może:

  • Kasować historii przedmiotów wyszukiwania. Usunięte wyszukiwanie zatrzymuje się od razu, ale jego dotychczasowe dopasowania zostają zachowane.
  • Zmieniać Twojej subskrypcji, otwierać danych rozliczeniowych ani płatniczych, ani dokonywać zakupów.
  • Odczytywać Twojego profilu ani logować się jako Ty.
  • Kupować przedmiotu przez Vinotify ani sterować Twoim kontem Vinted.

Operacje zapisu nadal podlegają istniejącym zasadom wyszukiwania, limitom planu, interwałom, ograniczeniom rynków i limitom częstotliwości Vinotify. Token nigdy nie rozszerza własności konta: może działać tylko na wyszukiwaniach należących do jego konta.

Przydatne sposoby wykorzystania danych z alertów

  • Poproś o krótką listę dopasowań poniżej docelowej ceny.
  • Porównaj ostatnie ogłoszenia z aktywnych wyszukiwań lub z różnych rynków Vinted.
  • Podsumuj whats_new i wyróżnij tylko przedmioty zgodne z Twoimi priorytetami.
  • Gdy zakres zapisu jest świadomie włączony, poproś asystenta o utworzenie, aktualizację, wstrzymanie lub wznowienie wyszukiwania zgodnie z zasadami Vinotify.

Zbudowane z myślą o małej powierzchni ataku

  • Serwer MCP jest dostępny dla kont Pro, a tokeny bearer są przy każdym żądaniu sprawdzane względem wyszukiwań należących do konta.
  • Pełny token jest pokazywany raz. Vinotify przechowuje tylko nieodwracalny skrót, więc nie może później ujawnić oryginalnego tokenu.
  • Tokeny obejmują wszystkie bieżące i przyszłe wyszukiwania tego samego konta. Domyślnie są tylko do odczytu; zakres zapisu jest wyraźny i oddzielny.
  • Sekret przechowuj w lokalnej konfiguracji klienta, nigdy w czacie AI, zgłoszeniach, logach ani adresach URL; token możesz w każdej chwili unieważnić w Integracjach.

Jak zacząć

Bezpośredni endpoint Vinotify to https://vinotify.me/api/v1/mcp, serwer JSON-RPC w trybie Streamable HTTP, który przyjmuje tylko POST. Użyj klienta MCP obsługującego nagłówki bearer; Claude Code, Cursor i Claude Desktop mogą się połączyć, natomiast Claude.ai w przeglądarce i konektory ChatGPT nie są jeszcze obsługiwane.

  1. Zaloguj się na konto Vinotify Pro, otwórz Integracje i utwórz token. Zostaw dostęp do zapisu wyłączony, chyba że potrzebujesz zapisu w wyszukiwaniach.
  2. Użyj instrukcji konfiguracji bez tokenu z asystentem lub klientem; mogą one wyjaśnić połączenie, nie widząc Twoich danych uwierzytelniających.
  3. Samodzielnie wstaw sekret do lokalnej konfiguracji klienta MCP jako Authorization: Bearer <token> dla endpointu. Nigdy nie wklejaj sekretu do czatu AI; jest pokazywany tylko raz.
  4. Połącz serwer i wypróbuj list_searches. Unieważnij token w Integracjach, gdy nie będzie już potrzebny lub mógł zostać ujawniony.

Narzędzia odczytu są dostępne z domyślnym tokenem tylko do odczytu. Narzędzia zapisu są domyślnie wyłączone: create_search, update_search, pause_search, resume_search i delete_search pojawiają się tylko dla tokenu z zakresem zapisu, gdy opcja zapisu na serwerze jest włączona.

Często zadawane pytania

Jaki jest adres URL endpointu MCP Vinotify?
https://vinotify.me/api/v1/mcp. To bezstanowy endpoint JSON-RPC, który przyjmuje żądania POST i uwierzytelnia się tokenem integracji konta Pro, wysyłanym jako token bearer.
Jakie narzędzia MCP udostępnia Vinotify?
Trzy narzędzia odczytu (list_searches, get_new_items i whats_new) oraz pięć narzędzi zapisu (create_search, update_search, pause_search, resume_search i delete_search), które wymagają tokenu z zakresem zapisu i są włączone po stronie serwera.
Czy połączenie MCP jest tylko do odczytu?
Tak, domyślnie. Token jest tylko do odczytu, chyba że przy jego tworzeniu wyraźnie wybierzesz dostęp do zapisu, więc podłączony asystent nie może zmienić Twoich wyszukiwań, jeśli nie nadasz mu takiego zakresu.
Czy mogę używać go z Claude, ChatGPT lub agentem programistycznym?
Połączyć się może każdy klient obsługujący MCP przez Streamable HTTP. Wpisz endpoint i swój token w lokalnej konfiguracji tego klienta. Token jest pokazywany raz, przy tworzeniu, i możesz go w każdej chwili unieważnić na stronie Integracje.