MCP 서버 | 설치 매뉴얼 | 로그프레소 스토어

설치 매뉴얼

이 문서는 사설 인증서(자체 서명 또는 내부 CA)로 HTTPS를 종단하는 일반적인 온프레미스 구성을 전제로 합니다. 공인 인증서를 사용하는 배포는 마지막 절의 간단한 등록 방법을 참고하십시오.

1단계. 앱 설치

로그프레소 스토어에서 MCP 서버 앱을 설치합니다. 설치하면 좌측 메뉴에 MCP 서버 항목이 추가됩니다. 고가용성 구성에서는 한 노드에 설치하면 클러스터 전체에 배포되므로 노드마다 설치할 필요가 없습니다.

MCP 엔드포인트는 로그프레소 분석 서버의 웹 콘솔과 같은 HTTPS 리스너에 붙습니다.

https://CONTROL_NODE_HOST/mcp

2단계. API 키 확인

MCP 클라이언트는 사용자 API 키로 인증합니다. 계정에 발급된 API 키가 없으면 관리자에게 발급을 요청하십시오.

Note

사용자 계정에 신뢰 호스트 제한이 설정되어 있으면 MCP 클라이언트를 실행하는 PC의 주소가 허용 목록에 있어야 합니다. 키가 올바른데도 401 오류가 발생하면 API 키보다 신뢰 호스트를 먼저 확인하십시오.

3단계. 설정 탭에서 설정 복사

MCP 서버 화면의 설정 탭을 엽니다. 이 화면은 접속 중인 계정의 API 키를 채운 설정을 만들어 주므로 직접 조립할 필요가 없습니다.

서버 주소 항목의 값을 확인합니다. 이 값은 브라우저가 접속한 주소로 만들어지므로, 로드밸런서나 리버스 프록시 뒤에 있는 배포라면 클라이언트가 접근할 수 있는 외부 주소로 바꿔야 합니다.
API 키 항목의 복사 버튼을 누릅니다. 화면에는 키가 가려져 표시되지만 클립보드에는 실제 값이 복사됩니다.
사용하는 클라이언트에 해당하는 코드 블록의 복사 버튼을 누릅니다. 아래 4단계와 5단계에 그대로 붙여 넣을 수 있는 형태로 API 키까지 채워져 있습니다.

4단계. Claude Code 등록

Node.js가 설치되어 있어야 합니다. 아래 명령에서 CONTROL_NODE_HOST와 API_KEY를 3단계에서 확인한 값으로 바꿉니다.

claude mcp add logpresso -e NODE_TLS_REJECT_UNAUTHORIZED=0 -- npx -y mcp-remote https://CONTROL_NODE_HOST/mcp --header "Authorization: Bearer API_KEY"

-e NODE_TLS_REJECT_UNAUTHORIZED=0 옵션이 사설 인증서를 허용합니다. 이 옵션이 없으면 인증서 검증에 실패하여 접속되지 않습니다.
기본 적용 범위는 명령을 실행한 디렉터리입니다. 모든 프로젝트에서 사용하려면 -s user 옵션을 추가합니다.
등록된 서버를 확인하려면 claude mcp list, 삭제하려면 claude mcp remove logpresso 명령을 사용합니다.

5단계. Claude Desktop 등록

설정 파일을 편집기로 열어 아래 내용을 넣습니다. 이미 다른 MCP 서버가 등록되어 있다면 mcpServers 안에 logpresso 항목만 추가합니다.

운영체제	설정 파일 경로
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "logpresso": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://CONTROL_NODE_HOST/mcp",
        "--header", "Authorization: Bearer API_KEY"
      ],
      "env": {
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

env 항목의 NODE_TLS_REJECT_UNAUTHORIZED가 4단계의 -e 옵션과 같은 역할을 합니다.

6단계. 연결 확인

MCP 서버는 클라이언트 세션이 시작될 때 연결됩니다. 설정을 변경한 뒤에는 클라이언트를 반드시 재시작하십시오.

연결에 성공하면 MCP 서버 화면의 로그 탭에 initialize와 tools/list 요청이 기록됩니다.

증상	확인할 것
로그에 아무 요청도 없다	클라이언트를 재시작했는지, 서버 주소가 클라이언트에서 접근 가능한지
상태가 `오류`로 기록된다	로그 상세 화면의 거부 사유. 인증 실패는 API 키와 신뢰 호스트를 확인
인증서 관련 오류가 클라이언트에 보인다	`NODE_TLS_REJECT_UNAUTHORIZED` 설정이 빠졌는지

공인 인증서를 사용하는 경우

인증서 검증이 정상적으로 통과하는 배포에서는 Claude Code에 브리지 없이 바로 등록할 수 있습니다.

claude mcp add --transport http logpresso https://CONTROL_NODE_HOST/mcp -H "Authorization: Bearer API_KEY"