Vinotify Logovinotify
Inloggen

Vinotify en MCP: breng je Vinted-meldingen naar AI-tools

← Terug naar de blog

3 september 2026

Vinotify biedt een directe Streamable HTTP-MCP-server om je Vinted-meldingen naar compatibele AI-tools te brengen. De server gebruikt een bearer-token en houdt een duidelijke grens tussen je Vinotify-account en de assistent.

De server biedt leestools om zoekopdrachten te ontdekken en nieuwe overeenkomende advertenties te lezen. Een token is standaard alleen-lezen; als je uitdrukkelijk een token met schrijfrechten maakt en schrijftools zijn ingeschakeld, kan het ook zoekopdrachten maken, bijwerken, pauzeren, hervatten of verwijderen. Bewaar het geheim in de lokale configuratie van je MCP-client, niet in een AI-chat.

Wat de Vinotify-MCP-server kan

Met een Pro-integratietoken biedt de directe server:

  • Actieve zoekopdrachten ontdekken met list_searches en nieuwe items lezen met get_new_items of whats_new.
  • Overeenkomende advertenties lezen met links, prijzen, marktplaatsen, valuta en beschikbare details.
  • Elke gebeurtenisstroom hervatten vanaf een opgeslagen cursor; gebeurtenissen worden minstens één keer geleverd, dus clients horen gebeurtenis-ID's te ontdubbelen.
  • Het token beperken tot alle zoekopdrachten die je account nu bezit en die je later maakt; clients kunnen discovery verversen om wijzigingen in actieve zoekopdrachten op te pikken.

Een eenvoudige manier om het te zien

  1. Je maakt en beheert zoekopdrachten in Vinotify; tokens zijn aan het account gekoppeld en worden niet per zoekopdracht gekozen.
  2. Je maakt een integratietoken. Het is standaard alleen-lezen; indien nodig sta je schrijven uitdrukkelijk toe, en de schrijftools vereisen nog steeds dat de serveroptie aan staat.
  3. Je zet het token in de lokale configuratie van je client als Authorization: Bearer voor https://vinotify.me/api/v1/mcp. Installatie-instructies zonder token kun je aan een assistent geven, maar het geheim hoort niet in de chat.
  4. De assistent gebruikt de beschikbare MCP-tools om matches te lezen of, wanneer ingeschakeld, zoekopdrachten te maken, bij te werken, te pauzeren, te hervatten of te verwijderen; jij houdt de controle.

Standaard alleen-lezen, met een beperkt optioneel schrijfbereik

Een standaardtoken kan alleen de leestools gebruiken. Een optioneel token met schrijfrechten kan create_search, update_search, pause_search, resume_search en delete_search gebruiken wanneer schrijftools zijn ingeschakeld en de abonnementsregels van Vinotify dit toestaan. Geen enkel token kan:

  • De itemgeschiedenis van een zoekopdracht wissen. Een verwijderde zoekopdracht stopt meteen, maar eerdere matches blijven bewaard.
  • Je abonnement wijzigen, factuur- of betaalgegevens openen of aankopen doen.
  • Je profiel lezen of als jou inloggen.
  • Een item via Vinotify kopen of je Vinted-account bedienen.

Schrijfacties volgen nog steeds de bestaande zoekregels, abonnementslimieten, intervallen, marktbeperkingen en snelheidslimieten van Vinotify. Een token verruimt nooit het accounteigendom: het kan alleen handelen op zoekopdrachten van het eigen account.

Handige manieren om je meldingsgegevens te gebruiken

  • Vraag om een shortlist van matches onder een streefprijs.
  • Vergelijk recente advertenties uit je actieve zoekopdrachten of van verschillende Vinted-marktplaatsen.
  • Vat whats_new samen en toon alleen de items die bij je prioriteiten passen.
  • Als schrijfrechten bewust zijn ingeschakeld, laat je de assistent een zoekopdracht maken, bijwerken, pauzeren of hervatten binnen de regels van Vinotify.

Gebouwd met een klein beveiligingsoppervlak

  • De MCP-server is beschikbaar voor Pro-accounts en bearer-tokens worden bij elk verzoek gecontroleerd tegen de zoekopdrachten van het account.
  • Het volledige token wordt één keer getoond. Vinotify bewaart alleen een onomkeerbare hash en kan het oorspronkelijke token later dus niet tonen.
  • Tokens gelden voor alle huidige en toekomstige zoekopdrachten van hetzelfde account. Ze zijn standaard alleen-lezen; schrijfrechten zijn expliciet en apart.
  • Bewaar het geheim in de lokale clientconfiguratie, nooit in een AI-chat, ticket, logboek of URL; trek een token op elk moment in via Integraties.

Aan de slag

Het directe endpoint van Vinotify is https://vinotify.me/api/v1/mcp, een Streamable HTTP JSON-RPC-server die alleen POST accepteert. Gebruik een MCP-client die bearer-headers ondersteunt; Claude Code, Cursor en Claude Desktop kunnen verbinden, terwijl Claude.ai op het web en ChatGPT-connectors nog niet worden ondersteund.

  1. Log in op een Vinotify Pro-account, open Integraties en maak een token. Laat schrijftoegang uit, tenzij je schrijfacties op zoekopdrachten nodig hebt.
  2. Gebruik de installatie-instructies zonder token met je assistent of client; ze kunnen de verbinding uitleggen zonder je inloggegevens te zien.
  3. Voeg het geheim zelf toe aan de lokale configuratie van de MCP-client als Authorization: Bearer <token> voor het endpoint. Plak het geheim nooit in een AI-chat; het wordt maar één keer getoond.
  4. Verbind de server en probeer list_searches. Trek het token in via Integraties zodra je het niet meer nodig hebt of het mogelijk is blootgesteld.

Leestools zijn beschikbaar met een standaard alleen-lezen token. Schrijftools staan standaard uit: create_search, update_search, pause_search, resume_search en delete_search verschijnen alleen voor een token met schrijfrechten zolang de schrijfoptie van de server aan staat.

Veelgestelde vragen

Wat is de URL van het Vinotify-MCP-endpoint?
https://vinotify.me/api/v1/mcp. Het is een stateless JSON-RPC-endpoint dat POST-verzoeken accepteert en zich authenticeert met een integratietoken van een Pro-account, verstuurd als bearer-token.
Welke MCP-tools biedt Vinotify?
Drie leestools (list_searches, get_new_items en whats_new) plus vijf schrijftools (create_search, update_search, pause_search, resume_search en delete_search). Die vereisen een token met schrijfrechten en zijn aan de serverkant ingeschakeld.
Is de MCP-verbinding alleen-lezen?
Ja, standaard. Een token is alleen-lezen, tenzij je bij het maken uitdrukkelijk schrijftoegang kiest. Een gekoppelde assistent kan je zoekopdrachten dus niet wijzigen als je die rechten niet hebt gegeven.
Kan ik het gebruiken met Claude, ChatGPT of een codeeragent?
Elke client die MCP via Streamable HTTP spreekt, kan verbinden. Zet het endpoint en je token in de lokale configuratie van die client. Het token wordt bij het maken één keer getoond en je kunt het op elk moment intrekken op de pagina Integraties.