Annateca
Sign in

API · MCP

How to connect your assistant

Claude, ChatGPT or another assistant that speaks MCP: you pay your own provider; connecting to us is free.

Sign in

You can read this page without signing in. You sign in only to approve the connection, on the site.

Three steps

  1. Open your assistantOn your phone or computer, wherever you usually use it.
  2. Add the Annateca connectorIn the connector settings, with the address https://annateca.it/v1/mcp
  3. Sign in and approve what it may doThe Annateca page opens: choose the spaces and whether it may only read or also prepare changes.
It reads on its own; it prepares changes and you confirm them. Only you, on the site: delete, mark «drunk», transfer, change visibility, publish a story, write in chat, pay.

Claude

In Claude’s connector settings, add a custom connector with the address from step 2, then authorize Annateca; for the exact steps, see Claude’s own help.

A button in the Claude connector catalogue comes after the alpha; for now the address is the way.

Which Claude plans let you add a connector: see the Claude help.

ChatGPT

In ChatGPT, if your version lets you add a connector by its address, paste the address from step 2; where that option is, see ChatGPT’s own help.

A button in the ChatGPT connector catalogue comes after the alpha; for now the address is the way.

Which ChatGPT plans let you add a connector: see the ChatGPT help.

What it can read

  • Producers, wines, places, DOC and DOCG denominations and the calendar of wine events, each with its sourcewithout signing in
  • Brand and wine cards with vintages and ownersneeds an account

For developers

MCP
https://annateca.it/v1/mcp
REST
https://annateca.it/v1/api
OpenAPI
https://annateca.it/v1/api/openapi.json
claude mcp add --scope user --transport http annateca https://annateca.it/v1/mcp

In the terminal; then /mcp to sign in.

  • MCP (Streamable HTTP). Without signing in it offers the guest tools; after the person signs in and approves on the site, what the account allows.
  • REST, described in OpenAPI. Without credentials it answers as it does to a guest.
  • With a personal key (header Authorization: Bearer annateca_...) it also reads brand and wine cards. A key is created and revoked after signing in, on the connections page; it does not connect MCP.
  • Version v1 only grows; incompatible changes come as v2, next to v1.