Annateca
Iniciar sessão

API · MCP

Como ligar o seu assistente

Claude, ChatGPT ou outro assistente compatível com MCP: paga-o ao seu fornecedor; a ligação connosco é grátis.

Iniciar sessão

Pode ler esta página sem iniciar sessão. Só precisa de a iniciar para aprovar a ligação, no site.

Três passos

  1. Abra o seu assistenteNo telemóvel ou no computador, onde o costuma usar.
  2. Adicione o conector da AnnatecaNas definições de conectores, com o endereço https://annateca.it/v1/mcp
  3. Inicie sessão e aprove o que pode fazerAbre-se a página da Annateca: escolha os espaços e se pode só ler ou também preparar alterações.
Lê sozinho; prepara as alterações e o senhor confirma-as. Só o senhor, no site: apagar, marcar «bebida», transferir, mudar a visibilidade, publicar uma história, escrever nas conversas, pagar.

Claude

Nas definições de conectores do Claude, adicione um conector personalizado com o endereço do passo 2 e depois autorize o Annateca; para os passos exatos, consulte a ajuda do Claude.

Um botão no catálogo de conectores de Claude chegará depois da alfa; por agora usa-se o endereço.

Que planos de Claude permitem adicionar um conector: veja a ajuda de Claude.

ChatGPT

No ChatGPT, se a sua versão permitir adicionar um conector com um endereço, cole o endereço do passo 2; onde fica essa opção, veja a ajuda do ChatGPT.

Um botão no catálogo de conectores de ChatGPT chegará depois da alfa; por agora usa-se o endereço.

Que planos de ChatGPT permitem adicionar um conector: veja a ajuda de ChatGPT.

O que pode ler

  • Produtores, vinhos, locais, denominações DOC e DOCG e o calendário de eventos do vinho, cada um com a sua fontesem iniciar sessão
  • Fichas de marcas e vinhos com colheitas e proprietáriosrequer conta

Para programadores

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

No terminal; depois /mcp para iniciar sessão.

  • MCP (Streamable HTTP). Sem iniciar sessão oferece as ferramentas para convidados; depois de a pessoa iniciar sessão e aprovar no site, o que a conta permite.
  • REST, descrito em OpenAPI. Sem credenciais responde como a um convidado.
  • Com uma chave pessoal (cabeçalho Authorization: Bearer annateca_...) lê também as fichas de marcas e vinhos. A chave cria-se e revoga-se depois de iniciar sessão, na página das ligações; não liga o MCP.
  • A versão v1 só cresce; as alterações incompatíveis chegam como v2, ao lado da v1.