MessagesMCP 터널

MCP 터널 빠른 시작

로컬 Docker Compose 배포를 사용하여 Claude를 프라이빗 MCP 서버에 연결합니다.

MCP 터널은 리서치 프리뷰 단계입니다. 사용해 보시려면 액세스를 요청하세요.

이 빠른 시작 가이드는 아무것도 없는 상태에서 시작하여 Claude가 터널을 통해 프라이빗 MCP 서버를 호출하는 단계까지 안내합니다. 수동 자격 증명 프로비저닝과 함께 Docker Compose를 사용하며, 이는 로컬 테스트를 위한 가장 빠른 방법입니다. 프로덕션 배포에 대해서는 Helm으로 배포 또는 Docker Compose로 배포를 참조하세요.

구축할 내용

두 개의 컨테이너로 구성된 터널 스택(프록시와 cloudflared)과 그 옆에서 실행되는 샘플 MCP 서버를 구축합니다. 모든 것이 실행되면 퍼블릭 포트에서 아무것도 수신 대기하지 않더라도 샘플 서버는 Claude에서 https://echo.<your-tunnel-domain>/mcp로 접근할 수 있습니다.

필요한 것

아웃바운드 인터넷 액세스가 가능한 머신에 설치된 Docker 및 Docker Compose.
MCP 터널을 관리할 수 있는 Claude Console 역할. Console 가이드 사전 요구 사항을 참조하세요.
OpenSSL 1.1.1 이상. macOS 및 대부분의 Linux 배포판에는 사전 설치되어 있습니다. Windows에서는 별도로 설치해야 합니다(openssl 바이너리가 PATH에 있어야 함).

터널 생성
Claude Console 사이드바에서 Manage > MCP tunnels로 이동하여 New tunnel을 클릭하세요. 이름을 지정하세요. Set up programmatic access는 끈 상태로 두세요. 이 빠른 시작에서는 수동 자격 증명 프로비저닝을 사용합니다.
생성된 후 터널을 여세요. Connection 섹션에서 두 값을 복사하세요:
- Domain (abcd1234.tunnel.anthropic.com과 같은 형식)
- Token (눈 아이콘을 클릭한 후 복사)
배포 디렉터리 설정
CA 및 서버 인증서 생성
프록시는 사용자가 제어하는 CA가 서명한 인증서를 사용하여 내부 TLS를 종료합니다. 두 가지 모두 생성하세요:
Console로 돌아가서 터널 상세 페이지에서 Add certificate를 클릭하고 data/ca.crt를 업로드하세요(또는 내용을 붙여넣으세요). 터널 상태가 Active로 바뀝니다.
샘플 MCP 서버 작성
프록시 구성 및 compose 파일 작성
시작
echo에 대한 route configured 라인 하나와 Registered tunnel connection 라인 네 개가 표시되어야 합니다. 컨테이너가 시작되는 데 몇 초가 걸리므로 로그가 비어 있으면 로그 명령을 다시 실행하세요.
Claude에서 호출
Console에서 Managed Agents > Sessions로 이동하여 세션을 생성하세요. 에이전트 선택기에서 Create new agent를 선택하고 에이전트 이름을 지정한 후 미리 채워진 모델을 유지하세요. + MCP Server를 클릭하고 터널을 선택한 다음 Subdomain을 echo로, Path를 mcp로 설정하세요. 그런 다음 다음과 같이 요청하세요:

Use the hello tool to greet tunnel.

도구 호출과 그 결과가 표시되어야 합니다.

다음 단계

터널이 엔드 투 엔드로 검증되었습니다. 자체 MCP 서버로 교체하려면 docker-compose.yaml에 추가하고(또는 동일한 Docker 네트워크에서 실행하고), config/mcp-proxy.yaml에 해당 라우트를 추가한 다음 프록시를 재시작하세요(docker compose restart mcp-proxy).

프로덕션 배포의 경우:

Docker Compose로 배포

프로그래매틱 액세스 유무에 관계없이 강화된 단일 호스트 배포.

Helm으로 배포

자동 자격 증명 관리를 지원하는 Kubernetes 배포.

Was this page helpful?

구축할 내용

필요한 것

아웃바운드 인터넷 액세스가 가능한 머신에 설치된 Docker 및 Docker Compose.

MCP 터널을 관리할 수 있는 Claude Console 역할. Console 가이드 사전 요구 사항을 참조하세요.

OpenSSL 1.1.1 이상. macOS 및 대부분의 Linux 배포판에는 사전 설치되어 있습니다. Windows에서는 별도로 설치해야 합니다(openssl 바이너리가 PATH에 있어야 함).

터널 생성
Claude Console 사이드바에서 Manage > MCP tunnels로 이동하여 New tunnel을 클릭하세요. 이름을 지정하세요. Set up programmatic access는 끈 상태로 두세요. 이 빠른 시작에서는 수동 자격 증명 프로비저닝을 사용합니다.
생성된 후 터널을 여세요. Connection 섹션에서 두 값을 복사하세요:
- Domain (abcd1234.tunnel.anthropic.com과 같은 형식)
- Token (눈 아이콘을 클릭한 후 복사)
배포 디렉터리 설정
CA 및 서버 인증서 생성
프록시는 사용자가 제어하는 CA가 서명한 인증서를 사용하여 내부 TLS를 종료합니다. 두 가지 모두 생성하세요:
Console로 돌아가서 터널 상세 페이지에서 Add certificate를 클릭하고 data/ca.crt를 업로드하세요(또는 내용을 붙여넣으세요). 터널 상태가 Active로 바뀝니다.
샘플 MCP 서버 작성
프록시 구성 및 compose 파일 작성
시작
echo에 대한 route configured 라인 하나와 Registered tunnel connection 라인 네 개가 표시되어야 합니다. 컨테이너가 시작되는 데 몇 초가 걸리므로 로그가 비어 있으면 로그 명령을 다시 실행하세요.
Claude에서 호출
Console에서 Managed Agents > Sessions로 이동하여 세션을 생성하세요. 에이전트 선택기에서 Create new agent를 선택하고 에이전트 이름을 지정한 후 미리 채워진 모델을 유지하세요. + MCP Server를 클릭하고 터널을 선택한 다음 Subdomain을 echo로, Path를 mcp로 설정하세요. 그런 다음 다음과 같이 요청하세요:

Use the hello tool to greet tunnel.

도구 호출과 그 결과가 표시되어야 합니다.

다음 단계

프로덕션 배포의 경우:

Was this page helpful?