지원

연결, 판단 방식, 계정 도움말

앱의 각 기능을 단계별로 설명해요: 도움말 글

ShotPulled 작동 방식

기본 흐름

기록하고, 맛보고, 하나만 바꾸기

모든 샷은 도징량, 추출량, 시간으로 이루어져요. 맛이 어땠는지 알려 주면 엔진이 가장 그럴듯한 원인을 순서대로 보여 주고, 얼마나 확신하는지 알려 주고, 다음 샷에서 바꿀 한 가지를 정해 줘요.

조언 뒤의 원칙

왜 하나만 바꿀까요

분쇄도와 추출량을 함께 바꾸면 다음 샷에서 알 수 있는 게 없어요. 좋아져도 어느 쪽 덕분인지 모르고, 좋아지지 않아도 무엇을 되돌려야 할지 몰라요. 샷마다 변수 하나, 그게 방법의 전부예요.

“미확인”의 의미

엔진은 믿을 수 없는 분쇄도로는 세팅하지 않아요. 그라인더를 등록할 때나 조절 링을 움직인 뒤에는 조절 링 위치를 알려 주고 측정으로 표시하세요. 그 전까지 진단은 막혀 있어요.

숫자의 출처

카탈로그에는 그라인더 66종, 머신 126종, 저울 17종이 있고, 모든 항목을 제조사 설명서와 대조해 확인했어요. 제조사가 공개하지 않은 수치는 추측하지 않고 비워 둬요. 편집할 수 없는 값은 미리 채우지 않고, 직접 바꾼 값은 내 값으로 표시돼요.

냉동하면 시계가 멈춰요

봉투의 숙성 일수가 모든 신선도 판단의 기준이에요. 냉동실에 있던 날은 빠지기 때문에, 6일차에 냉동한 봉투는 해동해도 여전히 6일차예요.

무료인가요?

네. 휴대폰 앱, 웹 대시보드, AI 어시스턴트 연결까지 모두 ShotPulled가 성장하는 동안 무료예요. 언젠가 요금을 받더라도 새로운 기능에 대해서만이고, 이미 쓰고 있는 것에는 절대 받지 않아요. 피드도, 연속 기록 챌린지도, 광고도 없어요.

돈이 드는 것은 직접 쓰는 어시스턴트뿐이에요. ChatGPT는 플러그인을 설치할 수 있는 요금제가 필요하고, Claude는 필요 없어요.

어시스턴트 연결

같은 단계를 도움말 글로도 볼 수 있어요: ChatGPT 또는 Claude 연결

ShotPulled는 하나의 엔드포인트에서 Model Context Protocol을 사용하고, 아래의 모든 클라이언트는 대시보드와 앱과 같은 계정으로 같은 엔드포인트에 연결해요.

서버 URL: https://mcp.shotpulled.com/mcp
로그인: Clerk를 통한 OAuth 2.1이며, 서버에서 자동으로 찾아요. 클라이언트 ID 및 클라이언트 시크릿 칸은 비워 두세요.

ChatGPT

무료 ChatGPT 계정과 무료 ShotPulled 계정으로 작동해요.

OpenAI는 더 이상 요금제 규칙을 공개하지 않아요. 플러그인을 설치할 수 있는지는 요금제, 워크스페이스, 역할, 지역에 따라 달라지고, 그중 하나가 이유라면 연결 버튼이 그냥 회색으로 표시돼요. 회색이라면 그런 경우이고, 이쪽에서 바꿀 수 있는 것은 없어요. (ChatGPT는 2026년 7월에 앱 디렉터리를 플러그인 디렉터리에 통합했으므로 그 이름이 보일 거예요.)

ChatGPT 플러그인 디렉터리의 ShotPulled 페이지를 열고 연결 버튼을 클릭하세요.
대시보드와 같은 이메일의 ShotPulled 계정으로 로그인하세요.
어떤 대화에서든 @ShotPulled을(를) 입력해 불러오세요.
ChatGPT가 쓰기 전에 승인 카드를 보여 주면 허용하세요. 거절하면 대화는 잘된 것처럼 보여도 아무것도 기록되지 않아요. 묻는지 여부는 앱 권한 설정에 따라 다르며, 기본 설정의 새 계정에서는 묻지 않아요.

스크린샷 준비 중 ChatGPT 플러그인 디렉터리의 ShotPulled 페이지와 연결 버튼.

