Como conectar um AI Assistant a uma chave de API

Nem todo assistente AI pode fazer o login no FitnessSyncer MCP Server em seu nome. Muitos oferecem apenas um endereço de servidor e um campo para inserir um token, e alguns leem toda a sua configuração a partir de um arquivo no disco. Para esses casos, o FitnessSyncer emite uma chave de API, que é um único token de longa duração que substitui todo o processo de login.

É assim que o Mistral Vibe se conecta, e essa também é a solução para um assistente auto-hospedado, um cliente de linha de comando, uma estrutura de agente ou um ChatGPT que oferece um cabeçalho em vez de uma tela OAuth. O Claude, o ChatGPT, o Perplexity e o Home Assistant possuem, cada um, seu próprio processo de login; portanto, siga as instruções específicas de cada um, conforme o caso.

Antes de começar

• Uma conta FitnessSyncer com suas fontes conectadas. O MCP Server está incluído em todas as contas, portanto, não há nada a mais para comprar; consulte a seção “Introdução” caso seja novo aqui. Uma conta gratuita oferece acesso a um histórico mais curto aqui, exatamente como em todas as outras partes do site.
• Um assistente capaz de enviar um cabeçalho de autorização, ou que denomine esse mesmo elemento como “Bearer Token” ou “token de API”. Se o seu assistente puder fazer login com OAuth em vez disso, essa é a melhor opção, pois permite que o senhor escolha as permissões a cada vez, em vez de apenas uma vez.

Etapa 1: Crie sua chave de API em FitnessSyncer

1. Acesse a página “Contas de desenvolvedor”.
2. Na parte inferior da página, selecione “MCP: Chave da API” na lista e clique em “Criar”.
3. FitnessSyncer pergunta quais permissões essa chave deve ter. Selecione apenas o que deseja que o assistente faça; para responder a perguntas, as permissões de leitura são suficientes, e nada do que você deixar desmarcado poderá ser usado posteriormente sem a criação de uma nova chave.
4. Selecione “Criar chave de API” e anote a chave de API na página seguinte. Ela é exibida apenas uma vez; caso a perca, poderá regenerá-la, mas precisará inseri-la novamente no seu assistente.

  Step 2: Mistral Vibe

Com sua chave de API em mãos:

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

Etapa 2: Qualquer outro assistente que possua uma tela de configurações

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

1. Digite “FitnessSyncer” no campo “Nome”
2. Insira “https://www.fitnesssyncer.com/services/mcp” como servidor, que alguns assistentes chamam de URL do servidor remoto MCP
3. Insira sua chave de API no campo “Bearer Token”. Caso o assistente solicite um cabeçalho, o nome do cabeçalho é “Authorization” e seu valor é a palavra “Bearer”, seguida de um espaço e da sua chave de API.

Caso o assistente também solicite que o(a) senhor(a) escolha um transporte, selecione “Streamable HTTP”. O FitnessSyncer não oferece o transporte SSE, que é mais antigo.

Etapa 2: Um assistente configurado a partir de um arquivo

Muitos clientes de linha de comando e de desktop leem as configurações de seus servidores a partir de um arquivo JSON. O formato varia, portanto, consulte a documentação do seu próprio assistente, mas geralmente é assim:

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

Substitua YOUR_TOKEN_HERE pela sua chave de API, mantendo a palavra “Bearer” e o espaço antes dela.

Experimente

Inicie um novo chat e cole qualquer uma destas mensagens para verificar se tudo está funcionando:

• Liste todos os aplicativos e dispositivos aos quais FitnessSyncer está conectado no momento na minha conta e mostre quando eles foram sincronizados pela última vez.
• Como foi o meu sono esta semana em comparação com a semana passada?
• Como ficou minha frequência cardíaca em repouso ao longo do último mês?

Há muitas outras ideias na página MCP Server.