API · MCP
Comment connecter votre assistant
Claude, ChatGPT ou un autre assistant compatible MCP : vous le payez à votre fournisseur ; la connexion chez nous est gratuite.
Vous pouvez lire cette page sans vous connecter. La connexion ne sert qu’à approuver le raccordement, sur le site.
Trois étapes
- Ouvrez votre assistantSur le téléphone ou l’ordinateur, là où vous l’utilisez d’habitude.
- Ajoutez le connecteur AnnatecaDans les réglages des connecteurs, avec l’adresse https://annateca.it/v1/mcp
- Connectez-vous et approuvez ce qu’il peut faireLa page d’Annateca s’ouvre : choisissez les espaces et s’il peut seulement lire ou aussi préparer des modifications.
Claude
Dans les réglages des connecteurs de Claude, ajoutez un connecteur personnalisé avec l’adresse de l’étape 2, puis autorisez Annateca ; pour les étapes exactes, consultez l’aide de Claude.
Un bouton dans le catalogue de connecteurs de Claude viendra après l’alpha ; pour l’instant, on utilise l’adresse.
Quels forfaits de Claude permettent d’ajouter un connecteur : voyez l’aide de Claude.
ChatGPT
Dans ChatGPT, si votre version permet d’ajouter un connecteur par son adresse, collez l’adresse de l’étape 2 ; pour savoir où se trouve l’option, voyez l’aide de ChatGPT.
Un bouton dans le catalogue de connecteurs de ChatGPT viendra après l’alpha ; pour l’instant, on utilise l’adresse.
Quels forfaits de ChatGPT permettent d’ajouter un connecteur : voyez l’aide de ChatGPT.
Ce qu’il peut lire
- Producteurs, vins, lieux, appellations DOC et DOCG et calendrier des événements du vin, chacun avec sa sourcesans connexion
- Fiches de marques et de vins avec millésimes et propriétairescompte requis
Pour les développeurs
- 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
Dans le terminal ; puis /mcp pour vous connecter.
- MCP (Streamable HTTP). Sans connexion, il offre les outils pour invités ; une fois la personne connectée et le raccordement approuvé sur le site, ce que le compte permet.
- REST, décrit en OpenAPI. Sans identifiants, il répond comme à un invité.
- Avec une clé personnelle (en-tête Authorization: Bearer annateca_...), il lit aussi les fiches de marques et de vins. La clé se crée et se révoque après connexion, sur la page des raccordements ; elle ne connecte pas MCP.
- La version v1 ne fait que s’enrichir ; les changements incompatibles arrivent en v2, à côté de v1.