Servidor MCP (Claude e assistentes de IA)

É uma ligação segura entre os dados da adega e um programa compatível com MCP. Após a primeira configuração, o assistente pode ler ou actualizar o inventário dentro da subscrição e das regras da conta.

O endereço exacto aparece na app VinoCellar, no ecrã MCP e tokens de acesso, em «Endereço do servidor MCP». Copie-o tal como está, sem o retirar de uma captura antiga.

Na app pública de produção costuma ser https://mcp.vinocellar.app . Se a app mostrar outro valor, confie sempre no que ela indica.

1. Abra a app → secção MCP (ou Definições → VinoCellar MCP → gerir tokens).
2. Copie o endereço do servidor no bloco indicado.
3. No seu assistente (ex.: Claude Desktop), adicione um servidor MCP e cole o endereço seguindo a ajuda do programa.
4. Na primeira ligação, uma página web guia-o; cole o token pessoal criado na app quando o formulário pedir.

A ligação é segura (HTTPS) entre o seu computador e a VinoCellar: o assistente só vê o que o token autoriza.

Na primeira vez, o programa abre muitas vezes o navegador para colar o token criado na app; a VinoCellar verifica-o e o assistente pode concluir a configuração.

Os tokens criados na app permitem as acções úteis na adega (listas, pesquisa, grelha de casas, movimentações, adição de vinhos) previstas pelo serviço.

O token identifica a sua conta perante o servidor MCP:

1. Na app, abra o ecrã MCP e crie um token.
2. Dê-lhe um nome claro (ex. «MacBook», «Claude no PC»).
3. Copie o valor de imediato — só é mostrado uma vez.
4. Revogue um token no mesmo ecrã se perder um dispositivo ou quiser desligar um programa.

Trate os tokens como palavras-passe: quem tiver o token e o endereço pode aceder à adega via MCP até revogar.

Depois de adicionar o servidor no assistente, ficam disponíveis acções sobre a adega. Na prática, por exemplo:

• Verificar a conta associada e ver um lembrete útil (boas-vindas, ligação a esta FAQ, orientação).
• Percorrer ou pesquisar as suas garrafas (lista completa ou pesquisa por palavras).
• Ver as adegas e a grelha de casas para saber onde estão as garrafas.
• Mover uma garrafa para outra casa ou outra adega.
• Adicionar um vinho à adega quando o assistente tem a informação certa (incluindo a partir de rótulos ou dados já estruturados) — requer subscrição MCP activa.

As possibilidades do MCP limitam-se às operações de inventário e adega descritas acima.

O assistente Vino na app, o assistente de harmonizações, o diário de provas e outras funções de IA não se controlam à distância como acções MCP separadas — use a app móvel ou a web para esses casos.

O uso previsto é um assistente compatível com MCP (por exemplo Claude Desktop): copie o endereço do servidor na app e crie um token pessoal.

Não publicamos um catálogo separado de «endereços web para chamar manualmente» para as mesmas funções: configura o assistente, que depois descobre as acções disponíveis na VinoCellar.

Os créditos servem sobretudo para digitalizações de rótulo na app. A subscrição MCP é separada: enquanto estiver activa, as acções suportadas via servidor MCP não ficam limitadas pelo saldo de créditos de digitalização da mesma forma.

Hoje são suportados o Claude Desktop e outros programas compatíveis com MCP configurados como explicado nesta secção. Compatibilidade ChatGPT e Gemini prevista; consulte as notas de versão e esta FAQ.