fullmetrixDocs

Servidor MCP

Ligue o Claude, o ChatGPT ou outro assistente de IA compatível aos seus dados do Fullmetrix e consulte a sua loja a partir do assistente que já utiliza.

O servidor MCP do Fullmetrix permite que o seu assistente de IA habitual, como o Claude ou o ChatGPT, leia os seus dados do Fullmetrix. Depois de ligado, faz as suas perguntas no Claude ou no ChatGPT, por exemplo "Que produtos venderam mais em setembro?", e o assistente vai buscar a resposta aos seus números.

MCP significa Model Context Protocol. É uma norma aberta que define como um assistente de IA se liga a uma fonte de dados. Qualquer assistente compatível com MCP pode, por isso, ligar-se ao Fullmetrix da mesma forma.

O acesso é só de leitura. O assistente pode ler os seus dados, mas não pode alterar nada no Fullmetrix, na sua loja nem nas suas contas de anúncios.

Prefere ficar no Fullmetrix?

O assistente de IA integrado no Fullmetrix faz o mesmo trabalho sem sair da aplicação e acrescenta gráficos e relatórios partilháveis. O servidor MCP serve para quando quer trabalhar a partir do assistente que já utiliza.

O endereço do servidor

Todos os clientes usam o mesmo endereço.

https://app.fullmetrix.com/api/mcp

O servidor funciona sobre HTTP, no modo a que os clientes MCP chamam "Streamable HTTP". Há duas formas de ligar.

  • Com a sua conta Fullmetrix. O cliente envia-o para uma página do Fullmetrix onde autoriza o acesso. É o método recomendado, sem chave para copiar.
  • Com uma chave API, para os clientes que não conseguem abrir uma página de início de sessão. Veja abaixo.

Antes de começar

Precisa de uma conta Fullmetrix com pelo menos uma organização cuja loja esteja ligada e sincronizada. O assistente lê os dados das suas organizações, por isso precisa de dados para ler.

O acesso MCP faz parte da sua subscrição do Fullmetrix, sem custo adicional. A utilização do Claude ou do ChatGPT continua a ser faturada pelos seus criadores, de acordo com o seu plano junto deles.

Ligue o Claude

Abrir a ficha Fullmetrix

O Fullmetrix Analytics está publicado no diretório da Claude. Abra a página, ou procure Fullmetrix na Claude, na secção de conectores das definições.

Adicionar o conector

Clique no botão de adicionar. A Claude abre uma página Fullmetrix. Inicie sessão se necessário e autorize o acesso como descrito na secção seguinte.

Fazer uma pergunta

Numa nova conversa, verifique se o conector Fullmetrix está ativado e faça a sua pergunta.

Consoante o seu plano Claude, adicionar conectores pode estar reservado a certas subscrições ou ao administrador do espaço da sua equipa. O endereço https://app.fullmetrix.com/api/mcp continua a funcionar como conector personalizado se preferir adicioná-lo à mão.

Ligue o ChatGPT

O ChatGPT aceita servidores MCP como uma aplicação personalizada, também chamada conector.

Abra as definições das aplicações

No ChatGPT, abra as definições e depois a secção das aplicações e conectores. Consoante o seu plano, para adicionar uma aplicação personalizada pode ser preciso ativar primeiro o modo de programador nas definições avançadas.

Crie a aplicação

Crie uma nova aplicação. Dê-lhe o nome Fullmetrix, cole o endereço https://app.fullmetrix.com/api/mcp e escolha a autenticação OAuth. Confirme.

Autorize o acesso

O ChatGPT abre a página do Fullmetrix. Inicie sessão se necessário e depois autorize o acesso.

Use o Fullmetrix numa conversa

Numa conversa, adicione a aplicação Fullmetrix a partir do menu de ferramentas e faça a sua pergunta.

Os menus do ChatGPT mudam com frequência. Se não encontrar a opção, pesquise "conector personalizado" ou "MCP" na ajuda do ChatGPT.

Ligue outro cliente MCP

O Cursor, o Visual Studio Code, o Windsurf e a maioria das ferramentas compatíveis com MCP configuram-se com o endereço do servidor. No ficheiro de configuração MCP da sua ferramenta, declare um servidor remoto assim.

