← 메인으로 돌아가기

빠른 시작 가이드

5분 안에 Nexol MCP 서비스를 설정하고 사용하는 방법을 알아봅니다.

1

API Key 발급 요청

MCP 서비스를 사용하려면 먼저 API Key를 발급받아야 합니다.

신청 방법: roy.cho@nexol.co.kr로 아래 정보와 함께 요청하세요.

• 이름 / 부서
• 사용 목적
• 필요 리소스 (MySQL, MSSQL, Redmine, Draw 중 선택)
2

Claude Code 설치 확인

Claude Code가 설치되어 있는지 확인합니다.

claude --version

설치되어 있지 않다면 공식 사이트에서 다운로드하세요.

3

MCP 서버 등록

발급받은 API Key로 Nexol MCP를 등록합니다. 아래 두 가지 방법 중 하나를 선택하세요.

방법 A: CLI 명령어 (권장)

# YOUR_API_KEY를 발급받은 키로 교체하세요
claude mcp add --scope user --transport sse nexol-mcp "https://mcp.nexol.co.kr/sse?key=YOUR_API_KEY"

방법 B: 설정 파일 직접 수정

~/.claude/settings.json 파일에 추가:

{
  "mcpServers": {
    "nexol-mcp": {
      "type": "sse",
      "url": "https://mcp.nexol.co.kr/sse?key=YOUR_API_KEY"
    }
  }
}
4

등록 확인

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

claude mcp list

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

nexol-mcp: https://mcp.nexol.co.kr/sse?key=... - ✓ Connected

Cursor IDE 설정

1

MCP 설정 열기

Cursor → Settings → MCP 메뉴를 엽니다.

2

MCP 서버 추가

+ Add new global MCP server 클릭 후 아래 JSON을 붙여넣습니다.

{
  "mcpServers": {
    "nexol-mcp": {
      "type": "sse",
      "url": "https://mcp.nexol.co.kr/sse?key=YOUR_API_KEY"
    }
  }
}
참고: YOUR_API_KEY를 발급받은 실제 API Key로 교체하세요.
5

사용하기

이제 Claude Code에서 MCP 도구를 사용할 수 있습니다.

# Claude Code 시작
claude

# 예시: 다이어그램 생성
"플로우차트를 그려줘: 시작 -> 처리 -> 종료"

# 예시: 문서 검색
"React useState 사용법 알려줘"

# 예시: 코드 분석
"이 프로젝트의 구조를 분석해줘"
참고: VPN 연결이 필요할 수 있습니다. 사내 네트워크에서만 접근 가능합니다.

사용 가능한 도구

도구 설명 예시
draw 다이어그램 생성 "ERD 그려줘"
context7 문서 검색 "Next.js 라우팅 문서"
playwright 브라우저 자동화 "웹페이지 스크린샷"
serena 코드 분석 "함수 참조 찾기"
sequential-thinking 단계별 분석 복잡한 문제 해결

문제 해결

연결 오류 시

# MCP 삭제 후 재등록 (YOUR_API_KEY를 발급받은 키로 교체)
claude mcp remove nexol-mcp
claude mcp add --scope user --transport sse nexol-mcp "https://mcp.nexol.co.kr/sse?key=YOUR_API_KEY"

상태 확인

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

추가 리소스

GitLab 저장소

소스 코드와 문서는 GitLab에서 확인하세요: