본문으로 건너뛰기

터미널 Claude Code(CLI)에서 Gmail·Slack 커넥터가 갑자기 안 될 때 — 새 세션이 답

시선180

2026.08.05

터미널 Claude Code(CLI)에서 Gmail·Slack 커넥터가 갑자기 안 될 때 — 새 세션이 답 본문 이미지


터미널에서 Claude Code(CLI)로 Gmail·Slack·Calendar 같은 claude.ai 커넥터를 쓰다가, 어제까지 잘 되던 게 갑자기 "연결이 안 됐다"는 식으로 막히는 경우가 있어요. 바로 오늘 아침 출근 후 모닝루틴 진행하면서 한참 헤매다(!!!) 원인과 대처를 정리했어요. 같은 세팅 쓰시는 분들 참고하시라고 짤막 공유합니다. 🥹 (저만 그런 거 아니죠...?)

(웹/데스크톱 앱 claude.ai가 아니라 터미널에서 쓸 때 관찰한 내용이에요. 앱에선 커넥터가 네이티브라 양상이 다릅니다.)

증상

  • "늘 되던 게 갑자기 오늘 아침 안 됨" (슬랙, 지메일 커넥터 연결)

  • Gmail·Slack 등 커넥터 동작이 안 되거나, 그 도구 자체가 안 보임

  • claude mcp list로 보면 해당 커넥터가 분명히 ✔ Connected인데도 실제로는 호출이 안 됨

관찰한 원인

  • MCP 도구는 세션이 처음 뜰 때 한 번 로드됩니다. 평소엔 커넥터가 대부분 잘 붙어요.

  • 그런데 오래 켜둔 채로 대화가 길어져 내부 정리(compact)가 여러 번 반복된 세션에서, 간혹 claude.ai 커넥터 도구가 목록에 안 실린 상태로 굳는 경우가 있습니다. (저는 하나씩 업무별 터미널을 열어놓고 이름을 붙인뒤 세션종료 및 compact를 반복하며 쭉 쓰고 있어요.)

  • claude mcp list의 Connected는 계정-서버 연결이 살아있다는 뜻이지, 지금 이 세션에 도구가 실렸다는 뜻이 아니에요. 그래서 "연결됐는데 못 쓰는" 상태가 생깁니다.

왜 그 세션 안에서 못 살리나

  • /mcp 메뉴로 재연결되는 건 chrome·vercel·플러그인 같은 서버뿐이에요.

  • Gmail·Slack 같은 claude.ai 스코프 커넥터는 /mcp 메뉴에 아예 안 떠서**, 그 세션 안에서는 되살릴 방법이 없습니다. (이 비대칭이 헷갈림의 핵심)

대처

  • 새 세션을 시작하면 뜰 때 커넥터 도구가 다시 로드됩니다. 그게 제일 빠른 해결이에요.

  • 그 세션에서 씨름하지 말고, 커넥터가 필요한 작업이 안 되면 바로 새 세션으로 여는 걸 먼저 의심하세요. 오래된 세션일수록 그렇습니다.

  • 반대로 chrome·vercel 같은 건 오래된 세션이어도 /mcp로 그 자리에서 살릴 수 있어요.

참고

방아쇠가 compact 자체인지 세션 수명인지는 아직 정확히 못 박았습니다(관찰 기반). 확정된 버그라기보다 "이런 증상이 있고, 새 세션이 우회법"이라는 정도로 봐주세요. 재현되면 원인을 더 좁혀볼게요.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

김도경 프로필 이미지
김도경2026.09.27

좋은 글 잘 읽었습니다~

박준_JoonLab 프로필 이미지
박준_JoonLab2026.08.19

오 claude mcp list의 Connected가 계정-서버 연결이 살아있다는 뜻이지 이 세션에 도구가 실렸다는 뜻은 아니라는 부분, 이 비대칭을 짚어주신 게 정말 핵심인 것 같습니다.

방아쇠를 좁히실 때는 새 세션에서 커넥터를 한 번 호출해 성공을 확인한 뒤 곧바로 compact를 걸고 같은 호출을 다시 해보시면, compact와 세션 수명 두 후보가 깔끔하게 분리될 것 같습니다. 재현이 되면 compact 직후에 가벼운 호출 하나를 스모크 체크로 두시는 것만으로도 헤매는 시간은 크게 줄겠네요.

다음 편도 기대하고 있겠습니다 ㅎㅎ

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기