A tua plataforma, na conversa

Pergunta aos teus dados.

Liga o ChatGPT ou o Claude para analisar vendas, produtos, canais, descontos e anulacoes. Entra com a tua conta da plataforma e autoriza o acesso de leitura.

Endereco para adicionar a ligacao:

https://mcp.gcpai.pt/mcp

ChatGPT

Em Settings / Definicoes, abre Security and login e ativa Developer mode, se disponivel.
Abre Plugins (ou Apps, conforme a interface), seleciona + / Criar e da o nome Capricciosa.
Introduz o endereco acima, usa OAuth e conclui a autorizacao com a tua conta Capricciosa. Nao precisas de preencher Client ID ou Client Secret manualmente.
Confirma a descoberta de oito ferramentas. Numa conversa nova, seleciona a ligacao e faz a tua pergunta.

A disponibilidade depende da conta e das definicoes do workspace.

Guia oficial do ChatGPT

Claude

Abre Customize / Personalizar e Connectors / Conectores.
Seleciona Add custom connector e introduz o endereco acima.
Liga a conta e autoriza a leitura.
Ativa o conector na conversa.

Em Team ou Enterprise, o responsavel do workspace adiciona primeiro o conector.

Guia oficial do Claude

Teste inicial

Pede: Usa Capricciosa para listar as lojas e os respetivos IDs.
Pede: Consulta as vendas de 19-08-2026 da loja 3 (Docas), indica os filtros e distingue valores com e sem IVA.
Compara o resultado com a plataforma, usando exatamente a mesma loja, periodo e filtros. Nao assumes que documentos e agregados tem a mesma definicao.
Pede para alterar uma venda: o conector deve explicar que apenas permite leitura, sem efetuar qualquer alteracao.

Experimenta perguntar

Compara as vendas da ultima semana entre as lojas.
Quais foram os produtos mais vendidos nas Docas?
Qual foi o peso de delivery nas vendas de ontem?
Mostra as anulacoes e descontos do mes.

O que autorizas

Acesso de leitura aos dados de todas as lojas da plataforma. Os resultados consultados seguem para o servico de IA escolhido. A palavra-passe e a chave interna da API nao sao devolvidas ao cliente de IA.

Os tokens de acesso duram 10 minutos. A ligacao pode ser renovada durante 30 dias. Para a terminar, desliga o conector nas definicoes do cliente.

Se a ligacao falhar

Confirma que consegues entrar na plataforma, que tens acesso atribuido e que o teu workspace permite conectores personalizados. Volta a ligar se a autorizacao tiver expirado.

Esta pagina descreve a instalacao por URL. A publicacao nos diretorios do ChatGPT e Claude e um processo separado; ainda nao existe uma listagem publica deste conector.