Claude Code MCP 연결 제대로 확인하기

claude -p 에 MCP 서버를 붙여 쓰면 자동화는 아무 문제 없이 성공으로 끝납니다. 그런데 서버의 데이터가 답에 빠져 있는 날이 있습니다.

이 책은 claude -p 가 MCP 서버에 정말 붙었는지를 Claude 의 말이나 종료 코드가 아니라 init 줄의 서버 상태 · 도구 목록 · 쓴 도구 · 거절 · 도구 오류로 세어 확인합니다.

이런 일을 하고 계신다면

· claude -p 에 MCP 서버를 붙여 쓴다

· 서버가 죽었는데도 자동화는 성공으로 끝난 적이 있다

· 서버를 업데이트한 뒤부터 도구를 못 쓴다

· claude mcp list 의 표시를 믿고 있다

· 밤새 돌린 자동화의 아침 결과에 서버의 데이터가 들어 있는지 모르겠다

이 책에 들어 있는 것

레시피 열네 개 · 열다섯 단계 · 98쪽

01 MCP 연결은 네 곳에서 읽습니다 — '붙었다' 는 말 하나만 믿지 않습니다

02 서버가 멀쩡할 때 — 네 곳이 모두 '연결됨' 을 가리킵니다 (15/15)

03 서버가 시작하자마자 죽어도 종료 코드는 0 입니다 — failed 는 init 줄에만 남습니다 (15/15)

04 command 가 없는 프로그램이어도 똑같이 조용합니다 — stderr 도 비어 있습니다 (15/15)

05 서버가 대답을 미루면 30초쯤 기다리다가 서버 없이 갑니다 (6/6)

06 연결은 됐는데 도구 이름이 달라서 거절됩니다 — 서버 상태는 connected 입니다 (15/15)

07 연결도 되고 도구도 있는데 허락에서 빠지면 — 부르고 거절당합니다 (15/15)

08 도구가 오류를 돌려줘도 서버는 connected, 종료 코드는 0 입니다 (15/15)

09 claude mcp list 의 '승인 대기' 와 claude -p 의 연결은 별개입니다 (9/9)

10 서버 둘 중 하나만 죽으면 일은 되고, 아무도 모릅니다 (15/15)

11 서버 상태는 stream-json 에만 남습니다 — text 와 json 에는 없습니다

12 '도구를 쓸 수 없으면 모른다고 답해' 한 줄 — 있으면 18/18, 없으면 11/18 이 모른다고 합니다

13 Claude 를 부르지 않고 서버부터 점검합니다 — 연결됨 · 죽음 · 늦음 · 실행불가

14 한 번의 기록을 판정합니다 — 성공 · 성공(경고) · 실패 · 의심

15 '종료 코드 0 이면 성공' 은 스물네 번 중 열여덟 번 틀렸고, 판정기는 한 번도 안 틀렸습니다

조용히 틀어진 것을 다 실었습니다

· 서버가 시작하자마자 죽어도 종료 코드 0 · subtype success · is_error False (15/15) — 서버 상태는 init 줄에만 failed 로 남음

· 없는 프로그램이어도 stderr 에 아무 말도 없음 (15/15) · 서버가 대답을 미루면 30초쯤 기다리다 서버 없이 감

· 도구 이름이 바뀌어도 서버는 connected (15/15) · 허락에서 빠진 MCP 도구는 부르고 거절당함 (15/15)

· 도구가 오류를 돌려줘도 결과 줄은 성공 (15/15) · claude mcp list 는 승인 대기인데 claude -p 는 연결됨 (9/9)

· 서버 둘 중 하나만 죽으면 일은 되고 아무도 모름 · text · json 으로 받으면 서버 상태가 아예 안 보임

· 여덟 시나리오 판정 — 종료 코드 0 이면 성공은 24번 중 18번 틀렸고 판정기는 한 번도 안 틀림

연결은 init 줄이 말합니다

init 의 서버 상태 · 도구 목록 · 쓴 도구 · permission_denials · 도구 결과의 오류로 판정했고, Claude 를 부르지 않고 서버부터 점검하는 코드까지 실었습니다.

점검기와 판정기는 Claude 없이 돌아가는 코드로 실었습니다.

전부 실제로 돌려 확인했습니다

2026년 10월 12일, Windows 10 · Claude Code 2.1.286 에서 레시피 열네 개를 세 판 만들어 돌렸습니다.

기록이 남은 호출 326번. 본문의 검은 상자는 그때 나온 화면 그대로이고, 부록의 코드도 실제로 돌아간 파일 그대로입니다.

시험용 MCP 서버는 인터넷에 접속하지 않는 작은 파이썬 파일이고, 시나리오마다 연습 폴더 밖의 새 폴더에서 불렀으며, 내 사용자 설정은 읽지 않았습니다. 모델은 haiku 이며 Windows 10 에서만 시험했습니다.

이런 분께

· claude -p 에 MCP 서버를 붙여 자동화를 돌리는 분

· MCP 서버를 직접 만들거나 고쳐 쓰는 분

· 밤새 돌린 자동화의 결과를 믿고 싶은 분

포함 파일

PDF (A4 · 98쪽) · EPUB (모바일 · 리더용)

두 가지가 ZIP 하나에 들어 있습니다.

「Claude Code 실전」 시리즈입니다. 이 책은 Anthropic 과 관계가 없는 개인의 사용기입니다.