Émile

Adega pessoal — liste, adicione, recomende, escaneie e pesquise mais de 100 mil vinhos. Disponível via npx e como um MCP remoto protegido por OAuth em mcp.emile.wine.

Documentação

Use o Émile com seu assistente de IA

O Émile inclui um servidor oficial de MCP. Peça ao Claude, ChatGPT, Cursor ou qualquer cliente compatível com MCP para adicionar, escanear ou recomendar vinhos direto da sua adega. Dois modos de conexão: OAuth remoto (mais simples, recomendado) ou npx local (para clientes sem suporte a OAuth).

Pré-requisitos: uma conta Émile (crie pela app iOS ou em app.emile.wine).

O que você pode fazer

FerramentaDescrição
search_winesPesquise no catálogo de 100 mil+ vinhos por nome, produtor, denominação
list_cellarsListe suas adegas
list_bottlesListe garrafas em uma adega
add_bottleAdicione uma garrafa
add_bottles_batchAdicione até 100 garrafas de uma vez
update_bottleAltere status, notas, localização, preço, safra ou mova entre adegas
delete_bottleRemova uma garrafa
recommend_bottlesRecomendação de harmonização para uma refeição ou com base na maturidade de consumo
scan_labelIdentifique um vinho a partir de uma foto do rótulo
scan_labels_batchAté 10 fotos de rótulos de uma vez

Opção 1 — Conexão remota (OAuth)

O caminho mais simples: Claude Desktop, ChatGPT e outros clientes recentes suportam adicionar um servidor MCP remoto via OAuth — sem arquivo de configuração local, sem chave de API para gerenciar.

Claude Desktop

  1. Configurações → ConectoresAdicionar conector personalizado
  2. URL: https://mcp.emile.wine/mcp
  3. Clique em Conectar → você será redirecionado para app.emile.wine para entrar e autorizar
  4. De volta ao Claude, o conector está ativo. Experimente: "Liste minhas adegas"

ChatGPT (Modo Desenvolvedor)

  1. Configurações → Conectores → ative o Modo Desenvolvedor
  2. Criar app → URL: https://mcp.emile.wine/mcp
  3. Autenticação: OAuth (detectado automaticamente)
  4. Conclua o fluxo de autorização (login no Émile) e depois teste

Opção 2 — Instalação local (npx)

Para clientes que ainda não suportam OAuth remoto (Cursor, Continue, Cline…), o servidor roda localmente via npm e fala diretamente com api.emile.wine usando uma chave de API pessoal.

1. Gere uma chave de API na app

Abra o Émile no seu iPhone → Perfil → Configurações → Chaves de API+ Gerar. Copie a chave emile_live_... (exibida apenas uma vez).

2. Adicione o servidor à sua configuração

Exemplo para Claude Desktop — edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "emile": {
      "command": "npx",
      "args": ["-y", "@emile-wine/mcp-server"],
      "env": {
        "EMILE_API_KEY": "emile_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Para Cursor / Continue / outros: mesmo comando npx -y @emile-wine/mcp-server + a variável de ambiente EMILE_API_KEY, adapte a sintaxe ao formato de configuração do seu cliente.

3. Reinicie seu cliente

O indicador MCP deve aparecer com emile listado nos servidores conectados.

Exemplos de comandos

  • "Liste as garrafas da minha adega principal"
  • "Adicione um Château Pichon Lalande 2015, comprado por €95, slot A3"
  • "O que devemos beber hoje à noite com peito de pato?"
  • "Mova a garrafa de Chinon da minha adega da garagem para a adega da cozinha"
  • "Marque a última garrafa de Cahors como consumida"
  • "Escanee este rótulo: [foto]"

Privacidade

Modo OAuth remoto: sem armazenamento de credenciais no lado do cliente, a autorização pode ser revogada a qualquer momento pela sua conta Émile. O servidor roda na nossa infraestrutura na França atrás de uma CSP rigorosa, e cada requisição é validada por um token de curta duração.

Modo npx local: sua chave de API permanece na sua máquina. O servidor roda localmente e fala diretamente com api.emile.wine. Nenhum terceiro no meio — é exatamente como usar a app, mas via texto.

Em ambos os casos, consulte a política de privacidade completa.

Também disponível em