MCP Academy · 강의

Claude Desktop에 연결하기

Claude가 서버를 로드하도록 설정을 편집합니다.

레슨 2/413개 단계

Claude Desktop에 연결하기은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

스크립트에서 실제 호스트로

서버는 실행되지만 아직 아무도 서버와 통신하지 않습니다. 이제 실제 호스트인 Claude Desktop에 연결해 보겠습니다. 🖥️

구성 파일 읽기

Claude Desktop은 claude_desktop_config.json이라는 JSON 파일 하나에서 서버를 찾습니다. 각 서버를 이 파일에 나열하면 시작할 때 불러옵니다.

파일 위치

macOS에서는 파일이 Application Support 아래에 있고, Windows에서는 AppData 로밍 폴더에 있습니다. 앱 설정에서 파일을 여세요.

~/Library/Application Support/Claude/claude_desktop_config.json

mcpServers 키

모든 서버는 최상위 mcpServers 객체 안에 넣습니다. 각 키는 사용자가 정하는 이름이고, 값은 서버를 실행하는 방법을 설명합니다.

{
  "mcpServers": {}
}

명령과 인수

각 서버에 실행할 명령과 args 배열을 지정합니다. 이 둘이 호스트가 프로세스를 실행하는 정확한 방법을 구성합니다.

{
  "weather": {
    "command": "python",
    "args": ["/abs/path/server.py"]
  }
}

절대 경로 사용하기

호스트는 자체 작업 디렉터리에서 실행되므로 상대 경로는 작동하지 않습니다. args가 스크립트의 절대 경로를 가리키도록 항상 지정하세요.

uv로 더 깔끔하게 구성하기

프로젝트에서 uv를 사용한다면 명령을 uv로 설정하세요. 전역 설치 없이 올바른 환경에서 모듈을 실행할 수 있습니다.

{
  "command": "uv",
  "args": ["run", "server.py"]
}

환경 변수 전달하기

API 키와 같은 비밀 값은 선택 사항인 env 객체에 넣습니다. 호스트가 서버를 시작할 때 이를 주입하므로 코드에 비밀 값이 남지 않습니다.

"env": { "API_KEY": "sk-..." }

적용하려면 다시 시작하기

Claude는 실행할 때만 구성을 읽습니다. 편집한 뒤에는 새 서버를 인식하도록 앱을 완전히 다시 시작해야 합니다.

망치 아이콘

정상적으로 작동하면 채팅에 작은 도구 표시가 나타납니다. 이를 클릭하면 서버가 Claude에 제공하는 도구를 볼 수 있습니다. 🔨

이름을 신중하게 정하기

mcpServers 아래에서 선택한 키가 서버의 이름이 됩니다. 호스트에서 여러 서버가 충돌하지 않도록 짧고 고유하게 정하세요.

빠른 확인

새로 추가한 서버를 Claude Desktop이 불러오게 하려면 어떤 변경이 필요한가요?

인터랙티브 레슨에서 답해보세요

복습

claude_desktop_config.json에 명령, args, env와 함께 서버를 추가하고 절대 경로를 사용한 다음 다시 시작했습니다. 이제 Claude에서 서버가 실행됩니다! ✅

무료로 시작

AI 튜터와 함께 Python을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 30
레슨: 120

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“Claude Desktop에 연결하기” 강의는 무료인가요?

네 — “Claude Desktop에 연결하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“Claude Desktop에 연결하기”에서 뭘 배우나요?

Claude가 서버를 로드하도록 설정을 편집합니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

MCP Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“Claude Desktop에 연결하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← MCP Academy(으)로 돌아가기