AI 어시스턴트와 API 키 연결하기

모든 AI 어시스턴트가 사용자를 대신해 FitnessSyncer MCP Server에 로그인할 수 있는 것은 아닙니다. 대부분은 서버 주소와 토큰을 입력할 수 있는 공간만 제공하며, 일부는 디스크에 있는 파일에서 전체 구성 정보를 읽어옵니다. 이러한 경우, FitnessSyncer은 API 키를 발급하는데, 이는 전체 로그인 과정을 대신하는 단일한 장기 유효 토큰입니다.

이것이 바로 Mistral Vibe가 연결되는 방식이며, 자체 호스팅 어시스턴트, 명령줄 클라이언트, 에이전트 프레임워크, 또는 OAuth 화면 대신 헤더를 제공하는 ChatGPT에 대한 해답이기도 합니다. Claude, ChatGPT, Perplexity 및 Home Assistant은 각각 고유한 로그인 방식을 가지고 있으므로, 해당되는 경우에는 각 항목의 지침을 따르시기 바랍니다.

시작하기 전에

• 소스가 연결된 FitnessSyncer 계정입니다. MCP Server는 모든 계정에 포함되어 있으므로 별도로 구매할 필요가 없습니다. 처음 이용하시는 분은 ‘시작하기’를 참고하세요. 무료 계정의 경우, 사이트의 다른 곳과 마찬가지로 이곳에서도 확인할 수 있는 기록의 기간이 더 짧습니다.
• Authorization 헤더를 전송할 수 있거나, 이를 Bearer 토큰 또는 API 토큰이라고 부르는 어시스턴트입니다. 만약 사용 중인 어시스턴트가 OAuth을 사용하여 로그인할 수 있다면, 한 번만 권한을 설정하는 대신 매번 권한을 직접 선택할 수 있으므로 이 방법이 더 좋습니다.

1단계: FitnessSyncer에서 API 키 생성하기

1. ‘개발자 계정’ 페이지로 이동하세요.
2. 페이지 하단에서 목록에서 “MCP: API 키”를 선택하고 “생성”을 클릭하세요.
3. FitnessSyncer에서는 이 키에 어떤 권한을 부여할지 묻습니다. 어시스턴트가 수행하기를 원하는 작업만 선택하십시오. 질문에 답변하는 경우 읽기 권한만으로도 충분하며, 선택하지 않은 권한은 나중에 새 키를 생성하지 않는 한 사용할 수 없습니다.
4. ‘API 키 생성’을 선택한 다음, 다음 페이지에 표시된 API키를 메모해 두세요. 이 키는 한 번만 표시되므로, 분실할 경우 다시 생성할 수는 있지만, 그 경우 어시스턴트에 키를 다시 입력해야 합니다.

  Step 2: Mistral Vibe

API 키를 준비했다면:

1. 왼쪽 메뉴에서 ‘컨텍스트’를 선택한 다음 ‘커넥터’를 선택합니다.
2. 화면 오른쪽 상단에서 ‘커넥터 추가’를 선택하세요.
3. “사용자 지정 MCP 커넥터”를 선택하십시오.
4. 이름 란에 ‘FitnessSyncer’을 입력하세요.
5. 서버에 ‘https://www.fitnesssyncer.com/services/mcp’을 입력하십시오.
6. 'API 토큰 인증'을 선택하고 API 키를 'Bearer 토큰'에 붙여넣으세요.

2단계: 설정 화면이 있는 다른 모든 보조 기기

필드의 이름은 어시스턴트마다 다르지만, 항상 세 개뿐입니다:

1. 이름 란에 ‘FitnessSyncer’를 입력하세요.
2. 서버 항목에 ‘https://www.fitnesssyncer.com/services/mcp’를 입력하세요. 일부 어시스턴트에서는 이를 ‘원격 MCP 서버 URL’이라고 부르기도 합니다.
3. API 키를 ‘Bearer Token’ 필드에 입력하세요. 만약 어시스턴트가 헤더를 요청할 경우, 헤더 이름은 ‘Authorization’이며, 값은 ‘Bearer’라는 단어 뒤에 공백 하나를 넣고 API 키를 입력하면 됩니다.

도움이 되는 프로그램에서 전송 방식을 선택하라고 요청하면 ‘Streamable HTTP’를 선택하세요. FitnessSyncer은 구형 SSE 전송 방식을 지원하지 않습니다.

2단계: 파일을 통해 구성된 보조 프로그램

많은 명령줄 및 데스크톱 클라이언트는 JSON 파일에서 서버 정보를 읽어옵니다. 형식은 다양하므로 사용 중인 어시스턴트의 설명서를 참고하셔야 하지만, 대개 다음과 같은 형태입니다:

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

YOUR_TOKEN_HERE를 자신의 API 키로 대체하되, ‘Bearer’라는 단어와 그 앞에 있는 공백은 그대로 유지하십시오.

한 번 해보세요

새 채팅을 시작하고 다음 중 하나를 붙여넣어 모든 기능이 정상적으로 작동하는지 확인해 보세요:

• 내 계정에 FitnessSyncer이 현재 연결되어 있는 모든 앱과 기기를 나열하고, 마지막으로 동기화된 시점을 표시해 주세요.
• 지난주와 비교했을 때, 이번 주에는 잠을 어떻게 잤을까?
• 지난 한 달 동안 내 안정시 심박수는 어떻게 변했나요?

MCP Server 페이지에는 더 많은 아이디어가 있습니다.