MCP server (Claude & AI assistants)

It is a secure link between your cellar data and MCP-compatible software. After the first connection, the assistant can read or update your inventory within your subscription and account rules.

The exact address appears in the VinoCellar app on the MCP and access tokens screen, under “MCP server address”. Copy it exactly—do not transcribe it from an old screenshot.

On the public production VinoCellar app, this is usually https://mcp.vinocellar.app. If the app shows something different, trust what it shows.

1. Open the app → MCP (or Settings → VinoCellar MCP → manage tokens).
2. Copy the server address from the dedicated block.
3. In your assistant (e.g. Claude Desktop), add an MCP server and paste that address following the assistant’s help or documentation.
4. On first connect, a web page guides you; paste the personal token you created in the app when the form asks for it.

The link uses a secure connection (HTTPS) between your computer and VinoCellar; the assistant only sees what your token allows.

The first time, the program often opens the browser so you can paste the token you created in the app; VinoCellar checks the token, then the assistant can finish setup on its own.

Tokens you create in the app allow the useful cellar actions (lists, search, bin layout, moves, adding wines) offered by the service.

Tokens identify your account to the MCP server during setup:

1. In the app, open the MCP screen and tap create token.
2. Give it a clear label (e.g. “MacBook”, “Claude on PC”).
3. Copy the token value immediately—it is shown only once.
4. Revoke a token from the same screen if a device is lost or you want to disconnect a program.

Treat tokens like passwords. Anyone with the token and the server address could access your cellar through MCP until you revoke it.

Once you add the server in your assistant, it can perform actions on your cellar. In practice you can for example:

• Check the linked account and see a helpful reminder (welcome text, link to this FAQ, guidance).
• Browse or search your bottles (full list or keyword search).
• View your cellars and the bin grid so you know where bottles sit.
• Move a bottle to another bin or another cellar.
• Add a wine to your cellar when the assistant has the right information (including from labels or structured data)—requires an active MCP subscription.

MCP is limited to the inventory and cellar operations described above.

The in-app Vino chat assistant, food-and-wine pairing wizard, tasting journal, and similar features are not driven remotely as separate MCP actions—use the mobile or web app for those experiences.

The intended setup is an MCP-compatible assistant (e.g. Claude Desktop): copy the server address from the app and create a personal token.

We do not publish a separate catalogue of “web addresses to call by hand” for the same features—you configure your assistant, which then discovers the actions available in VinoCellar.

Credits are mainly spent on in-app AI label scans. The optional MCP subscription is separate: while it is active, supported actions through the MCP server are not capped by your scan-credit balance in the same way.

Claude Desktop and other MCP-enabled software set up as described in this topic are supported today. ChatGPT and Gemini compatibility is planned; check release notes and this FAQ for updates.