M MCP모아
튜토리얼

네이웍스 MCP 서버 설치·사용법 — LINE WORKS(NAVER WORKS)

nworks MCP 서버를 Claude Desktop·Cursor에 연결해 LINE WORKS 메시지·캘린더·드라이브를 AI로 제어하는 단계별 설치 가이드입니다.

네이웍스 MCP 서버가 Claude Desktop에서 LINE WORKS 메시지·캘린더·드라이브를 제어하는 구성도

LINE WORKS(NAVER WORKS) 업무 환경을 AI로 자동화하고 싶다면 nworks MCP 서버가 가장 빠른 길입니다. npx nworks mcp 한 줄로 실행 가능한 이 서버는 Claude Desktop·Cursor 등 MCP 호환 클라이언트에서 메시지·캘린더·드라이브·메일·할일·게시판을 포함한 26개 도구를 자연어로 제어할 수 있게 해 줍니다. API 키 발급부터 설정 파일 작성, 흔한 오류 해결까지 이 글 한 편으로 끝낼 수 있습니다.

네이웍스 MCP 서버가 필요한 이유

LINE WORKS는 국내 중소기업·스타트업이 널리 사용하는 협업 플랫폼입니다. 메시지, 캘린더, 드라이브, 메일이 한 곳에 있어 편리하지만, 반복 업무—예약 메시지 발송, 일정 취합, 드라이브 파일 정리—는 여전히 사람이 직접 클릭해야 했습니다.

nworks MCP 서버를 Claude에 연결하면 이런 작업을 자연어 명령 한 문장으로 처리할 수 있습니다.

사용자 → Claude (MCP 클라이언트)
              ↓ MCP 프로토콜 (stdio)
         nworks MCP 서버 (npx)
              ↓ HTTPS REST
         LINE WORKS API (worksmobile.com)

AI가 LINE WORKS API를 대신 호출하고 결과를 요약해 돌려주는 구조입니다.

제공 도구 목록

nworks MCP 서버는 현재 아래 카테고리로 26개 도구를 제공합니다.

카테고리주요 기능
메시지채널 메시지 목록 조회, 메시지 전송, DM 발송
캘린더일정 목록 조회, 일정 생성·수정·삭제
드라이브파일 목록 조회, 파일 다운로드·업로드
메일받은 메일 목록, 메일 읽기, 메일 발송
할일(Task)할일 목록 조회, 할일 추가·완료 처리
게시판게시물 목록 조회, 게시물 읽기

전체 도구 명세는 GitHub 저장소의 README에서 확인할 수 있습니다.

준비물

설치 전 다음 세 가지를 미리 준비하세요.

  1. Node.js 18 이상 — node -v로 확인. 없으면 nodejs.org에서 설치.
  2. LINE WORKS Developer Console 계정 — developers.worksmobile.com 에서 가입(LINE WORKS 계정 필요).
  3. Claude Desktop (또는 MCP를 지원하는 다른 클라이언트).

단계별 설치 방법

1단계 — LINE WORKS API 키 발급

LINE WORKS API를 사용하려면 OAuth 2.0 기반의 서비스 계정(Service Account) 인증이 필요합니다.

  1. developers.worksmobile.com 에 로그인합니다.
  2. 좌측 메뉴에서 API → 앱 등록을 선택합니다.
  3. 앱 이름을 입력하고 권한 범위(Scope) 에서 필요한 항목(메시지, 캘린더, 드라이브 등)을 체크합니다.
  4. 등록 완료 후 아래 네 가지 값을 메모합니다.
값위치
Client ID앱 상세 페이지
Client Secret앱 상세 페이지
Service Account앱 상세 → 서비스 계정 탭
Private Key (PEM)서비스 계정 발급 시 다운로드

주의: Private Key PEM 파일은 한 번만 다운로드할 수 있습니다. 안전한 위치에 저장하세요.

2단계 — Node.js 설치 확인

node -v
# v20.x.x 이상이 출력되면 정상
npm -v

출력이 없거나 버전이 낮다면 nodejs.org LTS 버전을 설치하세요.

3단계 — Claude Desktop 설정 파일 수정

Claude Desktop의 MCP 서버 설정 파일을 열어 nworks 항목을 추가합니다.

설정 파일 위치

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

아래 내용을 mcpServers 블록 안에 추가합니다. PEM 키는 줄바꿈을 \n으로 이스케이프해 한 줄 문자열로 입력합니다.

{
  "mcpServers": {
    "nworks": {
      "command": "npx",
      "args": ["nworks", "mcp"],
      "env": {
        "LINE_WORKS_CLIENT_ID": "여기에_Client_ID",
        "LINE_WORKS_CLIENT_SECRET": "여기에_Client_Secret",
        "LINE_WORKS_SERVICE_ACCOUNT": "여기에_Service_Account",
        "LINE_WORKS_PRIVATE_KEY": "-----BEGIN RSA PRIVATE KEY-----\n...(PEM 내용)...\n-----END RSA PRIVATE KEY-----"
      }
    }
  }
}