먼저 이렇게 말해 보세요 @ShotPulled 도징 18g, 추출 36g, 30초, 신맛 났어 기록해 줘.

웹과 데스크톱의 Claude

무료 요금제를 포함한 모든 Claude 요금제에서 작동해요. 다만 무료 계정은 커스텀 커넥터를 한 번에 하나만 추가할 수 있어요.

ShotPulled는 아직 Claude 커넥터 디렉터리에 없으므로 커스텀 커넥터로 추가해요. 항목 다섯 개만 채우면 그 뒤로는 모든 기능이 똑같이 작동해요.

Claude에서 설정 → 커넥터 메뉴를 여세요.
추가, 이어서 커스텀 커넥터 추가 항목을 클릭하세요. 페이지의 버튼이 아니라 그 메뉴 안의 항목이에요.
이름: ShotPulled
원격 MCP 서버 URL: https://mcp.shotpulled.com/mcp
클라이언트 ID와 클라이언트 시크릿은 비워 두세요. 추가 버튼, 이어서 연결 버튼을 클릭하고 로그인하세요.

스크린샷 준비 중 이름과 원격 MCP 서버 URL을 채운 Claude의 커스텀 커넥터 추가 대화상자.

먼저 이렇게 말해 보세요 Kenya Nyeri AA 봉투를 방금 열었어. 12일에 로스팅했어. 등록하고 언제 마시기 좋을지 알려 줘.

iPhone과 Android의 Claude

설치할 것은 없지만, 휴대폰에서 추가할 수는 없어요.

2026년 9월 4일에 확인한 Anthropic의 공식 답변: 웹이나 데스크톱에서 추가한 커넥터는 “다음에 iOS 또는 Android용 Claude에서 계정에 로그인할 때 사용할 수 있으며”, 모바일에서 커넥터를 설치하는 기능은 아직 베타이고 웹과 데스크톱이 주된 방법이에요. 그러니 위의 다섯 항목을 컴퓨터에서 한 번 채운 뒤 휴대폰에서 로그인하면 바로 있어요.

먼저 이렇게 말해 보세요 다음 샷에 뭘 바꿔야 할까?

Claude Code 및 기타 MCP 클라이언트

streamable HTTP를 지원하는 클라이언트라면 무엇이든. 붙여 넣을 키는 없어요.

로그인 방식은 서버(/.well-known/oauth-protected-resource)에서 자동으로 찾으므로, OAuth를 지원하는 클라이언트는 브라우저를 열고 알아서 마무리해요. Claude Code에서는 명령어 하나면 돼요:

claude mcp add --transport http shotpulled https://mcp.shotpulled.com/mcp

그 밖의 곳에서는 위의 URL을 입력하고 전송 방식은 streamable-http 방식으로 지정하세요.

먼저 이렇게 말해 보세요 이번 주에 추출한 샷을 모두 보여 주고, 나아지고 있는지 알려 줘.

“로그인은 됐는데 내 데이터가 하나도 안 보여요”

거의 항상 계정이 두 개인 경우예요. 어시스턴트는 한 이메일로 로그인했고, 대시보드는 다른 이메일 아래에 샷을 갖고 있는 거죠. 보통 하나는 Google로, 다른 하나는 비밀번호로 가입했거나, 하나는 몇 달 전에 휴대폰에서 만들었기 때문이에요. 문의하기 전에 양쪽의 주소를 확인하세요. 대시보드에서는 설정에 나오고, 어시스턴트에게 “어떤 계정으로 로그인돼 있어?”라고 물으면 다른 쪽을 알 수 있어요. 어느 경우든 잃어버린 것은 없고, 잘못된 계정을 써 왔다면 이메일로 알려 주면 정리해 드릴 수 있어요.

판단 방식

추천은 언어 모델이 쓰지 않아요. 버전이 관리되는 결정론적 지식 베이스에서 나오므로, 같은 봉투와 같은 장비로 추출한 같은 샷은 오늘도, 다음 달에도, 다른 사람 계정에서도 같은 답을 내요. 어시스턴트는 말하는 역할(기록을 읽어 주고, 맛을 묻고, 답을 다듬는 일)을 하지만 결정은 하지 않으며, 말로 엔진의 결정을 바꿀 수도 없어요.

