Claude Code /mcp란? 연결 상태 확인부터 로그인 오류까지 쉽게 해결하기
“Claude Code에 외부 도구를 연결했는데 왜 사용할 수 없을까요?” 설정 안내를 따라 했는데 서버가 보이지 않거나 다시 로그인하라는 메시지가 나타날 수 있습니다. 이럴 때 Claude Code에서 확인할 수 있는 명령어가 /mcp입니다. /mcp는 Claude Code에 구성된 MCP 서버의 연결 상태를 확인하고 필요한 경우 인증·연결 관리 메뉴로 이동하는 내장 명령어입니다. 이 명령을 입력한다고 모든 서비스를 자동 설치하거나 무제한 접근 권한을 주는 것은 아닙니다. MCP가 AI와 외부 도구를 연결하는 규칙이라면, /mcp는 내 Claude Code에서 어떤 연결이 준비되어 있는지 확인하는 관리 창구라고 생각하면 됩니다.
이 글의 순서
1. /mcp는 어디에 입력하나요?
먼저 Claude Code를 실행하고 대화 입력창을 엽니다. 일반적인 질문을 입력하는 그곳에 /mcp를 적습니다. 그러면 현재 환경에 설정된 MCP 서버의 목록과 상태를 확인할 수 있습니다. 화면 모양은 제품 버전과 실행 환경에 따라 달라질 수 있습니다. 운영체제의 일반 터미널에서 /mcp만 입력하는 것과 Claude Code 안에서 입력하는 것은 다릅니다. 이 명령은 Claude Code가 해석하는 슬래시 명령입니다.
2. 서버가 목록에 있으면 바로 사용할 수 있나요?
아닙니다. 설정됨, 연결됨, 인증됨, 실제 자료 접근 권한이 있음은 서로 다른 상태입니다. 도서관 안내판에 '자료실'이 적혀 있다고 해서 지금 당장 그 방에 들어갈 수 있는 것은 아닙니다. 문이 열려 있는지, 회원증이 필요한지, 해당 자료를 열람할 수 있는지 확인해야 합니다. MCP 서버도 마찬가지입니다. 목록에 이름이 보이더라도 실제 연결이 실패했을 수 있고, 연결에 성공했더라도 특정 문서에 접근할 권한이 없을 수 있습니다.
| 상태 예시 | 뜻 | 확인할 점 |
|---|---|---|
| Connected | 연결됨 | 필요한 도구와 자료 권한 확인 |
| Needs authentication | 인증 필요 | 제공자와 요청 권한 확인 |
| Failed to connect | 연결 실패 | 서버 주소와 네트워크 확인 |
| Pending approval | 승인 대기 | 프로젝트 설정 신뢰성 검토 |
| Disabled | 비활성 | 의도적으로 꺼둔 것인지 확인 |
3. 처음 연결 상태를 확인하는 다섯 단계
노션 같은 문서 서비스를 Claude Code와 연결하려는 가상의 상황을 생각해 보겠습니다. 첫째, Claude Code에서 /mcp를 입력합니다. 연결하려는 서버가 목록에 나타나는지 확인합니다. 둘째, 서버의 상태를 읽습니다. 연결됨, 인증 필요, 연결 실패 등 어떤 메시지가 나오는지 기록합니다. 셋째, 인증이 필요하다면 공식 제공자인지 확인합니다. 로그인 화면이 뜨면 서비스 이름과 요청 권한을 살펴본 뒤 필요한 범위만 승인하세요. 넷째, 연결에 성공하면 제공되는 도구를 확인합니다. 서버가 연결됐더라도 문서 읽기 기능이 없거나 해당 문서의 접근 권한이 없을 수 있습니다. 다섯째, 작은 읽기 작업부터 확인합니다. 예를 들어 권한이 있는 테스트 문서의 제목만 확인하도록 요청해 볼 수 있습니다. 실제 자료 수정은 별도로 승인한 뒤 진행하세요. 이 절차는 설명용입니다. 이번 글을 작성하면서 실제 사용자 계정에 접속하거나 연결 시험을 수행하지 않았습니다.
4. /mcp와 claude mcp list는 무엇이 다른가요?
이름이 비슷해서 헷갈리지만 입력하는 위치가 다릅니다. /mcp: Claude Code가 실행 중인 대화 입력창에서 사용하는 명령입니다. 서버 목록, 상태, 인증 및 관리 화면을 살펴볼 때 유용합니다. claude mcp list: 운영체제의 일반 터미널에서 실행하는 Claude Code CLI 명령입니다. 설정된 서버의 목록과 연결 상태를 확인합니다. claude mcp get 서버이름: 터미널에서 특정 서버의 세부 설정을 살펴볼 때 사용합니다. claude mcp add: 새 MCP 서버의 연결 정보를 등록하는 터미널 명령입니다. 연결하려는 서버의 공식 안내에 따라 주소와 전송 방식을 정확하게 지정해야 합니다. 처음에는 /mcp로 현재 상태를 읽는 것부터 시작하세요. 서버를 추가하거나 제거하는 작업은 설정 변경이므로 제공자를 확인하고 진행하는 것이 좋습니다.
| 명령 | 입력 위치 | 주요 목적 |
|---|---|---|
| /mcp | Claude Code 대화창 | 연결 상태·인증·관리 |
| claude mcp list | 일반 터미널 | 설정 서버 목록 확인 |
| claude mcp get | 일반 터미널 | 특정 서버 정보 확인 |
| claude mcp add | 일반 터미널 | 서버 구성 등록 |
5. 연결에 실패했다면 무엇부터 확인하나요?
인증이 필요하다는 메시지: 서버가 사용자 계정의 로그인을 요구할 수 있습니다. /mcp에서 해당 서버를 선택하고 공식 인증 절차를 확인하세요. 로그인 후에도 계정에 문서 열람 권한이 있는지는 별개입니다. 연결 실패 메시지: 서버 주소가 정확한지, 인터넷 연결에 문제가 없는지, 서비스 자체에 장애가 없는지 살펴봅니다. 로컬 서버라면 필요한 프로그램이 실행 가능한 상태인지도 확인해야 합니다. 승인 대기 메시지: 프로젝트에 포함된 연결 설정을 아직 신뢰하거나 승인하지 않았을 수 있습니다. 누가 작성한 설정인지 먼저 확인하고, 모르는 명령을 실행하도록 요구한다면 승인하지 마세요. 비활성 메시지: 일부 서버는 현재 프로젝트에서 의도적으로 꺼져 있을 수 있습니다. 필요한 연결인지 검토하고, 조직에서 관리하는 정책이 있다면 그 정책을 우선 확인합니다. 연결됐지만 도구가 안 보임: 서버가 제공하는 도구가 없거나 권한·설정·환경 때문에 노출되지 않을 수 있습니다. 서버의 공식 문서와 실제 제공 기능을 확인하세요.
6. /mcp가 보안과 비용을 해결해 주나요?
/mcp는 연결 상태를 확인하는 도구이지, 보안 인증이나 비용 면제 기능이 아닙니다. 외부 MCP 서버가 제공하는 기능 중에는 문서를 읽는 것뿐 아니라 내용을 수정하거나 외부 서비스에 요청을 보내는 작업도 있을 수 있습니다. 따라서 서버를 연결하기 전에 제공자, 요청 권한, 사용 범위를 확인하세요. 처음 이용하는 서버라면 읽기 중심의 작은 작업으로 시작하고, 개인정보나 회사 내부 자료를 대량으로 전달하지 않는 것이 좋습니다. 도구가 반환한 외부 문서에 AI를 속이려는 지시가 들어 있을 수도 있으므로, 문서 내용과 사용자의 실제 지시를 구분해야 합니다. 또한 MCP 서버 연결과 별개로 외부 서비스의 유료 구독이나 API 요금이 발생할 수 있습니다. '연결됨'이라는 표시가 '무료'라는 뜻은 아닙니다. 설정을 바꾸기 전에는 현재 서버 이름과 목적을 기록해 두세요. 연결 삭제는 인증 상태에 영향을 줄 수 있으므로 단순한 상태 확인과 구별해야 합니다.
7. 초보자에게 유용한 활용 예시
본인이 접근할 권한이 있는 프로젝트 문서를 요약하려 한다고 가정해 보겠습니다. 먼저 /mcp로 문서 서비스 연결 상태를 확인합니다. 정상 연결 상태라면 Claude Code에 이렇게 요청할 수 있습니다.
읽기 권한이 있는 테스트 문서의 제목만 확인해 줘. 문서는 수정하지 말고, 실제로 읽지 못했다면 확인하지 못했다고 알려 줘. 결과가 나오면 실제로 어떤 문서를 읽었는지 확인합니다. 도구가 없거나 권한이 부족하다면 AI가 내용을 추측하도록 하지 말고 확인되지 않았다고 표시하도록 요청하세요. 이렇게 연결 확인 → 최소 권한으로 조회 → 근거 확인 순서를 지키면 '연결됐으니 모든 작업이 가능하다'고 생각하는 실수를 줄일 수 있습니다. 이 사례는 사용 방법을 설명하기 위한 가정이며, 이 원고를 작성하면서 실제 계정의 문서를 열거나 수정하지 않았습니다.
자주 묻는 질문
Q1. /mcp를 입력하면 MCP 서버가 자동으로 설치되나요?
아닙니다. /mcp는 현재 구성된 서버를 확인하고 일부 관리 작업을 수행하는 명령입니다. 서버를 새로 추가하는 방법은 서버 종류와 설치 안내에 따라 다릅니다.
Q2. Connected가 나오면 모든 파일을 읽을 수 있나요?
아닙니다. 연결 상태와 개별 파일·서비스에 대한 접근 권한은 다릅니다. 필요한 도구가 실제 제공되는지도 확인해야 합니다.
Q3. 로그인하라는 화면이 뜨면 무조건 승인해도 되나요?
아닙니다. 공식 제공자가 맞는지, 어떤 권한을 요청하는지 확인하세요. 불필요하게 넓은 접근 권한을 요청한다면 중단하고 검토하는 편이 안전합니다.
Q4. /mcp와 MCP는 같은 뜻인가요?
같지 않습니다. MCP는 외부 도구 연결을 위한 표준이고, /mcp는 Claude Code에서 연결 상태를 확인하는 특정 명령입니다.
Q5. 연결에 실패하면 Claude Code를 다시 설치해야 하나요?
반드시 그렇지는 않습니다. 인증, 서버 설정, 네트워크, 서버 장애, 승인 대기 등 여러 원인이 있을 수 있으므로 상태 메시지부터 확인하세요.
Q6. /mcp를 사용하면 AI 토큰이 무조건 절약되나요?
아닙니다. MCP 서버가 제공하는 도구를 어떻게 사용하느냐에 따라 컨텍스트와 작업량이 달라집니다. /mcp 자체가 토큰 절약을 보장하지는 않습니다.
마무리: 연결 상태를 먼저 확인하세요
Claude Code의 /mcp는 외부 도구를 사용할 때 어떤 서버가 구성돼 있는지, 연결과 인증에 문제가 없는지 살펴보는 출발점입니다. 기억할 것은 세 가지입니다. 첫째, /mcp는 Claude Code 대화창의 명령입니다. 둘째, 서버 목록에 보인다는 사실과 실제 접근 권한은 다릅니다. 셋째, 오류 메시지를 확인하고 필요한 권한만 승인하세요. 처음부터 복잡한 설정을 바꾸기보다 상태를 읽고, 신뢰할 수 있는 서버인지 확인한 다음, 작은 읽기 작업부터 검증하는 것이 좋습니다.
함께 읽으면 좋은 글
- MCP란? AI가 외부 도구와 연결되는 원리를 쉽게 설명 — 관련 개념과 실전 점검 방법을 함께 확인합니다.
- CLI란? 명령어로 컴퓨터를 다루는 방법과 초보자 예시 — 관련 개념과 실전 점검 방법을 함께 확인합니다.