Annateca
Accedi

API · MCP

Come collegare il vostro assistente

Claude, ChatGPT o un altro assistente che conosce MCP: lo pagate voi al vostro fornitore, da noi il collegamento è gratis.

Accedi

Questa pagina si legge anche senza accedere. L’accesso serve solo per approvare il collegamento, sul sito.

Tre passi

  1. Aprite il vostro assistenteSul telefono o sul computer, dove lo usate di solito.
  2. Aggiungete il connettore AnnatecaNelle impostazioni dei connettori, con l’indirizzo https://annateca.it/v1/mcp
  3. Accedete e approvate cosa può fareSi apre la pagina di Annateca: scegliete gli spazi e se può solo leggere o anche preparare modifiche.
Legge da solo; le modifiche le prepara e le confermate voi. Solo voi, sul sito: cancellare, segnare «bevuta», trasferire, cambiare la visibilità, pubblicare una storia, scrivere in chat, pagare.

Claude

Nelle impostazioni dei connettori di Claude aggiungete un connettore personalizzato con l’indirizzo del passo 2, poi autorizzate Annateca; i passaggi esatti sono nella guida di Claude.

Un pulsante nel catalogo dei connettori di Claude arriverà dopo l’alfa; per ora si usa l’indirizzo.

Quali piani di Claude permettono di aggiungere un connettore: vedete l’aiuto di Claude.

ChatGPT

In ChatGPT, se la vostra versione permette di aggiungere un connettore con un indirizzo, incollate l’indirizzo del passo 2; dove si trova la voce, vedete l’aiuto di ChatGPT.

Un pulsante nel catalogo dei connettori di ChatGPT arriverà dopo l’alfa; per ora si usa l’indirizzo.

Quali piani di ChatGPT permettono di aggiungere un connettore: vedete l’aiuto di ChatGPT.

Cosa può leggere

  • Produttori, vini, luoghi, denominazioni DOC e DOCG e calendario degli eventi del vino, ognuno con la sua fontesenza accedere
  • Schede di marchi e vini con annate e proprietariserve l’account

Per gli sviluppatori

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

Nel terminale; poi /mcp per accedere.

  • MCP (Streamable HTTP). Senza accedere offre gli strumenti per gli ospiti; dopo che la persona accede e approva sul sito, ciò che il suo account permette.
  • REST, descritto in OpenAPI. Senza credenziali risponde come a un ospite.
  • Con una chiave personale (intestazione Authorization: Bearer annateca_...) legge anche le schede di marchi e vini. La chiave si crea e si revoca dopo l’accesso, nella pagina dei collegamenti; non collega l’MCP.
  • La versione v1 si limita a crescere; le modifiche incompatibili arrivano come v2, accanto a v1.