모든 추천은 적용한 규칙을 밝히고, 그 규칙을 읽어 볼 수 있어요. 오직 그 목적의 도구가 세 개 있어요. get_rule 도구는 id로 규칙의 내용을 돌려주고, get_kb_version 도구는 어느 지식 베이스 릴리스가 답했는지 알려 주고, kb_changelog 도구는 릴리스 사이에 무엇이 바뀌었는지 알려 줘요. 어시스턴트에게 “방금 그건 어떤 규칙이고, 뭐라고 쓰여 있어?”라고 물으면 가져와요. 검증할 수 없는 답은 의견일 뿐이에요. 이 답에는 출처가 있어요.

안전장치는 프롬프트로 권하는 게 아니라 서버에서 강제하므로, 어떻게 말해도 피해 갈 수 없어요. 이름을 알아 둘 만한 두 가지. G1, 상태 확인 관문: 엔진이 아는 그라인더 설정값이 기억 또는 추정 값뿐이면, 조절 링을 측정해 알려 줄 때까지 세팅을 아예 거부해요. 출발점을 모르는 상태에서 자신 있게 내놓은 숫자는 봉투 하나를 통째로 낭비하게 만드는 바로 그 실패예요. G3/G4, 마이크론 수치 지어내지 않기: 버 형상은 내부에만 두고 절대 마이크론 수치는 내보내지 않아요. 정직한 단위는 내 조절 링의 클릭이고, 나머지는 측정값처럼 꾸민 숫자일 뿐이기 때문이에요. 이와 함께 G2는 사이에 샷 없이 곱게↔굵게를 오가는 것을 막아요. 한 번에 하나만 바꾸는 원칙의 절반을 기계가 강제하는 셈이에요.

자주 묻는 질문

내 그라인더와 머신에서도 되나요?

카탈로그에 있는 장비: 그라인더 66종, 머신 126종, 저울 17종. 모두 제조사 매뉴얼과 대조해 확인했고, 카탈로그에 없는 장비는 1분 정도면 직접 등록할 수 있어요. 직접 등록한 그라인더도 똑같이 대우받아요. 눈금 방식과 어느 쪽이 곱게인지 알려 주면 거기서부터 클릭 계산을 해요. 카탈로그의 모든 그라인더와 머신에는 제조사 매뉴얼에 나온 청소와 관리 내용을 정리한 페이지가 있어요.

어떤 저울이 Bluetooth로 연결되나요?

Bookoo, Decent, DiFluid, Felicita, Timemore 및 Varia. 휴대폰 앱이 실제로 프로토콜을 해석한 저울들이고, 단순히 무선 칩만 있는 저울보다 목록이 짧아요. 세상의 모든 저울은 다른 방법으로 쓸 수 있어요. 숫자를 직접 입력하면 돼요. ShotPulled의 어떤 기능도 연결된 저울이 필요하지 않아요.

왜 샷마다 하나만 바꾸나요?

두 가지를 바꾸면 아무것도 알 수 없기 때문이에요. 다음 샷이 나아져도 어느 쪽 덕분인지 모르고, 나빠져도 어느 쪽을 되돌려야 할지 몰라요. 이게 방법의 전부이고, 위의 조언 뒤의 규칙에서 설명해요.

휴대폰 앱이 꼭 필요한가요?

아니요. 웹 대시보드와 어시스턴트는 각각 그 자체로 완전해요. 장비 등록, 샷 기록, 시음, 레시피 고정, 기록 보기. 앱은 Bluetooth 저울, 신호 없이 작동하기, 그리고 머신 앞에서 주머니 속에 있다는 점을 더해요.

Android 앱이 있나요?

네, Google Play에서 무료로, Android 8.0 이상. iPhone 앱, 웹 대시보드, 어시스턴트와 같은 계정이라 이미 기록한 것은 모두 그대로 있어요.

그라인더를 청소하면 고정된 레시피는 어떻게 되나요?

레시피는 그대로 남고, 더는 정확한 척하지 않아요. 버를 분리하는 청소만 영향을 줘요. 백플러시도 같은 방식으로 기록되지만 아무것도 바꾸지 않아요. 하지만 핸드 그라인더의 진짜 0점은 버가 맞닿는 지점이고, 재조립할 때 조절 링의 눈금이 그 지점에 대해 어디에 놓일지가 정해지므로, 지난주에 기록한 숫자가 오늘은 다른 간격을 뜻할 수 있어요.

청소를 기록하면 그 전에 고정한 모든 레시피의 설정값이 우연히 틀린 숫자 대신 알 수 없음 상태로 표시돼요. 다시 쓰는 것은 없어요. 고정한 것은 여전히 고정한 그대로이고, 표시할 때마다 그 이후의 청소를 거쳐 값을 계산해요. 청소 후 조절 링을 한 번 측정하면 모두 다시 돌아와요.

