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

회의록을 정리하려고 Claude(클로드)에게 시켰다고 해 봅시다. 먼저 Notion(노션)에서 회의록 페이지를 엽니다. 본문을 드래그해 복사합니다. Claude 창으로 옮겨 붙여넣습니다. 정리된 결과가 나오면 그걸 다시 복사해서 Notion으로 돌아가 붙여넣습니다.

한 번이면 괜찮습니다. 그런데 회의는 매주 있습니다.

MCP는 이 왕복을 없애는 것입니다. 한 번 연결해 두면 Claude가 Notion을 직접 열어서 읽고, 정리한 결과를 직접 써 넣습니다. 복사와 붙여넣기가 사라집니다.

이 글은 2026년 8월 기준이고, MCP를 한 번도 연결해 보지 않은 분을 대상으로 합니다. MCP가 무엇인지부터 보고, claude.ai에서 켜는 방법과 터미널에서 붙이는 방법을 차례로 본 다음, 관리와 문제 해결까지 갑니다.

MCP가 무엇인지부터 봅니다

MCP는 Claude와 다른 서비스 사이에 놓는 통로입니다. 통로가 없으면 사람이 내용을 들고 왔다 갔다 해야 하고, 통로가 생기면 Claude가 직접 오갑니다.

이름이 어렵게 들리지만 뜯어 보면 단순합니다. Model Context Protocol의 Protocol은 규격이라는 뜻입니다. USB를 생각하면 쉽습니다. 기기마다 다른 케이블을 쓰던 시절에는 연결할 때마다 다른 선을 찾아야 했지만, USB라는 공통 규격이 생기고 나서는 포트 하나에 뭐든 꽂힙니다. MCP도 마찬가지로 AI 도구와 외부 서비스가 서로를 알아보는 공통 규격입니다.

그래서 Notion, Slack(슬랙), 구글 드라이브처럼 서로 다른 회사가 만든 서비스도 같은 방식으로 붙습니다. Claude 쪽에서 서비스마다 따로 만들어 둘 필요가 없습니다.

연결 대상 하나하나를 MCP 서버라고 부릅니다. 「서버」라는 말이 거창하게 들리는데, 여기서는 그냥 Claude가 그 서비스를 다룰 수 있게 해 주는 프로그램 한 벌입니다. 대부분은 그 서비스 회사가 이미 만들어서 인터넷에 띄워 두었고, 우리는 주소를 알려 주기만 하면 됩니다.

MCP(Model Context Protocol)

MCP(Model Context Protocol)란 AI 도구와 외부 서비스를 잇는 공개 표준입니다. MCP 서버를 연결하면 Claude Code(클로드 코드)가 그 서비스의 데이터와 기능을 직접 쓸 수 있습니다.

실제 사례로 보겠습니다. 저는 Notion MCP를 연결하고 회의록 정리를 크게 줄였습니다.

연결 전에는 회의록 주소를 Claude에게 건네도 열지 못해서, 결국 페이지를 열고 본문을 긁어다 붙여야 했습니다. 정리된 결과가 나오면 그걸 다시 복사해 Notion으로 돌아가 붙여넣었습니다. 마크다운으로 받은 문서를 Notion 형식에 맞추느라 내보내고 다시 들여오는 일도 있었습니다.

연결 후에는 "이번 주 회의록 정리해 줘" 한마디로 끝납니다. Claude가 페이지를 직접 열어 읽고 정리한 내용을 그 자리에 써 넣습니다. 제가 창을 오가는 일이 없어졌습니다.

웹에서 켜면 터미널에도 따라옵니다

가장 쉬운 방법부터 봅니다. 브라우저에서 claude.ai의 커넥터 설정을 열고 쓰려는 서비스를 켜면 됩니다. 터미널을 열 일이 없습니다.

여기서 켠 것은 Claude Code에도 자동으로 나타납니다. 공식 문서가 *"Claude.ai에서 추가한 MCP 서버는 Claude Code에서 자동으로 사용 가능합니다"*라고 밝힙니다. 터미널에서 /mcp를 치면 claude.ai에서 온 것이라는 표시와 함께 목록에 보입니다.

어디서 켜면 어디까지 따라오나

Claude를 쓰는 자리가 여럿이라 헷갈리기 쉽습니다. 켜는 곳에 따라 따라오는 범위가 다릅니다.

웹만 자동입니다. 데스크톱 앱에 이미 붙여 둔 서버가 있다면 한 번 가져오는 절차가 필요하고, 그 뒤로는 Claude Code 것이 됩니다. 가져오기는 맥과 윈도우의 WSL에서만 됩니다.

웹에서만 되는 서비스가 있습니다

Gmail, 구글 캘린더, Microsoft 365는 터미널에서 아예 안 붙습니다. 로그인 방식 때문인데, Claude Code에서 붙이려고 하면 claude.ai에서 연결하라는 안내가 대신 뜹니다. 이 서비스들을 쓰려면 웹으로 가야 합니다.

켰는데 목록에 안 보이면 로그인 방식부터

웹에서 켰는데 /mcp 목록에 없다면 로그인 방식을 봅니다. claude.ai 계정으로 로그인했을 때만 커넥터를 가져옵니다. API 키나 별도 토큰으로 로그인해 두었거나 회사에서 다른 경로를 쓰고 있으면 안 불러옵니다. 터미널에서 /status로 지금 어떤 방식으로 로그인돼 있는지 확인할 수 있습니다.

회사 계정(Team, Enterprise)이라면 하나 더 있습니다. 커넥터를 추가할 수 있는 사람이 관리자뿐입니다. 목록에 없으면 관리자에게 요청해야 합니다.

저라면 쓰려는 서비스가 웹 커넥터 목록에 있는지부터 봅니다. 있으면 터미널을 열 일이 없습니다.

터미널에서 명령어로 연결하기

웹 커넥터에 없는 서비스는 터미널에서 붙입니다. 명령어를 외우거나 찾아 헤맬 일은 없습니다. 쓰려는 서비스의 안내 문서에 명령어가 통째로 적혀 있으니 그대로 복사해 붙여넣으면 됩니다. 안내 문서를 못 찾겠으면 Anthropic Directory에서 검토를 거친 커넥터를 찾을 수 있습니다.

명령어는 대개 이렇게 생겼습니다.

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

notion 자리가 앞으로 이 서버를 부를 이름이라 마음대로 정하시면 되고, 나머지는 안내 문서에 적힌 그대로 두면 됩니다.

내 컴퓨터에서 도는 도구를 붙일 때

인터넷에 올라가 있지 않고 내 컴퓨터에서 실행되는 도구는 모양이 조금 다릅니다. 붙을 서버가 아직 없으니 띄우는 명령까지 알려 줘야 하기 때문입니다.

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와 이름 사이에 다른 옵션을 하나 끼워 넣으세요.

저장 범위: 이 폴더에서만 쓸지 어디서나 쓸지

붙이고 나면 하나 더 정할 게 있습니다. 이 서버를 지금 이 폴더에서만 쓸지, 내 모든 작업에서 쓸지입니다.

같은 서버라도 저장해 두는 자리가 다르면 쓸 수 있는 범위가 달라집니다. 다른 프로그램에서 「전역 설치」라고 부르는 것이 여기서는 아래 표의 user에 해당합니다. 어느 폴더에서 일하든 따라온다는 뜻입니다.

--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 연결

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