이미 다른 MCP 서버가 있다면 mcpServers 객체 안에 nworks 키만 추가하면 됩니다.

4단계 — Claude Desktop 재시작 및 확인

  1. Claude Desktop을 완전히 종료했다가 다시 실행합니다.
  2. 새 채팅을 열고 아래처럼 입력해 보세요.
네이웍스 받은 메일 목록 5개 보여줘

Claude가 nworks 도구를 호출해 메일 제목·발신자·날짜를 목록으로 출력하면 연결 성공입니다.

흔한 오류와 해결 방법

오류 1 — “spawn npx ENOENT”

npx 실행 파일을 찾지 못할 때 발생합니다. macOS에서 Node.js를 nvm으로 설치했다면 절대 경로를 사용해야 합니다.

{
  "command": "/Users/사용자명/.nvm/versions/node/v20.x.x/bin/npx",
  "args": ["nworks", "mcp"]
}

which npx 명령으로 실제 경로를 확인하세요.

오류 2 — “401 Unauthorized” 또는 “invalid_client”

API 자격 증명이 잘못됐을 때 나타납니다. 확인 사항:

  • Client ID / Client Secret 값이 복사 과정에서 공백·개행이 포함됐는지 점검합니다.
  • Developer Console에서 해당 앱의 권한 범위가 활성화(승인)됐는지 확인합니다.
  • Private Key PEM에서 \n이 실제 줄바꿈이 아닌 이스케이프 문자로 입력됐는지 확인합니다.

오류 3 — 도구 목록이 표시되지 않음

설정 파일 JSON 문법 오류가 원인인 경우가 많습니다. jsonlint.com 같은 도구로 claude_desktop_config.json 을 붙여 넣어 유효성을 먼저 검사하세요.

활용 예시

nworks MCP가 연결되면 Claude에게 아래처럼 자연어로 지시할 수 있습니다.

명령 예시내부 동작
”오늘 캘린더 일정 모두 알려줘”캘린더 조회 도구 호출
”홍길동에게 ‘내일 회의 확인 부탁드립니다’ DM 보내줘”메시지 전송 도구 호출
”이번 주 마감인 할일 목록 요약해 줘”할일 조회 → 요약
”드라이브 루트 폴더 파일 목록 보여줘”드라이브 목록 조회 도구 호출

관련 MCP 서버

LINE WORKS와 함께 쓰면 시너지가 나는 다른 MCP 서버도 살펴보세요.

더 많은 MCP 서버는 MCP모아 서버 목록에서 찾아볼 수 있습니다.

자주 묻는 질문

nworks MCP 서버는 무료인가요?

nworks 패키지 자체는 오픈소스 무료입니다. 다만 LINE WORKS API는 요금제에 따라 무료/유료 플랜이 있으며, API 호출 한도도 플랜별로 다릅니다. 자세한 내용은 developers.worksmobile.com 요금 정책 페이지를 참고하세요.

NAVER WORKS와 LINE WORKS는 같은 서비스인가요?

같은 서비스입니다. 2021년 네이버 비즈니스 플랫폼이 LINE과 협업한 이후 국내에서는 NAVER WORKS, 글로벌에서는 LINE WORKS로 불리다가 현재는 LINE WORKS로 브랜드가 통일됐습니다.

어떤 기능을 AI로 제어할 수 있나요?

nworks MCP는 메시지 송수신, 캘린더 일정 조회·생성, 드라이브 파일 관리, 메일 읽기·보내기, 할일(Task) 관리, 게시판 조회 등 26개 도구를 제공합니다.

Claude Desktop 외에 Cursor·VS Code에서도 쓸 수 있나요?

네, MCP를 지원하는 모든 클라이언트에서 사용 가능합니다. Cursor는 .cursor/mcp.json, VS Code는 settings.json의 mcp 블록에 같은 방식으로 설정합니다.

API 키를 잘못 입력하면 어떻게 되나요?

Claude에서 nworks 도구를 호출할 때 ‘인증 오류’ 또는 ‘401 Unauthorized’ 메시지가 반환됩니다. 환경 변수 이름과 값이 정확한지, Developer Console에서 권한 범위(Scope)가 활성화됐는지 다시 확인하세요.

npx 실행 시 패키지를 찾을 수 없다는 오류가 나요.

Node.js 버전이 18 미만이거나 네트워크 문제로 npm 레지스트리에 접근하지 못할 때 발생합니다. node -v로 버전을 확인하고, npm install -g nworks로 전역 설치를 먼저 시도해 보세요.

다음 단계

nworks MCP 서버를 설치했다면 이제 Claude에게 반복 업무를 맡겨 보세요. 일정 취합, 채널 공지 발송, 드라이브 파일 정리 등 단순 클릭 작업을 자연어 한 문장으로 처리할 수 있습니다. 더 다양한 한국 서비스 연동 MCP 서버는 MCP모아 가이드 목록에서 계속 업데이트됩니다. 직접 만든 MCP 서버가 있다면 서버 등록 페이지를 통해 MCP모아에 등록해 보세요.

이 글과 관련된 MCP 서버