Claude Code MCP: How to Add MCP Servers (Complete Guide)
- MCP 서버는 Claude Code 에이전트의 기능을 파일 쓰기, 웹 검색을 넘어 GitHub 연결, 데이터베이스 업데이트, 이메일 전송 등 다양한 작업으로 확장합니다. 🚀
- MCP 서버는 로컬에서 실행되는 'Standard IO' 방식과 원격 서버에 호스팅되는 'Remote (HTTP/SSE)' 방식으로 나뉘며, Remote 방식이 설정하기 가장 쉽습니다. 🌐
- 원격 서버 추가는
claude mcp add -t [http|sse] [서버_이름] [URL] 명령어를 사용하며, API 키와 같은 헤더 정보는 --header 옵션으로 전달할 수 있습니다. 🔗
- MCP 서버는
local (현재 사용자 프로젝트), project (모든 팀원 프로젝트), user (모든 프로젝트) 세 가지 범위로 설정할 수 있어 유연한 관리가 가능합니다. 🎯
- Standard IO 서버 추가는
claude mcp add [서버_이름] -- [실행_명령어] [인수들] 형식을 따르며, npx와 같은 로컬 명령어를 실행합니다. 💻
- Windows 환경에서 WSL 없이 Standard IO 서버를 사용할 경우,
npx 대신 cmd /c를 명령어 앞에 붙여야 연결 실패를 방지할 수 있습니다. 윈도우즈 🛠️
- 환경 변수가 필요한 Standard IO 서버는 서버 이름 뒤에
-e [변수명]=[값] 옵션을 추가하여 API 키 등을 안전하게 전달할 수 있습니다. 🔑
- Context 7 서버는 최신 기술 문서를 참조하여 에이전트가 정확한 답변을 제공하도록 돕고, Bright Data 서버는 웹 스크래핑을 통해 기사 요약과 같은 작업을 수행할 수 있음을 시연했습니다. 📚✨