Skip to content

Your AI assistant can now work with Vinosoft

Many of you already have an AI assistant open all day: Claude for emails, ChatGPT for a quick calculation, Cursor or Claude Code for the shop theme. Until now that assistant knew nothing about your business. You copied figures out of Vinosoft, pasted them in, and copied the answer back.

That copying is over. Vinosoft now has an MCP server, and any AI client that supports MCP can connect to your account and work with your real data.

What is MCP?

The Model Context Protocol (MCP) is an open standard for connecting AI assistants to other software. You may already use it without having noticed the name: the "connectors" in Claude and ChatGPT for a calendar, a mailbox or a file store are MCP connections. Vinosoft is now one more entry in that list.

Once connected, the assistant gets a set of tools: small, well-defined actions such as "find documents", "get open invoices" or "create a document". It decides which ones to call to answer your question. You simply ask in your own words.

What you can do with it

A few questions that work today:

  • "Which invoices are overdue, and who owes us the most?"
  • "How did turnover in October compare with October last year?"
  • "Which wines are below 12 bottles in stock?"
  • "Draft a quote for Hotel Alpenblick: 24 bottles of the Pinot Noir and 12 of the Chasselas."
  • "Find all our customers in Lausanne and give me a link to the last invoice PDF for each."
  • "Which shop products have no French description yet? Translate them."

The real gain is the combination with everything else your assistant can reach. It can read a customer's email and prepare the matching quote, put the open invoices into a spreadsheet, or set a follow-up task after a meeting it has in your calendar.

How this differs from the AI Assistant inside Vinosoft: the built-in assistant lives in Vinosoft and uses your AI credits. With MCP, the AI model is the one you already pay for at Anthropic, OpenAI or elsewhere, so MCP requests use no AI credits. Both use the same tools underneath, so they give the same figures.

Connect in two minutes

Everything runs through one address:

https://app.vinosoft.ch/mcp

There are two ways to connect. Use the first one if your client offers it.

Option A: sign in from your AI client (Claude, ChatGPT)

Clients with connectors sign you in through your browser, so there is no token to copy.

  1. In your AI client, open the connector settings and add a custom connector. In Claude this is Settings → Connectors → Add custom connector; in ChatGPT it is under Settings → Apps & Connectors. Menu names change now and then, and custom connectors may depend on your plan.
  2. Give it a name, for example Vinosoft, and paste the server address https://app.vinosoft.ch/mcp.
  3. Click Connect. A Vinosoft page opens in your browser. Sign in if you are asked to.
  4. Check the tenant and decide whether the assistant may also make changes. That box is unticked at first, so a new connection is read-only unless you say otherwise.
  5. Click Connect. You are sent back to your AI client and the Vinosoft tools appear there.
The Vinosoft page "Connect Claude" showing the tenant, the read permission, the unticked box for allowing changes and the Connect button.

Option B: an access token (Claude Code, Cursor, scripts)

Developer tools and your own scripts usually take a token instead.

  1. In Vinosoft, click your profile icon at the top right and open the Integrations tab.
  2. In the card AI clients (MCP), enter a name that tells you later where the token is used, for example Claude on my laptop.
  3. Choose when it expires: in 30 days, in 90 days, in a year, or never.
  4. Tick Can make changes only if the client should create or change things. Without it the token is read-only.
  5. Click Create token.
The AI clients (MCP) card under Profile → Integrations with the server URL, two existing connections and the form for a new token.

Vinosoft shows the token once. Copy it straight away; if you lose it, revoke it and create a new one.

The card right after creating a token: the notice to copy it now, the token itself and a ready-made command for Claude Code.

Under the token you find a ready-made command for Claude Code:

claude mcp add --transport http vinosoft https://app.vinosoft.ch/mcp --header "Authorization: Bearer <your token>"

For Cursor and other clients that are configured with a JSON file, add Vinosoft as a remote server and send the token in the Authorization header:

{
  "mcpServers": {
    "vinosoft": {
      "url": "https://app.vinosoft.ch/mcp",
      "headers": { "Authorization": "Bearer <your token>" }
    }
  }
}

Not comfortable with a terminal? Let the assistant set itself up. Copy the command Vinosoft shows under your new token and paste it into your AI client with a short request:

Please configure this MCP server for me:
claude mcp add --transport http vinosoft https://app.vinosoft.ch/mcp --header "Authorization: Bearer <your token>"

Assistants that can run commands or edit their own settings, such as Claude Code or Cursor, do the rest themselves and tell you when Vinosoft is connected.

Treat a token like a password. Anyone who has it can read your Vinosoft data with your permissions. Give it only to the AI client that should use it, and don't paste it into other chats, emails or shared documents.

You stay in control

  • It sees what you see. A connection works with your own permissions. A module or document type you cannot open in Vinosoft is closed to your assistant too, and a permission that is taken away from you is gone for the assistant on its next request.
  • Read-only unless you allow more. Without "Can make changes" the tools that write are not even offered to the assistant.
  • Your assistant asks first. Tools that change something are marked as such, and most clients ask for your confirmation before each of those calls.
  • Revoke at any time. Under Profile → Integrations every token and every connected app is listed with its last use. Revoke ends it at once.
  • PDF links expire. A link to a document PDF that the assistant receives is valid for 15 minutes.
  • We log calls, not content. For each call we record who called which tool, when, and whether it succeeded. The arguments and results are not stored.

