기록을 연결하면 실제로 무엇이 달라지나
MCP 서버는 AI 어시스턴트가 이름이 붙은 도구를 통해 앱의 데이터에 접근하는 표준 방식입니다. QuietGains는 https://api.quietgains.app/mcp 에서 서버를 운영합니다. 연결하면 어시스턴트는 채팅에 붙여 넣은 내용으로 추측하지 않고 실제 기록을 읽습니다. 화요일에 기록한 세트, 지금 따르는 플랜, 오늘 먹은 것, 가장 최근 체성분 검사입니다. 변경을 요청하면 그 변경을 계정에 기록하고, 휴대폰의 앱도 그에 맞게 업데이트됩니다.
이 연결은 공식이며 저희가 직접 제공합니다. 앱에서 쓰는 것과 같은 Apple 또는 Google 계정으로 로그인하고, 복사할 API 키는 없으며, 어시스턴트가 비밀번호를 보는 일은 없습니다.
시작하기 전에 필요한 것
- Premium이 있는 QuietGains 계정. 커넥터는 Premium에 포함되어 있고, 없으면 모든 도구가 Premium이 필요하다고 답합니다.
- 로그인이 필요한 원격 MCP 서버를 지원하는 어시스턴트. Claude(웹, 데스크톱, 모바일), Claude Code, developer mode의 ChatGPT, Cursor 또는 다른 MCP 클라이언트입니다.
- Claude의 Free 요금제라면 사용자 지정 커넥터 한 개의 자리. Free 요금제의 한도가 그만큼입니다.
QuietGains를 Claude에 연결하기
- claude.ai를 열고 Settings에서 Connectors를 선택합니다.
- Add custom connector를 선택합니다. 이름을 QuietGains로 하고 서버 URL에
https://api.quietgains.app/mcp를 붙여 넣습니다. - 감지된 옵션은 그대로 둡니다. OAuth 클라이언트용 Sign in now와 Register automatically입니다. 요청 헤더는 비워 두고 Add를 선택합니다.
- QuietGains 페이지가 열립니다. Apple이나 Google로 로그인하고, 페이지에 내 어시스턴트 이름이 나오는지 확인한 뒤 Allow를 선택합니다.
- Claude로 돌아가 채팅을 열고 “QuietGains에서 내 플랜 보여 줘”라고 요청하세요. 도구가 나타나지 않으면 채팅의 + 메뉴를 열어 Connectors를 선택하고 QuietGains를 켜세요.
claude.ai에서 추가한 커넥터는 Claude 데스크톱 앱과 모바일 앱에서도 쓸 수 있습니다. Claude가 사용자 기기가 아니라 자체 클라우드에서 서버에 접근하기 때문입니다. Claude는 도구를 인터랙티브 카드를 보여 주는 것과 읽기 전용인 것으로 나누고, 커넥터 설정에서 바꾸기 전까지 호출마다 확인을 요청합니다. 읽기 전용 도구는 항상 허용하고, 쓰기 작업에는 승인을 남겨 두는 설정이 합리적입니다.
QuietGains를 ChatGPT에 연결하기
ChatGPT는 웹의 developer mode를 통해 사용자 지정 MCP 서버를 추가합니다. OpenAI는 이를 Business, Enterprise, Edu 워크스페이스 기준으로 안내하며, 관리자가 developer mode를 켜고 앱을 만듭니다. 개인 요금제에서의 제공 여부는 여러 번 바뀌었으니 자신의 계정에 대해서는 OpenAI의 현재 도움말 페이지를 확인하세요. developer mode를 켠 다음 같은 주소로 앱을 만들고, 인증으로 OAuth를 선택하고, 같은 QuietGains 로그인을 끝내면 됩니다.
Claude Code, Cursor, 다른 MCP 클라이언트에서 연결하기
Claude Code에서는 claude mcp add --transport http quietgains https://api.quietgains.app/mcp 를 실행한 다음 /mcp 를 열고 QuietGains를 선택하면 브라우저에서 로그인할 수 있습니다. Cursor와 대부분의 다른 클라이언트도 MCP 설정에서 같은 주소를 원격 또는 HTTP 서버로 받습니다. MCP 인증 표준을 따르는 클라이언트는 로그인 페이지를 스스로 찾습니다. 따로 설정할 것은 없습니다.
연결한 뒤에 물어볼 수 있는 것
| 요청 | 일어나는 일 |
|---|---|
| 지난 Pull A 어땠어? | 그 운동을 읽습니다. 소요 시간, 중량과 횟수가 포함된 모든 세트, 총 볼륨입니다. |
| 이번 주 플랜 보여 줘 | 지금 쓰는 플랜을 하루씩 읽습니다. 세트, 횟수 범위, 목표 중량까지 포함합니다. |
| 8월부터 벤치프레스는 어떻게 바뀌었어? | 그 종목의 기록과 개인 최고 기록을 읽습니다. |
| 목요일 레그 익스텐션을 불가리안 스플릿 스쿼트로 바꿔 줘 | 승인을 요청한 뒤 같은 자리의 종목만 바꾸고, 그날의 나머지는 그대로 둡니다. |
| 아침으로 달걀 2개와 커피 기록해 줘 | 음식 데이터베이스를 검색하고 승인을 요청한 뒤 오늘 기록에 추가합니다. |
| 어제 먹은 걸 목표랑 비교해 줘 | 그날의 음식과 물을 칼로리·매크로 목표와 나란히 읽습니다. |
| 최근 InBody 검사 두 개 비교해 줘 | 체성분 검사 두 건을 체중, 근육량, 체지방량과 함께 읽습니다. |
도구는 평소라면 다시 입력해야 할 앱의 영역을 다룹니다. 운동과 개인 기록, 종목 기록, 플랜(읽기, 만들기, 수정, 사용 중인 플랜 바꾸기), 직접 만든 종목을 포함한 종목 라이브러리, 음식과 물, 체성분 검사, 운동 장소, 배지입니다. MCP Apps를 표시하는 Claude와 다른 클라이언트에서는 운동, 플랜, 종목 추이, 하루 식단이 채팅의 라이트 또는 다크 테마를 따르는 QuietGains 카드로 돌아오고, 카드마다 앱의 같은 화면을 여는 Open in QuietGains 버튼이 있습니다. 그 밖에서는 정돈된 텍스트로 돌아옵니다.
변경이 휴대폰에 도달하는 방식
쓰기를 하는 도구에는 모두 표시가 있어, 어시스턴트가 실행 전에 승인 확인을 보여 줍니다. 승인된 변경은 곧바로 계정에 저장되며, 앱이 iPhone에서 한 변경을 저장하는 것과 같습니다. 플랜 수정은 각 일차와 각 종목을 자리에 그대로 두므로, 앱의 다음 운동 일차와 자리에 연결된 기록은 그대로 남습니다. QuietGains 1.0.5 이상에서는 보통 백그라운드에서 잠시 만에 업데이트됩니다. 그 이전 버전에서는 다음에 앱을 열 때 변경이 보입니다.
같은 플랜을 휴대폰과 어시스턴트에서 같은 순간에 바꾸면 서버의 더 새로운 사본이 남고, 휴대폰은 자신의 다음 운동 일차만 유지합니다. 운동에서 기록한 내용이 플랜 수정으로 덮어써지는 일은 없습니다.
개인정보와 제어
- 로그인은 OAuth를 사용합니다. 어시스턴트가 받는 토큰은 MCP 서버에서만 유효하고, 앱 자체의 API에는 쓸 수 없습니다.
- QuietGains 로그인 페이지는 어떤 앱이 요청하는지와 어느 주소로 돌아가는지를 Allow를 선택하기 전에 보여 줍니다.
- 서버는 사용자 본인의 기록만 돌려줍니다. 세트나 음식, 날짜를 만들어 내지 않고, 기록에 없는 것은 없다고 분명히 답합니다.
- 연결을 끊으려면 어시스턴트의 커넥터 설정에서 QuietGains를 삭제하세요. QuietGains 계정을 삭제하면 모든 연결이 끝납니다.
커넥터가 하지 않는 일
QuietGains는 사용자의 기록과 종목 카탈로그를 돌려줄 뿐, 운동이나 영양, 의료에 관한 조언은 하지 않습니다. 그 기록을 두고 어시스턴트가 하는 말은 어시스턴트 자신의 출력이므로, 제안된 변경도 다른 제안과 똑같이 받아들이고 승인 확인을 읽은 뒤에 수락하세요. 개인에게 맞춘 지도가 필요하다면, 그것은 직접 운동을 볼 수 있는 자격 있는 코치의 몫입니다.
문제가 생길 때
| 보이는 것 | 할 일 |
|---|---|
| 모든 도구가 커넥터는 Premium에 포함된다고 답함 | 앱에서 Premium을 구독하거나 복원한 뒤 다시 물어보세요. 다시 연결할 필요는 없습니다. |
| 로그인 페이지에 링크가 만료되었다고 표시됨 | 어시스턴트에서 연결을 다시 시작하세요. 로그인 링크는 한 번만 유효합니다. |
| 채팅에 도구가 전혀 나타나지 않음 | 그 대화에서 커넥터가 켜져 있는지 확인하고 새 채팅을 시작하세요. |
| 수정이 휴대폰에 보이지 않음 | QuietGains를 열어 동기화되게 하고, 휴대폰이 같은 계정으로 로그인되어 있는지 확인하세요. |
기록을 막 시작했다면 물어볼 거리가 생기도록 운동 기록 템플릿부터 시작하세요. 어시스턴트에게 종목을 비교해 달라고 하기 전에 추정 1RM, 볼륨, 횟수 기록이 어떻게 다른지도 확인해 두면 좋습니다.