이 장에서는 클로드 코드에 MCP 서버를 실제로 연결하는 방법을 다룹니다.

1. 가장 쉬운 방법: 클로드에게 부탁하기

가장 쉬운 방법은, 설치 방법을 직접 찾지 않고 클로드 코드에게 연결을 요청하는 것입니다.

Playwright MCP를 연결해줘.

이렇게만 해도 클로드가 필요한 설정을 찾아 연결해주는 경우가 많습니다. 추천 MCP(GitHub, Playwright, Context7, Notion, Slack 등) 대부분이 이 방식으로 설치됩니다.

2. /mcp로 상태 확인

연결된 MCP 서버의 상태를 확인하거나 인증을 진행하려면 /mcp 명령을 사용합니다.

/mcp

연결된 서버 목록과 상태가 표시됩니다. 일부 서버는 처음 사용할 때 로그인/인증이 필요한데, 여기서 진행할 수 있습니다.

3. 명령어로 직접 추가/관리

터미널에서 명령어로 직접 MCP를 추가·확인·제거할 수도 있습니다.

# MCP 추가 (이름: hojun, 파이썬 스크립트 실행)
claude mcp add hojun python C:\test\tutorial_1.py

# MCP 목록 확인
claude mcp list

# MCP 제거
claude mcp remove hojun

설정은 파일로도 관리됩니다. 프로젝트 단위로 공유하려면 .mcp.json에 설정을 두고 Git에 커밋하면 팀 전체가 같은 MCP 구성을 공유할 수 있습니다.

4. 직접 만든 MCP 서버 연결하기

간단한 MCP 서버를 직접 만들어 연결할 수도 있습니다. 아래는 입력 메시지를 그대로 돌려주는 파이썬 MCP 서버 예시입니다.

tutorial_1.py:

from mcp.server.fastmcp import FastMCP

# MCP 서버 생성
mcp = FastMCP(name="tutorial_1")


# 간단한 에코 도구
@mcp.tool()
def echo(message: str) -> str:
    return message + " 라는 메시지가 입력되었습니다. hello world!"


# 서버 실행
if __name__ == "__main__":
    mcp.run()

이 서버를 앞의 claude mcp add 명령으로 등록하면, 클로드가 echo 도구를 사용할 수 있게 됩니다.

5. 연결 후 점검

MCP를 연결한 뒤에는 두 가지를 점검하세요.

1. 동작 확인: /mcp로 상태가 정상(연결됨)인지 확인합니다.
2. 컨텍스트 점검: /context로 MCP가 차지하는 컨텍스트가 과하지 않은지 봅니다. 안 쓰는 MCP는 정리합니다.

여기까지 클로드 코드의 핵심 확장 기능(커맨드, Hooks, Skills, Subagents, MCP)을 모두 다뤘습니다. 다음 챕터에서는 이 모든 것을 실전에서 어떻게 엮어 쓰는지, 그리고 안전하게 자율 작업을 시키는 법을 살펴봅니다.