Ligar um Assistente AI a uma chave API

Nem todos os assistentes AI podem iniciar sessão no FitnessSyncer MCP Server em seu nome. Muitos disponibilizam apenas um endereço de servidor e um campo para introduzir um token, e alguns leem toda a sua configuração a partir de um ficheiro no disco. Para esses casos, o FitnessSyncer emite uma chave API, que é um único token de longa duração que substitui todo o processo de início de sessão.

É assim que o Mistral Vibe se liga, e é também a solução para um assistente auto-hospedado, um cliente de linha de comandos, uma estrutura de agentes ou um ChatGPT que lhe oferece um cabeçalho em vez de um ecrã OAuth. O Claude, o ChatGPT, o Perplexity e o Home Assistant têm, cada um, o seu próprio processo de início de sessão; por isso, siga as respetivas instruções, sempre que aplicável.

Antes de começar

• Uma conta FitnessSyncer com as suas fontes associadas. O MCP Server está incluído em todas as contas, pelo que não é necessário adquirir nada adicional; consulte a secção «Introdução» se for um utilizador novo. Uma conta gratuita tem um histórico mais curto aqui, tal como acontece em todas as outras secções do site.
• Um assistente que possa enviar um cabeçalho de autorização, ou que se refira a isso como um «Bearer Token» ou um «token de API». Se o seu assistente puder, em vez disso, iniciar sessão com OAuth, essa é a melhor opção, uma vez que permite selecionar as permissões em cada ocasião, em vez de o fazer apenas uma vez.

Passo 1: Crie a sua chave API em FitnessSyncer

1. Aceda à página «Contas de programadores».
2. Na parte inferior da página, selecione «MCP: Chave API» na lista e clique em «Criar».
3. FitnessSyncer pergunta quais as autorizações que esta chave deve ter. Selecione apenas o que pretende que o assistente faça; para responder a perguntas, as autorizações de leitura são suficientes, e nada do que deixar por selecionar poderá ser utilizado posteriormente sem criar uma nova chave.
4. Selecione «Criar chave API» e anote a chave API na página seguinte. Esta só é apresentada uma vez; caso a perca, poderá regenerá-la, mas terá então de a introduzir novamente no seu assistente.

  Step 2: Mistral Vibe

Com a sua chave API em mãos:

1. No menu da esquerda, selecione «Contexto» e, em seguida, «Conectores».
2. Selecione «Adicionar conector» no canto superior direito do ecrã.
3. Selecione o conector personalizado MCP.
4. Introduza «FitnessSyncer» no campo «Nome»
5. Introduza «https://www.fitnesssyncer.com/services/mcp» para o servidor
6. Selecione «Autenticação por token de API» e cole a sua chave de API no campo «Token Bearer».

Passo 2: Qualquer outro assistente que disponha de um ecrã de definições

Os campos têm nomes diferentes de um assistente para outro, mas são sempre apenas três:

1. Introduza «FitnessSyncer» no campo «Nome»
2. Introduza «https://www.fitnesssyncer.com/services/mcp» no campo «Servidor», que alguns assistentes designam como o URL do servidor remoto MCP
3. Introduza a sua chave API no campo «Bearer Token». Se o assistente solicitar, em vez disso, um cabeçalho, o nome do cabeçalho é «Authorization» e o seu valor é a palavra «Bearer», seguida de um espaço e da sua chave API.

Caso o assistente também lhe peça para escolher um protocolo de transporte, selecione «Streamable HTTP». O FitnessSyncer não disponibiliza o protocolo de transporte SSE mais antigo.

Passo 2: Um assistente configurado a partir de um ficheiro

Muitos clientes de linha de comandos e de ambiente de trabalho leem as configurações dos seus servidores a partir de um ficheiro JSON. O formato varia, pelo que deve consultar a documentação do seu próprio assistente, mas normalmente tem o seguinte aspeto:

{
 "mcpServers": {
   "FitnessSyncer": {
     "transport": "http",
     "url": "https://www.fitnesssyncer.com/services/mcp",
     "headers": {
       "Authorization": "Bearer YOUR_TOKEN_HERE"
     }
   }
 }
}

Substitua YOUR_TOKEN_HERE pela sua chave API, mantendo a palavra «Bearer» e o espaço à sua frente.

Experimente

Inicie uma nova conversa e cole qualquer uma destas mensagens para verificar se tudo está a funcionar:

• Enumere todas as aplicações e dispositivos aos quais a FitnessSyncer está atualmente ligada na minha conta e indique quando foi a última vez que foram sincronizados.
• Como foi o meu sono esta semana, em comparação com a semana passada?
• Como é que a minha frequência cardíaca em repouso evoluiu ao longo do último mês?

Existem muitas mais ideias na página MCP Server.