클로드 코드 MCP 연결하기: 추가부터 삭제까지

다른 도구에서 내용을 복사해 Claude(클로드)에게 붙여넣고 계신가요? Notion(노션) 문서를 긁어서 붙이고, 이슈 내용을 옮겨 적고, 지표를 캡처해서 올리는 식으로요.

MCP는 그 복붙을 그만두기 위한 것입니다. 연결해 두면 Claude가 그 시스템을 직접 읽고 씁니다. 공식 문서도 서버를 연결할 시점을 이렇게 설명합니다. 다른 도구에서 채팅으로 데이터를 복사하고 있는 자신을 발견할 때라고요.

연결은 명령어 한 줄입니다.

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

연결하는 법, 어디에 저장할지 고르는 법, 확인하고 지우는 법, 그리고 아무거나 연결하면 안 되는 이유까지 다루겠습니다.

저는 Notion을 붙이고 회의록 복붙을 없앴습니다. 그전에는 양쪽 방향 모두 손이 갔습니다. 읽는 쪽은 문서 주소를 건네도 Claude가 제대로 열지 못해서 결국 내용을 긁어다 붙여야 했습니다. 쓰는 쪽은 더 번거로웠습니다. Claude가 마크다운 문서를 써 주면 그걸 제가 Notion으로 옮겼는데, 내보내고 다시 들여오는 과정이 결국은 손으로 하는 복붙이었습니다.

MCP 서버 연결 방식 세 가지

서버마다 연결 방식이 다릅니다. 대개 그 서비스의 안내 문서에 어떤 방식인지 적혀 있으니 거기 나온 명령어를 그대로 쓰시면 됩니다.

요즘 가장 흔한 것은 원격 HTTP 서버입니다. 내 컴퓨터 밖에 이미 돌고 있는 서버에 주소로 붙습니다.

claude mcp add --transport http <이름> <주소>

<이름>은 앞으로 이 서버를 부를 때 쓸 이름이라 마음대로 정하시면 됩니다.

SSE도 남의 서버에 붙는 것은 같습니다. 통신 방식만 다르고 명령어 모양은 그대로입니다.

claude mcp add --transport sse <이름> <주소>

나머지 하나는 성격이 다릅니다. 내 컴퓨터에서 서버 프로그램을 직접 띄우는 방식입니다. 붙을 서버가 아직 없으니 띄우는 방법까지 알려 줘야 합니다.

claude mcp add [옵션] <이름> -- <실행할 명령어>

여기서 가운데 -- 두 개가 중요합니다. 담장이라고 생각하면 쉽습니다. 담장 앞은 Claude에게 하는 말이고, 담장 뒤는 서버에게 하는 말입니다. 이걸 빼면 Claude가 서버의 옵션을 자기 것으로 착각해서 오류가 납니다.

API 키 같은 값이 필요하면 --env로 넘깁니다.

claude mcp add --env AIRTABLE_API_KEY=내키 --transport stdio airtable -- npx -y airtable-mcp-server

주의할 게 하나 있습니다. --env 바로 뒤에 서버 이름을 쓰면 안 됩니다. Claude가 그 이름을 또 다른 키=값 쌍으로 읽고 거부합니다. 위 예시처럼 --env와 이름 사이에 다른 옵션을 하나 끼워 넣으세요.

저장 범위: 서버를 쓸 대상 결정

이게 두 번째로 정할 것입니다. --scope(줄여서 -s)로 지정하고, 안 쓰면 기본값이 적용됩니다.

claude mcp add --scope user --transport http notion https://mcp.notion.com/mcp

project 범위를 고르면 .mcp.json 파일이 저장소에 생깁니다. 이걸 커밋하면 팀원들도 같은 서버를 쓰게 됩니다.

다만 팀원이 저장소를 받아도 바로 연결되지는 않습니다. 저장소에 적힌 서버는 각자가 승인해야 붙습니다. 남이 커밋한 설정이 내 컴퓨터에서 자동으로 외부에 연결되면 위험하기 때문입니다. 승인 전에는 목록에 승인 대기 중으로 표시됩니다.

개인적으로 쓰는 도구는 user가 편합니다. 프로젝트를 옮겨 다녀도 따라옵니다.

연결 관리: 확인과 삭제

붙였으면 관리도 해야 합니다. 명령어는 네 개면 충분합니다.

claude mcp list          # 붙어 있는 서버 전부 보기
claude mcp get notion    # 특정 서버 자세히 보기
claude mcp remove notion # 지우기

그리고 Claude Code 안에서는 이걸 칩니다.

/mcp

/mcp 화면이 실무에서 제일 자주 쓰게 될 겁니다. 서버마다 지금 연결됐는지와 도구를 몇 개 제공하는지를 보여 줍니다. 도구를 하나도 안 내놓는 서버가 있으면 표시해 줍니다. 로그인이 필요한 서버의 인증도 여기서 합니다.

보안 주의: 연결 대상 선별

공식 문서가 이 대목에 경고를 달아 두었습니다.

연결하기 전에 그 서버를 믿을 수 있는지 확인하라고 명시합니다. 특히 외부에서 내용을 가져오는 서버는 프롬프트 인젝션 위험에 노출됩니다.

프롬프트 인젝션은 Claude가 읽은 문서 안에 "이제부터 이렇게 해라"는 지시문이 숨어 있는 경우입니다. Claude는 그게 데이터인지 지시인지 구분하기 어려울 수 있습니다. 웹페이지나 이슈 댓글, 외부 문서를 끌어오는 서버라면 그 안에 누가 심어둔 문장이 섞여 들어올 수 있다는 뜻입니다.

그래서 두 가지를 권합니다.

하나는 검토된 목록에서 고르는 것입니다. Anthropic(앤트로픽)이 운영하는 디렉토리에 검토를 거친 커넥터가 모여 있습니다. 거기 있는 원격 서버는 claude mcp add로 그대로 추가할 수 있습니다.

다른 하나는 필요한 것만 붙이는 것입니다. 붙여만 두고 안 쓰는 서버는 지우는 게 낫습니다. 보안 때문만이 아닙니다. 서버가 늘어날수록 도구 목록이 길어져 컨텍스트를 먹습니다.

문제 해결: MCP 연결

증상과 같은 줄에서 원인과 해결을 함께 확인하세요.