{
  "mcpServers": {
    "fullmetrix": {
      "url": "https://app.fullmetrix.com/api/mcp"
    }
  }
}

Os nomes exatos das chaves podem variar de uma ferramenta para outra. Consulte a respetiva documentação. Na primeira utilização, a ferramenta abre a página de autorização do Fullmetrix no seu navegador.

Ligue com uma chave API

Se o seu cliente não suportar o início de sessão com a conta, use uma chave API. Crie-a em Definições, separador Chaves API, como descrito em API pública. Depois adicione-a ao cabeçalho Authorization dos pedidos do cliente.

{
  "mcpServers": {
    "fullmetrix": {
      "url": "https://app.fullmetrix.com/api/mcp",
      "headers": {
        "Authorization": "Bearer fmx_YOUR_KEY"
      }
    }
  }
}

Uma chave dá acesso a uma única organização, aquela onde a criou. O início de sessão com a conta dá acesso a todas as suas organizações.

A página de autorização

Quando um cliente se liga com a sua conta, o Fullmetrix mostra a página Connect an external application. Se não tiver sessão iniciada no Fullmetrix, a página de início de sessão vem primeiro.

A página descreve o que a aplicação pede.

  • Read analytics data, ou seja, ver as suas lojas, clientes, produtos, encomendas, campanhas, custos e dados dos serviços ligados.
  • Access authorized organizations. Só ficarão disponíveis as organizações a que já tem acesso no Fullmetrix.

Um aviso lembra que o acesso é só de leitura. Clique em Authorize access para confirmar ou em Deny para cancelar. É depois reencaminhado automaticamente para o seu cliente.

Se aparecer a mensagem "The authorization could not be completed. Please try again.", reinicie a ligação a partir do seu cliente.

Que organizações ficam disponíveis

O início de sessão com a conta abre o acesso às organizações que vê no Fullmetrix. São as organizações da sua empresa se for administrador e aquelas a que um administrador lhe deu acesso. O assistente nunca vê uma organização que não consiga ver por si próprio. Para gerir estes acessos, consulte Equipa e funções.

Se tiver várias organizações, indique a loja ou a organização na sua pergunta. Caso contrário, o assistente consulta a primeira da lista.

As ferramentas expostas

Um cliente MCP descobre ferramentas, ou seja, ações que pode chamar. O Fullmetrix expõe três, todas só de leitura.

FerramentaO que faz
describe_dataDescreve os dados disponíveis e os serviços ligados às suas organizações. O assistente chama-a antes da primeira pergunta
query_dataLê os dados da sua loja no Fullmetrix, como encomendas, linhas de encomenda, produtos, variações, categorias, clientes, contactos, carrinhos, códigos de desconto, reembolsos, subscrições e navegação dos visitantes. Lê também os dados de configuração da sua conta Fullmetrix
platform_queryConsulta um serviço ligado, entre Google Ads, Meta Ads, TikTok Ads, ChatGPT Ads, Google Analytics 4, Search Console e Crisp. Se tiver várias contas no mesmo serviço, consulta-as todas, a menos que indique uma

Não chama estas ferramentas por si próprio. Faz uma pergunta em linguagem corrente e o assistente escolhe as ferramentas e as consultas.

Os números vêm dos mesmos dados que os seus relatórios. Para que o assistente coincida exatamente com os seus números, peça-lhe que aplique as regras das suas definições dos relatórios, por exemplo excluindo as encomendas canceladas.

Exemplos de perguntas

  • Qual foi a minha receita em setembro, em comparação com setembro do ano passado?
  • Quais são os meus 10 produtos mais vendidos neste trimestre, com a respetiva receita?
  • Compare o meu investimento no Meta Ads e as minhas vendas dia a dia nos últimos 30 dias.
  • Que pesquisas do Search Console trazem mais cliques às minhas fichas de produto?
  • Resuma os pedidos recebidos no Crisp esta semana.

Corte o acesso

Para uma ligação com a conta, remova o conector Fullmetrix nas definições do seu cliente, seja o Claude, o ChatGPT ou outro.

Para uma ligação com chave API, abra Definições, separador Chaves API, e clique em Revogar junto da chave. O cliente perde o acesso de imediato.

Perguntas frequentes

Nesta página