← 메인으로 돌아가기

설치 매뉴얼

Nexol MCP 서비스를 Claude Desktop 또는 Claude Code에 설치하는 방법입니다.

사전 요구사항

항목요구사항
Claude Code최신 버전 (claude --version으로 확인)
네트워크사내 네트워크 또는 VPN 연결
OSWindows 10+, macOS 10.15+, Linux

Claude Code 설치

1

Claude Code 설치 확인

터미널에서 Claude Code가 설치되어 있는지 확인합니다.

claude --version

버전이 출력되면 설치되어 있는 것입니다. 설치되어 있지 않다면 아래 명령으로 설치하세요.

2

Claude Code 설치 (미설치 시)

macOS / Linux

curl -fsSL https://claude.ai/install.sh | sh

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

Nexol MCP 등록

3

MCP 서버 등록

아래 명령어를 실행하여 Nexol MCP를 등록합니다.

claude mcp add --scope user --transport sse nexol-mcp https://mcp.nexol.co.kr/gateway/sse
참고: --scope user는 현재 사용자에게만 적용됩니다. 시스템 전체에 적용하려면 --scope system을 사용하세요.
4

등록 확인

MCP가 정상적으로 등록되었는지 확인합니다.

claude mcp list

아래와 같이 표시되면 성공입니다:

nexol-mcp: https://mcp.nexol.co.kr/gateway/sse - ✓ Connected

Claude Desktop 설정 (선택)

5

설정 파일 편집

Claude Desktop을 사용하는 경우, 설정 파일을 직접 편집할 수 있습니다.

설정 파일 위치

설정 내용

{
  "mcpServers": {
    "nexol-mcp": {
      "url": "https://mcp.nexol.co.kr/gateway/sse",
      "transport": "sse"
    }
  }
}

문제 해결

연결 실패 시

# MCP 삭제 후 재등록
claude mcp remove nexol-mcp
claude mcp add --scope user --transport sse nexol-mcp https://mcp.nexol.co.kr/gateway/sse

네트워크 오류 시

VPN 연결을 확인하거나, 사내 네트워크에 있는지 확인하세요.

# 서비스 상태 확인
curl https://mcp.nexol.co.kr/gateway/health

{"status":"healthy"}가 출력되면 서버는 정상입니다.

지원: 문제가 지속되면 ai@nexol.co.kr로 문의하세요.