Vinotify stellt einen direkten Streamable-HTTP-MCP-Server bereit, der deine Vinted-Alarme in kompatible KI-Tools bringt. Er nutzt ein Bearer-Token und hält eine klare Grenze zwischen deinem Vinotify-Konto und dem Assistenten ein.
Der Server bietet Lesetools, um Suchen zu entdecken und neue passende Angebote zu lesen. Ein Token ist standardmäßig schreibgeschützt; wenn du ausdrücklich ein Token mit Schreibzugriff erstellst und die Schreibtools aktiviert sind, kann es auch Suchen erstellen, aktualisieren, pausieren, fortsetzen oder löschen. Speichere das Geheimnis in der lokalen Konfiguration deines MCP-Clients, nicht in einem KI-Chat.
Was der Vinotify-MCP-Server kann
Mit einem Pro-Integrationstoken bietet der direkte Server:
- Aktive Suchen mit list_searches entdecken und neue Artikel mit get_new_items oder whats_new lesen.
- Passende Angebote mit Links, Preisen, Marktplätzen, Währungen und verfügbaren Details lesen.
- Jeden Ereignis-Stream von einem gespeicherten Cursor aus fortsetzen; Ereignisse werden mindestens einmal zugestellt, daher sollten Clients Ereignis-IDs deduplizieren.
- Das Token auf alle Suchen begrenzen, die dein Konto jetzt besitzt oder später erstellt; Clients können die Discovery aktualisieren, um Änderungen an aktiven Suchen zu übernehmen.
Einfach erklärt
- Du erstellst und verwaltest deine Suchen in Vinotify; Tokens sind kontogebunden und werden nicht pro Suche ausgewählt.
- Du erstellst ein Integrationstoken. Es ist standardmäßig schreibgeschützt; bei Bedarf erlaubst du Schreibzugriff ausdrücklich, und die Schreibtools erfordern weiterhin, dass die Serveroption aktiviert ist.
- Du trägst das Token in der lokalen Konfiguration deines Clients als Authorization: Bearer für https://vinotify.me/api/v1/mcp ein. Einrichtungsanweisungen ohne Token kannst du einem Assistenten geben, das Geheimnis sollte aber nicht in den Chat eingefügt werden.
- Der Assistent nutzt die verfügbaren MCP-Tools, um Treffer zu lesen oder – wenn aktiviert – Suchen zu erstellen, zu aktualisieren, zu pausieren, fortzusetzen oder zu löschen; du behältst die Kontrolle.
Standardmäßig schreibgeschützt, mit eng begrenztem optionalem Schreibzugriff
Ein normales Token kann nur die Lesetools verwenden. Ein optionales Token mit Schreibzugriff kann create_search, update_search, pause_search, resume_search und delete_search verwenden, wenn die Schreibtools aktiviert sind und die Planregeln von Vinotify es erlauben. Kein Token kann:
- Den Artikelverlauf einer Suche löschen. Eine gelöschte Suche stoppt sofort, aber ihre bisherigen Treffer bleiben erhalten.
- Dein Abo ändern, Abrechnungs- oder Zahlungsdaten öffnen oder Käufe tätigen.
- Dein Profil lesen oder sich als du anmelden.
- Einen Artikel über Vinotify kaufen oder dein Vinted-Konto steuern.
Schreibvorgänge folgen weiterhin den bestehenden Suchregeln, Plan-Limits, Intervallen, Marktbeschränkungen und Ratenlimits von Vinotify. Ein Token erweitert nie den Kontobesitz: Es kann nur auf Suchen wirken, die seinem Konto gehören.
Nützliche Einsatzmöglichkeiten für deine Alarmdaten
- Eine Auswahl von Treffern unter einem Zielpreis anfordern.
- Aktuelle Angebote aus deinen aktiven Suchen oder verschiedenen Vinted-Marktplätzen vergleichen.
- whats_new zusammenfassen und nur die Artikel hervorheben, die zu deinen Prioritäten passen.
- Wenn der Schreibzugriff bewusst aktiviert ist, den Assistenten bitten, eine Suche innerhalb der Regeln von Vinotify zu erstellen, zu aktualisieren, zu pausieren oder fortzusetzen.
Mit kleiner Sicherheitsfläche gebaut
- Der MCP-Server steht Pro-Konten zur Verfügung, und Bearer-Tokens werden bei jeder Anfrage gegen die Suchen des Kontos geprüft.
- Das vollständige Token wird einmal angezeigt. Vinotify speichert nur einen nicht umkehrbaren Hash und kann das ursprüngliche Token deshalb später nicht anzeigen.
- Tokens gelten für alle aktuellen und künftigen Suchen desselben Kontos. Sie sind standardmäßig schreibgeschützt; Schreibzugriff ist ausdrücklich und getrennt.
- Bewahre das Geheimnis in der lokalen Client-Konfiguration auf, nie in KI-Chats, Tickets, Logs oder URLs; widerrufe ein Token jederzeit unter Integrationen.
Erste Schritte
Der direkte Endpunkt von Vinotify ist https://vinotify.me/api/v1/mcp, ein Streamable-HTTP-JSON-RPC-Server, der nur POST akzeptiert. Verwende einen MCP-Client, der Bearer-Header unterstützt; Claude Code, Cursor und Claude Desktop können sich verbinden, während Claude.ai im Web und ChatGPT-Konnektoren noch nicht unterstützt werden.
- Melde dich bei einem Vinotify-Pro-Konto an, öffne Integrationen und erstelle ein Token. Lass den Schreibzugriff deaktiviert, es sei denn, du brauchst Schreibvorgänge für Suchen.
- Verwende die Einrichtungsanweisungen ohne Token mit deinem Assistenten oder Client; sie können die Verbindung erklären, ohne deine Zugangsdaten zu sehen.
- Trage das Geheimnis selbst in die lokale Konfiguration des MCP-Clients als Authorization: Bearer <token> für den Endpunkt ein. Füge das Geheimnis nie in einen KI-Chat ein; es wird nur einmal angezeigt.
- Verbinde den Server und probiere list_searches aus. Widerrufe das Token unter Integrationen, wenn du es nicht mehr brauchst oder es offengelegt worden sein könnte.
Lesetools sind mit einem standardmäßig schreibgeschützten Token verfügbar. Schreibtools sind standardmäßig deaktiviert: create_search, update_search, pause_search, resume_search und delete_search erscheinen nur für ein Token mit Schreibzugriff, solange die Schreiboption des Servers aktiviert ist.
Häufige Fragen
- Wie lautet die URL des Vinotify-MCP-Endpunkts?
- https://vinotify.me/api/v1/mcp. Das ist ein zustandsloser JSON-RPC-Endpunkt, der POST-Anfragen annimmt und sich mit einem Integrationstoken eines Pro-Kontos authentifiziert, das als Bearer-Token gesendet wird.
- Welche MCP-Tools stellt Vinotify bereit?
- Drei Lesetools – list_searches, get_new_items und whats_new – sowie fünf Schreibtools: create_search, update_search, pause_search, resume_search und delete_search. Diese erfordern ein Token mit Schreibzugriff und sind serverseitig aktiviert.
- Ist die MCP-Verbindung schreibgeschützt?
- Ja, standardmäßig. Ein Token ist schreibgeschützt, es sei denn, der Schreibzugriff wird beim Erstellen ausdrücklich gewählt. Ein verbundener Assistent kann deine Suchen also nur ändern, wenn du diesen Zugriff erteilt hast.
- Kann ich es mit Claude, ChatGPT oder einem Coding-Agenten nutzen?
- Jeder Client, der MCP über Streamable HTTP spricht, kann sich verbinden. Trage den Endpunkt und dein Token in die lokale Konfiguration dieses Clients ein. Das Token wird beim Erstellen einmal angezeigt und lässt sich jederzeit auf der Seite Integrationen widerrufen.