One thing to keep in mind: whatever the assistant reads from Vinosoft is processed by the AI provider you connected. Connect only clients whose terms fit your business.

Limits

Each connection may make 60 requests per minute. That is far more than a conversation needs; the limit is there to stop an automation that runs in circles. If it is reached, the assistant gets a message to wait a minute and can carry on afterwards. Nothing is lost.

MCP requests use no AI credits, and there is no extra charge for the MCP server at the moment.

Working with several tenants

If your login belongs to more than one tenant, a token can cover several of them: tick the tenants when you create it, or change them later with Tenants next to the token. The assistant then chooses the tenant per request, and a request that names none runs in the default tenant. A connection made by signing in from the AI client (option A) covers the one tenant you pick on the connect page.

The tools

Which tools your assistant sees depends on your modules, your permissions and on whether the connection may make changes. Tools marked ✎ change something and need Can make changes.

Sales and statistics

Tool

What it does

get_turnover

Net turnover per year, or month by month for one year, with credit notes deducted.

get_turnover_by_customer

Customers ranked by net turnover, for a year or all time.

get_sales_summary

Units sold, number of different products and the top products, for a year or all time.

get_best_selling_products

Units sold per product, for a year or all time.

get_open_invoices

Unpaid invoices, most overdue first.

get_payment_periods

How many days customers take to pay on average, per customer.

get_low_stock_items

Articles at or below a stock threshold, lowest first.

get_stock_value

Inventory valuation: stock × net purchase price.

Customers, articles and tasks

Tool

What it does

lookup_customer

Finds customers by name, customer number or email.

find_customers_by_location

Lists customers by town or postal code.

lookup_product

Searches the catalogue by SKU or name.

get_article_detail

Everything about one article: sale and purchase prices, stock and more.

list_manufacturers, get_manufacturer

Lists manufacturers or reads one.

update_manufacturer ✎

Changes a manufacturer's details.

get_my_tasks

The tasks assigned to you.

create_task ✎

Creates a follow-up task for a customer or a document.

search_help

Searches the Vinosoft Help Center.

Documents

Tool

What it does

find_documents

Finds quotes, order confirmations, invoices, credit notes, delivery notes and purchase orders.

get_document_pdf

Returns a download link to a document's PDF, valid for 15 minutes.

create_document ✎

Creates a new quote, order confirmation, invoice, credit note, delivery note or purchase order.

update_document ✎

Changes an existing document.

update_line_price ✎

Changes the unit price of a line on a document.

Online shop: catalogue and translations

These need the Shop module.

Tool

What it does

list_shop_languages

The languages your shop is published in.

list_products, get_product

Lists the shop's products or reads one with its variants, prices, images and texts.

list_collections, get_collection

Lists collections or reads one with its rules and products.

list_news

Lists the shop's news items.

list_menus, get_menu

Lists navigation menus or reads one as a tree.

get_translations

All texts of one item in every shop language.

find_missing_translations

Finds shop texts that are not translated yet.

set_translations ✎

Saves texts of a product, collection, page, news item or menu item in one language.

rename_slug ✎

Changes the web address of a product, collection, page or news item and sets up the redirect.

update_news ✎

Changes a news item's settings, such as template, publication and order.

set_tags ✎

Adds or removes tags on a product.

Online shop: pages, themes and media

These need the Shop module.

Tool

What it does

list_static_pages, get_static_page

Lists static pages or reads one in one language.

create_static_page ✎, update_static_page ✎, delete_static_page ✎

Creates, changes or deletes a static page. A deleted page goes to the recycle bin.

list_themes, list_theme_files, read_theme_file

Lists themes and their files and reads a file.

preview_theme

Returns a link that shows your shop in a theme that is not active.

write_theme_file ✎, edit_theme_file ✎

Creates or replaces a theme file, or changes part of one.

delete_theme_file ✎

Deletes a theme file. This cannot be undone.

list_media_assets

Lists the files and folders of the media library.

upload_media_asset ✎

Adds a file to the media library and returns its public address.

delete_media_asset ✎

Deletes a file or folder from the media library. This cannot be undone.

list_sites

Lists your sites with their domains.

add_site_domain ✎

Adds a custom domain to a site and returns the DNS records to set.

create_landing_site ✎, set_site_theme ✎

Creates a landing site or pins one to a theme. Only with the Landing sites extension.

With a token for several tenants there is also list_tenants, which tells the assistant which tenants it may work in.

Try it today

Connect your assistant read-only first and ask it something you would otherwise look up yourself, for example "What is still unpaid, and since when?" Once you trust the answers, allow changes and let it prepare your next quote.

We keep adding tools. If your assistant cannot do something you expected, tell us: your feedback decides what we build next.

Help Shape What We Build Next

Share the features, improvements or workflow challenges that would make Vinosoft more valuable for your business.