한 번의 청소에서 그 측정을 건너뛰면, 이후 모든 청소에 걸쳐 연결이 끊긴 채로 남아요. 근사치가 아니라 알 수 없음이에요. 의도한 거예요. “아무도 확인하지 않음”과 “측정했고 변화 없음”은 같은 숫자를 내지만 신뢰도는 정반대라서, 절대 같아 보이지 않게 해요.

Beanconqueror에서 가져올 수 있나요?

아직은 안 되고, 지금은 어떤 종류의 가져오기도 없어요. 옮겨 오는 중이라면 가장 빠르고 정직한 방법은 실제로 마시고 있는 봉투를 등록하고 지금부터 기록하는 거예요. 엔진은 내 장비로 추출한 샷이 몇 개는 있어야 말할 게 생기는데, 다른 그라인더 위치에서 추출한 예전 샷으로는 그게 안 돼요.

이건 “AI”인가요?

대화는 AI예요. 조언은 아니에요. 조언은 판단 방식에서 설명하는 규칙집에서 나오고, 어시스턴트는 그 규칙집의 출처가 아니라 창구예요.

계정은 어떻게 삭제하나요?

웹 대시보드나 휴대폰 앱의 설정에서 계정 삭제 버튼을 누르세요. 직접 할 수 있고, 계정에 속한 모든 것이 지워지며, 되돌릴 수 없어요. 내보내기 등은 아래의 내 데이터와 계정을 참고하세요.

ShotPulled는 한 사람이 운영하므로, 지원은 헬프데스크가 아니라 이메일 주소예요. 코드를 쓴 사람에게 직접 쓰는 셈이죠. 무엇을 시도했고 어떤 일이 있었는지 적어 주면, 접수 번호가 아닌 진짜 답변을 받을 수 있어요.

이메일: support [at] shotpulled [dot] com
보통 답변 시간: 영업일 기준 2일 이내. 계정 접근이나 데이터 손실에 관한 문의는 가장 먼저 답해요.
언어: 영어 또는 루마니아어.

포함할 내용

어느 환경에서 사용했는지 알려 주는 문의가 가장 빨리 해결돼요. 가능하면:

어디서: AI 어시스턴트(Claude, ChatGPT), 휴대폰 앱, 웹 대시보드 중 어디인지, 그리고 설정에 나오는 앱 버전.
요청한 내용, 그리고 돌아온 결과. 잘라낸 화면보다 전체 화면 스크린샷이 좋아요.
언제: 대략적인 시각과 사용 중인 시간대. 서버 로그는 UTC로 기록되어 있어서 그래야 찾을 수 있어요.
계정 이메일: 내 데이터에 관한 문의라면 로그인한 이메일을 알려 주세요.

비밀번호나 인증 토큰은 보내지 마세요. 여기서는 절대 요청하지 않아요. 로그인은 전적으로 Clerk가 처리하고, 비밀번호는 우리 서버에 전혀 닿지 않아요.

내 데이터와 계정

계정 삭제: 직접 할 수 있어요. 웹 대시보드나 휴대폰 앱의 설정에서 계정 삭제 버튼을 누르세요. 계정에 속한 모든 것이 지워지며 되돌릴 수 없어요.
데이터 내보내기, 그리고 GDPR에 따른 열람, 정정, 처리 제한 요청은 30일 이내에 직접 처리해요. 계정에 연결된 주소에서 privacy [at] shotpulled [dot] com 주소로 이메일을 보내세요.
무엇을, 어디에, 얼마나 오래 저장하는지: 개인정보처리방침에 나와 있어요.

보안 문제 제보

제목에 "security"를 넣어 support [at] shotpulled [dot] com 주소로 이메일을 보내면 당일에 읽어요. 발견한 문제를 공개하기 전에 고칠 수 있도록 적절한 시간을 주세요. 다른 계정의 데이터에 접근하는 문제에 대한 제보가 가장 높은 우선순위예요.

문의 받는 사람

운영자: Bacosca Iulian PFA, 루마니아(EU)에 등록된 개인 사업자
등록 주소: Str. Ion Câmpineanu nr. 24, Sector 1, București, Romania
상업 등기 번호: F40/4818/2022 · CUI: 46937352

서비스가 약속하는 것과 약속하지 않는 것은 서비스 이용약관에 나와 있어요.