É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
| Ferramenta | Descrição |
|---|---|
search_wines | Pesquise no catálogo de 100 mil+ vinhos por nome, produtor, denominação |
list_cellars | Liste suas adegas |
list_bottles | Liste garrafas em uma adega |
add_bottle | Adicione uma garrafa |
add_bottles_batch | Adicione até 100 garrafas de uma vez |
update_bottle | Altere status, notas, localização, preço, safra ou mova entre adegas |
delete_bottle | Remova uma garrafa |
recommend_bottles | Recomendação de harmonização para uma refeição ou com base na maturidade de consumo |
scan_label | Identifique um vinho a partir de uma foto do rótulo |
scan_labels_batch | Até 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
- Configurações → Conectores → Adicionar conector personalizado
- URL:
https://mcp.emile.wine/mcp - Clique em Conectar → você será redirecionado para
app.emile.winepara entrar e autorizar - De volta ao Claude, o conector está ativo. Experimente: "Liste minhas adegas"
ChatGPT (Modo Desenvolvedor)
- Configurações → Conectores → ative o Modo Desenvolvedor
- Criar app → URL:
https://mcp.emile.wine/mcp - Autenticação: OAuth (detectado automaticamente)
- 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
- 📱 iOS App Store — a app nativa do Émile
- 🌐 app.emile.wine — cadastro web + gerenciamento de chaves de API
- 📦 npm @emile-wine/mcp-server
- 📋 Registro Oficial MCP — listado como
io.github.SebastienGal/emile-wine