MCP 연결 실패: 401 / Authorization header

「연결이 안 됩니다」의 90%는 401 에러입니다. 이 글에서는 상황별로 진단 방법을 정리합니다.

401 — Unauthorized

가장 흔한 케이스입니다. 서버가 요청은 받았지만 Authorization 헤더를 찾지 못했거나 받아들이지 않았다는 뜻입니다.

진단 1단계: 토큰이 존재하는지 확인

로컬 stdio:

npx slima-mcp@0 status

「Token valid for [email protected]」이라고 나와야 정상입니다.

만약 「No token found」이 뜬다면 다시 실행하세요:

npx slima-mcp@0 auth

자세한 설명: SLIMA_API_TOKEN 받기

진단 2단계: 토큰이 만료되거나 취소되지 않았는지 확인

Account → 승인된 앱 화면에서 다음을 확인합니다:

• 토큰이 목록에 있는지
• 「expired」 또는 「revoked」로 표시되어 있지 않은지

표시되어 있다면 → 다시 인증을 진행하세요.

진단 3단계: 클라이언트 설정이 올바른지 확인

Claude Desktop을 재시작하고 로그를 확인합니다:

macOS:

tail -f ~/Library/Logs/Claude/mcp*.log

Windows:

type "%APPDATA%\Claude\Logs\mcp*.log"

다음 메시지를 찾아보세요:

• MCP server slima exited unexpectedly → 실행 명령어 설정이 잘못되어 있습니다
• Failed to fetch ... → 네트워크 문제입니다
• Authorization header not set → 토큰이 읽히지 않은 상태입니다

그 밖의 연결 오류

403 Forbidden

토큰은 유효하지만 권한이 부족한 상태입니다. 예를 들어 토큰이 삭제된 계정에 속해 있거나 스코프가 잘못된 경우입니다.

해결: 다시 인증을 진행하세요.

408 / Timeout

네트워크가 너무 느리거나 중간 미들웨어가 차단하고 있습니다. 해결: 다른 네트워크 / 프록시 / VPN을 사용해 보십시오.

5xx

Slima 서버 쪽 문제입니다. 해결: 5~10분 정도 기다린 뒤 다시 시도하거나 status.slima.ai를 확인하십시오.

WWW-Authenticate flow

웹 OAuth 클라이언트(claude.ai / ChatGPT)는 401 응답을 받으면 WWW-Authenticate: Bearer realm="slima", scope="..." 헤더를 받게 되며, 클라이언트는 이 헤더를 기반으로 OAuth 재인증 flow를 자동으로 띄워야 합니다.

만약 재인증 flow가 뜨지 않는다면 → 클라이언트의 MCP 구현에 버그가 있는 것입니다. 클라이언트를 재시작하거나 커넥터를 삭제 후 다시 추가해 보세요.

관련 문서

• 토큰 만료
• OAuth 디버깅
• 승인된 앱 관리