O Vinotify oferece um servidor MCP direto em Streamable HTTP para levar os seus alertas da Vinted a ferramentas de IA compatíveis. Usa um token bearer e mantém um limite claro entre a sua conta Vinotify e o assistente.
O servidor expõe ferramentas de leitura para descobrir pesquisas e ler os novos anúncios correspondentes. Um token é só de leitura por predefinição; se criar explicitamente um token com permissão de escrita e as ferramentas de escrita estiverem ativadas, também pode criar, atualizar, pausar, retomar ou eliminar pesquisas. Guarde o segredo na configuração local do seu cliente MCP, nunca num chat de IA.
O que o servidor MCP do Vinotify pode fazer
Com um token de integração Pro, o servidor direto permite:
- Descobrir pesquisas ativas com list_searches e ler artigos novos com get_new_items ou whats_new.
- Ler os anúncios correspondentes com links, preços, mercados, moedas e os detalhes disponíveis.
- Continuar cada fluxo de eventos a partir de um cursor guardado; os eventos são entregues pelo menos uma vez, por isso os clientes devem eliminar duplicados dos IDs de evento.
- Manter o token limitado a todas as pesquisas que a sua conta possui agora e às que criar mais tarde; os clientes podem atualizar a descoberta para acompanhar as alterações às pesquisas ativas.
Uma forma simples de ver as coisas
- Cria e gere as pesquisas no Vinotify; os tokens estão associados à conta e não são escolhidos pesquisa a pesquisa.
- Cria um token de integração. É só de leitura por predefinição; se for preciso, permite explicitamente a escrita, e as ferramentas de escrita continuam a exigir que a opção do servidor esteja ativada.
- Coloca o token na configuração local do seu cliente, no cabeçalho Authorization: Bearer, para https://vinotify.me/api/v1/mcp. Pode dar a um assistente as instruções de configuração sem token, mas o segredo não deve ser colado no chat.
- O assistente usa as ferramentas MCP disponíveis para ler correspondências ou, quando ativado, criar, atualizar, pausar, retomar ou eliminar pesquisas; o controlo continua consigo.
Só de leitura por predefinição, com um âmbito de escrita opcional e restrito
Um token normal só pode usar as ferramentas de leitura. Um token opcional com permissão de escrita pode usar create_search, update_search, pause_search, resume_search e delete_search quando as ferramentas de escrita estão ativadas e as regras do plano do Vinotify o permitem. Nenhum token pode:
- Apagar o histórico de artigos de uma pesquisa. Uma pesquisa eliminada para de imediato, mas as correspondências anteriores são mantidas.
- Alterar a sua subscrição, abrir dados de faturação ou de pagamento, nem fazer compras.
- Ler o seu perfil nem iniciar sessão em seu nome.
- Comprar um artigo através do Vinotify nem controlar a sua conta Vinted.
As escritas continuam a seguir as regras de pesquisa, os limites do plano, os intervalos, as restrições de mercado e os limites de pedidos do Vinotify. Um token nunca alarga a titularidade da conta: só pode atuar sobre as pesquisas da sua própria conta.
Formas úteis de usar os dados dos seus alertas
- Peça uma lista curta de correspondências abaixo de um preço-alvo.
- Compare os anúncios recentes das suas pesquisas ativas ou de vários mercados Vinted.
- Resuma whats_new e destaque apenas os artigos que se ajustam às suas prioridades.
- Quando o âmbito de escrita está ativado de forma deliberada, peça ao assistente que crie, atualize, pause ou retome uma pesquisa dentro das regras do Vinotify.
Concebido com uma superfície de segurança reduzida
- O servidor MCP está disponível para contas Pro, e os tokens bearer são verificados em cada pedido face às pesquisas da conta.
- O token completo é mostrado uma única vez. O Vinotify guarda apenas um resumo irreversível, por isso não consegue revelar o token original mais tarde.
- Os tokens abrangem todas as pesquisas atuais e futuras da mesma conta. São só de leitura por predefinição; o âmbito de escrita é explícito e separado.
- Guarde o segredo na configuração local do cliente, nunca num chat de IA, em tickets, registos ou URLs; revogue um token a qualquer momento em Integrações.
Como começar
O endpoint direto do Vinotify é https://vinotify.me/api/v1/mcp, um servidor JSON-RPC em Streamable HTTP que só aceita POST. Use um cliente MCP que suporte cabeçalhos bearer; o Claude Code, o Cursor e o Claude Desktop conseguem ligar-se, enquanto o Claude.ai na web e os conectores do ChatGPT ainda não são suportados.
- Inicie sessão numa conta Vinotify Pro, abra Integrações e crie um token. Deixe o acesso de escrita desativado, a não ser que precise de escrever nas pesquisas.
- Use as instruções de configuração sem token com o seu assistente ou cliente; podem explicar a ligação sem ver as suas credenciais.
- Insira o segredo pessoalmente na configuração local do cliente MCP como Authorization: Bearer <token> para o endpoint. Nunca cole o segredo num chat de IA; só é mostrado uma vez.
- Ligue o servidor e experimente list_searches. Revogue o token em Integrações quando já não for necessário ou se puder ter sido exposto.
As ferramentas de leitura estão disponíveis com um token só de leitura por predefinição. As ferramentas de escrita estão desativadas por predefinição: create_search, update_search, pause_search, resume_search e delete_search só aparecem para um token com permissão de escrita enquanto a opção de escrita do servidor estiver ativada.
Perguntas frequentes
- Qual é o URL do endpoint MCP do Vinotify?
- https://vinotify.me/api/v1/mcp. É um endpoint JSON-RPC sem estado que aceita pedidos POST e autentica com um token de integração de uma conta Pro, enviado como token bearer.
- Que ferramentas MCP expõe o Vinotify?
- Três ferramentas de leitura (list_searches, get_new_items e whats_new) e cinco de escrita (create_search, update_search, pause_search, resume_search e delete_search), que exigem um token com permissão de escrita e estão ativadas no servidor.
- A ligação MCP é só de leitura?
- Sim, por predefinição. Um token é só de leitura, a não ser que o acesso de escrita seja escolhido explicitamente na criação, por isso ligar um assistente não pode alterar as suas pesquisas se não tiver concedido essa permissão.
- Posso usá-lo com o Claude, o ChatGPT ou um agente de programação?
- Qualquer cliente que fale MCP por Streamable HTTP pode ligar-se. Coloque o endpoint e o seu token na configuração local desse cliente. O token é mostrado uma única vez na criação e pode ser revogado a qualquer momento na página Integrações.