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ć
- Tworzysz wyszukiwania i zarządzasz nimi w Vinotify; tokeny są powiązane z kontem i nie wybiera się ich dla pojedynczych wyszukiwań.
- 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.
- 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.
- 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.
- 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.
- Użyj instrukcji konfiguracji bez tokenu z asystentem lub klientem; mogą one wyjaśnić połączenie, nie widząc Twoich danych uwierzytelniających.
- 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.
- 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.