약 5분
권장Docker Compose 저장소에 포함된 Compose 설정으로 전체 셀프 호스팅 서비스를 실행합니다. 약 10분
ASP.NET Core / NuGet 기존 ASP.NET Core 애플리케이션에 MCP 런타임과 선택적 관리자 UI를 내장합니다. 설치 후
MCP 클라이언트 연결 권한 범위를 제한한 키를 발급하고 Claude Desktop, Cursor 또는 다른 Streamable HTTP 클라이언트를 연결합니다. Docker Compose
- 환경 설정 파일 만들기
설정을 명시적으로 관리하고 검토할 수 있도록 저장소의 예제 파일을 복사합니다.
cp .env.example .env - 서명용 비밀값 교체
HMAC_KEY와 JWT_KEY에는 서로 다른 32바이트 이상의 고유한 값을 설정합니다.
.env.example의 값은 예시입니다. 그대로 운영 환경에 배포하지 마세요. - 서비스 실행
기본 단일 인스턴스 구성을 시작합니다.
docker compose up -d - 관리자 화면 열기
기본 애플리케이션은 8080 포트에서 수신합니다.
로컬 환경에서는
http://localhost:8080을 열고 첫 관리자 설정을 완료합니다.
첫 MCP 키 발급
- Runtime → MCP Keys 열기
MCP 키는 클라이언트 식별과 권한 검사의 경계입니다.
- 데이터베이스와 도구 권한 범위 선택
키를 하나의 Database Management 항목에 연결하고 클라이언트에 필요한 도구만 허용합니다.
- 평문 키 복사
발급 직후 대화상자에 표시되는 비밀값을 복사해 클라이언트의 안전한 비밀 저장소에 보관합니다.
- 생성된 클라이언트 설정 사용
또는 Streamable HTTP 엔드포인트 요청에 X-MCP-Server-Key 헤더로 비밀값을 전달합니다.
기본 MCP 엔드포인트는 /mcp입니다. 다른 장치에서 접속한다면 MCP_PUBLIC_ENDPOINT에 외부에서 접근 가능한 HTTP 또는 HTTPS 절대 URL을 /mcp까지 포함해 설정하세요.