목록 · 가이드

Claude에 MCP 설치하기

MCP를 붙이면 Claude가 내 노션, 내 피그마, 내 깃허브를 직접 열어 봅니다. 복사해서 붙여 넣던 일이 사라집니다. 어렵지 않습니다. 설정 파일 하나에 몇 줄을 넣고 앱을 껐다 켜면 끝입니다.

먼저 알아 둘 것 두 가지

MCP 서버에는 두 종류가 있습니다. 원격 서버는 회사가 서버를 운영하므로 주소만 넣으면 되고, 컴퓨터에 설치할 것이 없습니다. 로컬 서버는 내 컴퓨터에서 프로그램이 돌아가는 방식이라 설정 파일에 실행 명령을 적어야 합니다. 이 사이트의 목록에서 설치 불필요 배지가 붙은 것이 원격입니다.

Claude 데스크톱 앱이 필요합니다. 웹 브라우저의 claude.ai 에서는 로컬 서버를 붙일 수 없습니다. 앱을 먼저 설치하십시오. 이미 쓰고 계시다면 최신 버전인지 확인하십시오. 버전이 낮으면 설정에 커넥터 항목 자체가 보이지 않습니다.

원격 서버 붙이기 (더 쉬운 쪽)

설치할 것이 없어 3분이면 끝납니다. 처음이시라면 이쪽부터 해 보시는 편이 좋습니다.

1. Claude 앱에서 설정을 엽니다. 왼쪽 아래 프로필을 누르면 설정이 나옵니다. 그 안에서 커넥터를 찾으십시오.
2. 커스텀 커넥터 추가를 누릅니다. 이름 칸에는 알아보기 쉬운 이름이면 무엇이든 됩니다. 나중에 목록에서 구분만 되면 충분합니다.
3. 서버 주소를 붙여 넣고 저장합니다. 주소는 각 도구의 상세 페이지에 복사 버튼과 함께 적어 두었습니다. 저장하면 대개 로그인 창이 뜹니다. 계정을 연결하면 바로 쓸 수 있습니다.

로컬 서버 붙이기

설정 파일을 직접 여는 방식입니다. 파일 하나를 편집한다고 생각하시면 됩니다.

1단계. 설정 파일을 찾습니다

운영체제마다 위치가 다릅니다. 아래 경로를 탐색기나 파인더 주소창에 그대로 붙여 넣으십시오.

파일이 없어도 정상입니다. 커넥터를 한 번도 안 붙였다면 아직 만들어지지 않았을 수 있습니다. 그 폴더에 같은 이름으로 새 파일을 만드십시오. 메모장이나 텍스트편집기면 됩니다. Windows에서 만들 때는 저장 형식을 모든 파일로 바꿔야 .txt가 뒤에 붙지 않습니다.

2단계. 내용을 붙여 넣습니다

파일이 비어 있다면 아래를 통째로 넣으십시오. 파일 시스템 접근 서버를 예로 들었습니다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/이름/Documents"
      ]
    }
  }
}

맨 아래 경로는 Claude가 접근할 폴더입니다. 본인 폴더 경로로 바꾸십시오. Windows라면 C:\\Users\\이름\\Documents 형태이고, 역슬래시를 두 번 써야 합니다. 한 번만 쓰면 오류가 납니다.

이미 다른 서버가 들어 있다면 파일을 통째로 바꾸지 마십시오. mcpServers 중괄호 안쪽에 항목만 추가하고, 항목 사이에 쉼표를 넣으십시오. 마지막 항목 뒤에는 쉼표를 넣지 않습니다. JSON에서 가장 많이 나는 오류가 이 쉼표입니다.

3단계. 앱을 완전히 끄고 다시 켭니다

창만 닫으면 반영되지 않습니다. 이 단계를 빠뜨려서 안 된다고 하는 경우가 가장 많습니다.

Windows는 작업 표시줄 오른쪽 숨겨진 아이콘에서 Claude를 찾아 종료하십시오. macOS는 창을 닫아도 앱이 살아 있으므로 Cmd+Q를 누르거나 상단 메뉴에서 Claude 종료를 선택하십시오. 그다음 다시 실행합니다.

잘 붙었는지 확인하기

입력창 근처에 도구 아이콘이 생겼는지 보십시오. 눌렀을 때 방금 등록한 서버 이름과 그 아래 도구 목록이 나오면 성공입니다.

가장 확실한 확인 방법은 실제로 시켜 보는 것입니다. 파일 시스템 서버라면 "Documents 폴더에 뭐가 있는지 알려줘"라고 물어보십시오. 목록이 나오면 제대로 붙은 것입니다.

도구 아이콘이 아예 없거나, 있는데 서버가 목록에 안 보인다면 MCP 서버가 안 뜰 때 점검할 8가지를 보십시오. 증상별로 정리해 두었습니다.

다음에 붙이면 좋은 것

첫 서버를 붙이셨다면 그다음은 본인 업무에서 가장 자주 여는 도구입니다. 문서를 많이 다루면 노션, 디자인이면 피그마, 코드면 깃허브 순으로 효용이 큽니다. 목록에서 분류별로 보실 수 있습니다.

이어서 보기