Vinotify ofrece un servidor MCP directo mediante Streamable HTTP para llevar tus alertas de Vinted a herramientas de IA compatibles. Usa un token bearer y mantiene una separación clara entre tu cuenta de Vinotify y el asistente.
El servidor ofrece herramientas de lectura para descubrir búsquedas y leer los nuevos anuncios que coinciden. Un token es de solo lectura por defecto; si creas explícitamente un token con permisos de escritura y las herramientas de escritura están habilitadas, también puede crear, actualizar, pausar, reanudar o eliminar búsquedas. Guarda el secreto en la configuración local de tu cliente MCP, no en un chat de IA.
Qué puede hacer el servidor MCP de Vinotify
Con un token de integración Pro, el servidor directo permite:
- Descubrir búsquedas activas con list_searches y leer artículos nuevos con get_new_items o whats_new.
- Leer los anuncios que coinciden, con enlaces, precios, mercados, monedas y los detalles disponibles.
- Continuar cada flujo de eventos desde un cursor guardado; los eventos se entregan al menos una vez, así que los clientes deben deduplicar los ID de evento.
- Limitar el token a todas las búsquedas que tu cuenta posee ahora y a las que crees más adelante; los clientes pueden actualizar el descubrimiento para recoger los cambios en las búsquedas activas.
Una forma sencilla de entenderlo
- Creas y gestionas las búsquedas en Vinotify; los tokens se vinculan a la cuenta y no se eligen búsqueda por búsqueda.
- Creas un token de integración. Es de solo lectura por defecto; si hace falta, permites la escritura de forma explícita, y las herramientas de escritura siguen requiriendo que la opción del servidor esté activada.
- Pones el token en la configuración local de tu cliente, en el encabezado Authorization: Bearer, para https://vinotify.me/api/v1/mcp. Puedes dar a un asistente las instrucciones de configuración sin token, pero el secreto no debe pegarse en el chat.
- El asistente usa las herramientas MCP disponibles para leer coincidencias o, cuando está habilitado, crear, actualizar, pausar, reanudar o eliminar búsquedas; tú sigues al mando.
Solo lectura por defecto, con un permiso de escritura opcional y acotado
Un token estándar solo puede usar las herramientas de lectura. Un token opcional con permisos de escritura puede usar create_search, update_search, pause_search, resume_search y delete_search cuando las herramientas de escritura están habilitadas y las reglas del plan de Vinotify lo permiten. Ningún token puede:
- Borrar el historial de artículos de una búsqueda. Una búsqueda eliminada se detiene al instante, pero sus coincidencias anteriores se conservan.
- Cambiar tu suscripción, abrir datos de facturación o de pago, ni realizar compras.
- Leer tu perfil ni iniciar sesión como tú.
- Comprar un artículo a través de Vinotify ni controlar tu cuenta de Vinted.
Las escrituras siguen aplicando las reglas de búsqueda, los límites del plan, los intervalos, las restricciones de mercado y los límites de frecuencia de Vinotify. Un token nunca amplía la propiedad de la cuenta: solo puede actuar sobre las búsquedas de su cuenta.
Formas útiles de usar los datos de tus alertas
- Pedir una preselección de coincidencias por debajo de un precio objetivo.
- Comparar los anuncios recientes de tus búsquedas activas o de distintos mercados de Vinted.
- Resumir whats_new y destacar solo los artículos que encajan con tus prioridades.
- Cuando el permiso de escritura se habilita de forma deliberada, pedir al asistente que cree, actualice, pause o reanude una búsqueda dentro de las reglas de Vinotify.
Diseñado con una superficie de seguridad reducida
- El servidor MCP está disponible para cuentas Pro, y los tokens bearer se comprueban en cada solicitud contra las búsquedas de la cuenta.
- El token completo se muestra una sola vez. Vinotify solo guarda un resumen irreversible, así que no puede revelar el token original más adelante.
- Los tokens cubren todas las búsquedas actuales y futuras de la misma cuenta. Son de solo lectura por defecto; el permiso de escritura es explícito y separado.
- Guarda el secreto en la configuración local del cliente, nunca en un chat de IA, tickets, registros ni URL; revoca un token cuando quieras desde Integraciones.
Cómo empezar
El endpoint directo de Vinotify es https://vinotify.me/api/v1/mcp, un servidor JSON-RPC Streamable HTTP que solo admite POST. Usa un cliente MCP compatible con encabezados bearer; Claude Code, Cursor y Claude Desktop pueden conectarse, mientras que Claude.ai en la web y los conectores de ChatGPT aún no son compatibles.
- Inicia sesión en una cuenta Vinotify Pro, abre Integraciones y crea un token. Deja desactivado el acceso de escritura salvo que necesites escribir en las búsquedas.
- Usa las instrucciones de configuración sin token con tu asistente o cliente; pueden explicar la conexión sin ver tus credenciales.
- Inserta tú mismo el secreto en la configuración local del cliente MCP como Authorization: Bearer <token> para el endpoint. Nunca pegues el secreto en un chat de IA; solo se muestra una vez.
- Conecta el servidor y prueba list_searches. Revoca el token desde Integraciones cuando ya no lo necesites o pueda haberse expuesto.
Las herramientas de lectura están disponibles con un token de solo lectura por defecto. Las herramientas de escritura están desactivadas por defecto: create_search, update_search, pause_search, resume_search y delete_search solo aparecen para un token con permisos de escritura mientras la opción de escritura del servidor esté activada.
Preguntas frecuentes
- ¿Cuál es la URL del endpoint MCP de Vinotify?
- https://vinotify.me/api/v1/mcp. Es un endpoint JSON-RPC sin estado que acepta solicitudes POST y se autentica con un token de integración de una cuenta Pro, enviado como token bearer.
- ¿Qué herramientas MCP ofrece Vinotify?
- Tres herramientas de lectura (list_searches, get_new_items y whats_new) y cinco de escritura (create_search, update_search, pause_search, resume_search y delete_search), que requieren un token con permisos de escritura y están habilitadas en el servidor.
- ¿La conexión MCP es de solo lectura?
- Sí, por defecto. Un token es de solo lectura salvo que se elija el acceso de escritura de forma explícita al crearlo, así que conectar un asistente no puede cambiar tus búsquedas a menos que hayas concedido ese permiso.
- ¿Puedo usarlo con Claude, ChatGPT o un agente de programación?
- Puede conectarse cualquier cliente que hable MCP mediante Streamable HTTP. Pon el endpoint y tu token en la configuración local de ese cliente. El token se muestra una sola vez al crearlo y puedes revocarlo en cualquier momento desde la página Integraciones.