Atlas · Model Context Protocol

Atlas MCP 서버 설치 가이드

Atlas ERP·그룹웨어의 재무·위키·문서함 데이터를 Claude Desktop, Cursor, VS Code 등 MCP 클라이언트에서 바로 사용하세요. macOS·Windows 모두 한 줄로 설치되며, 설치에는 로그인이 필요 없습니다. 총 24개 도구(재무 10, 위키 6, 문서함 8)를 제공합니다.

준비물

  • Node.js 18 이상 — 없으면 nodejs.org에서 LTS 설치
  • Windows 사용자: Windows 10 이상(내장 tar) + PowerShell

1. MCP 서버 설치

터미널에서 운영체제에 맞는 명령어 한 줄을 실행하세요.

macOS / Linux
curl -fsSL https://releases.wevesolutions.co.kr/atlas_mcp/install.sh | bash
Windows (PowerShell)
irm https://releases.wevesolutions.co.kr/atlas_mcp/install.ps1 | iex

2. MCP 클라이언트 설정

설치가 끝나면 설정 JSON이 출력됩니다. 이를 MCP 클라이언트(Claude Desktop, Cursor, VS Code, Windsurf 등) 설정 파일에 추가하세요. command는 node 전체 경로,args는 설치 절대 경로를 사용합니다. 아래는 Windows 예시입니다.

설정 JSON (예시)
{
  "mcpServers": {
    "atlas": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\<사용자명>\\atlas-mcp-server\\dist\\index.js"],
      "env": {
        "ATLAS_API_URL": "https://atlas.wevesolutions.co.kr/api",
        "ATLAS_TOKEN": "<발급받은 토큰>"
      }
    }
  }
}

macOS/Linux는 command에 which node 결과(예: /usr/local/bin/node),args에 ~/atlas-mcp-server/dist/index.js를 사용하세요. 설치 스크립트가 출력하는 JSON을 그대로 복사하면 경로가 자동으로 채워집니다.

3. 접근 토큰 발급 (로그인 필요)

데이터 접근에는 개인 접근 토큰이 필요합니다. Atlas 로그인 후 설정 > Atlas MCP에서 발급한 뒤 설정 JSON의 ATLAS_TOKEN에 붙여넣으세요.

지원 도구 (24종)

  • 재무 (10) — 거래내역·원장·분개·재무제표(손익계산서·재무상태표) 조회 및 분개 규칙
  • 위키 (6) — 위키 스페이스·페이지 조회·검색·생성·수정
  • 문서함 (8) — 문서 목록·검색·조회·다운로드·버전·폴더

자주 묻는 질문

Atlas MCP 서버란 무엇인가요?

Atlas MCP 서버는 Atlas ERP·그룹웨어의 재무, 위키, 문서함 데이터를 Claude Desktop·Cursor·VS Code 등 MCP(Model Context Protocol) 호환 클라이언트에서 직접 사용할 수 있게 해주는 로컬 서버입니다. 총 24개 도구(재무 10, 위키 6, 문서함 8)를 제공합니다.

설치에 로그인이 필요한가요?

설치 자체는 로그인이 필요 없습니다. macOS/Linux는 curl 한 줄, Windows는 PowerShell 한 줄로 설치됩니다. 로그인은 접근 토큰(ATLAS_TOKEN)을 발급받을 때만 필요하며, Atlas 로그인 후 설정 > Atlas MCP에서 발급합니다.

사전 준비물은 무엇인가요?

Node.js 18 이상이 필요합니다. 설치돼 있지 않으면 https://nodejs.org 에서 LTS 버전을 먼저 설치하세요. Windows는 PowerShell과 Windows 10 이상(내장 tar)이 필요합니다.

어떤 MCP 클라이언트를 지원하나요?

Claude Desktop, Cursor, VS Code, Windsurf 등 MCP(stdio) 표준을 지원하는 모든 클라이언트에서 사용할 수 있습니다. 설치 후 안내되는 설정 JSON을 각 클라이언트의 MCP 설정에 추가하면 됩니다.

'node: program not found' 오류가 나요.

MCP 클라이언트가 갱신된 PATH를 받지 못해 node 실행 파일을 찾지 못하는 경우입니다. 설정의 command를 node 전체 경로(예: Windows는 C:\Program Files\nodejs\node.exe, macOS/Linux는 'which node' 결과)로 지정하거나, Node 설치 후 MCP 클라이언트를 재시작하세요.

접근 토큰은 어디서 발급하나요?

Atlas에 로그인한 뒤 설정 > Atlas MCP 페이지에서 개인 접근 토큰을 발급합니다. 발급한 토큰을 설정 JSON의 ATLAS_TOKEN 값에 붙여넣으세요.

Atlas — Enterprise Operations Platform · we've solutions