Naru

로컬에서 써 보기

가짜 그룹웨어·ERP·인사 DB와 함께 나루를 띄우고, 시스템을 등록하고, 예제 pack을 배포해 MCP 클라이언트로 불러요.

띄우기

Node.js 24와 pnpm이 필요해요.

bash
corepack enable && pnpm install
pnpm --filter @naru/sdk run build
mkdir -p data && node examples/legacy-mock/src/main.ts &   # 가짜 그룹웨어(:18081)·ERP(:18082)·인사 DB
NARU_DEV=1 NARU_ALLOW_LOOPBACK=1 ADMIN_EMAILS=admin@corp.example pnpm dev:server   # :8080
  • 가짜 레거시는 ./data/hr.sqlite에 인사 DB를 만들어요(HR_DB로 바꿔요). 그래서 data/ 폴더가 먼저 있어야 해요.
  • NARU_ALLOW_LOOPBACK=1은 localhost의 가짜 레거시에 닿게 해요. 개발 전용이에요.
  • 다른 서비스가 8080을 쓰면 PORT=8090 PUBLIC_URL=http://localhost:8090처럼 바꿔요.

http://localhost:8080/admin을 열고 admin@corp.example을 넣어요. SMTP가 없으면 코드와 링크가 서버 로그에 찍혀요.

로그인. 등록된 주소로 코드를 받아요.로그인. 등록된 주소로 코드를 받아요.
로그인. 등록된 주소로 코드를 받아요.

관리 토큰과 naru-admin

화면에서도 다 되지만, 설정 파일로 한 번에 넣으면 빨라요. 관리 → 사람과 토큰 → 토큰 → 토큰 발급에서 종류 개인으로 관리자 토큰(naru_pat_…)을 받아요.

bash
export NARU_URL=http://localhost:8080 NARU_TOKEN=naru_pat_…
alias naru-admin="node $PWD/packages/cli/bin/naru-admin.js"   # 저장소 루트에서 한 번
참고

naru-admin은 저장소의 packages/cli예요. 저장소 체크아웃에서는 pnpm install 뒤에 Node만으로 돌고, 나루 이미지 안에도 들어 있어요(docker compose exec naru naru-admin --help).

시스템 등록

systems.yaml에 여러 시스템을 ---로 나눠 적어요. 가짜 그룹웨어(personal, EUC-KR, CSRF 폼 로그인)와 인사 DB(service, 읽기 전용) 예예요.

systems.yaml
slug: groupware
env: prod
name: 그룹웨어
driver: http
endpoint: { baseUrl: "http://127.0.0.1:18081", probe: /main.do }
transport: { charset: euc-kr }
mode: personal
auth:
  - plugin: login-flow
    config:
      steps:
        - { url: /login.jsp, extract: { csrf: { selector: "input[name=_csrf]", attr: value } } }
        - { method: POST, url: /loginProc.do, form: { userId: "{{account.id}}", passwd: "{{secret.password}}", _csrf: "{{csrf}}" }, expect: { bodyNotContains: 로그인 실패, urlContains: /main.do } }
      expired: { redirectTo: /login.jsp }
---
slug: hr
env: prod
name: 인사 DB
driver: sql
endpoint: { dialect: sqlite, file: ./data/hr.sqlite }
transport: { readOnly: true }
mode: service
bash
naru-admin systems apply systems.yaml
naru-admin systems list
naru-admin systems test <id>         # 실제 로그인 + 확인 요청

ERP(토큰 + HMAC REST, WS-Security SOAP) 예는 apps/server/test/e2e.test.ts에 있어요. 비밀값은 표준 입력으로 넣어요: printf 'erp-client-secret-0001' | naru-admin systems secret <id> client_secret.

관리 → 시스템. 시스템마다 driver, 모드, 인증 체인, 빠진 비밀값.관리 → 시스템. 시스템마다 driver, 모드, 인증 체인, 빠진 비밀값.
관리 → 시스템. 시스템마다 driver, 모드, 인증 체인, 빠진 비밀값.

예제 pack 배포

pack은 개발 토큰(한 pack에 묶인 naru_dev_…)으로 제출하고, 운영(prod) 배포는 관리자가 해요.

bash
naru-admin users add --email hong@corp.example --name 홍길동 --role developer --employee-no 20240001
naru-admin users list                                   # hong의 id(usr_…)
naru-admin tokens issue --kind dev --name 그룹웨어 --pack groupware --user <usr_…>
node packages/sdk/bin/naru.js submit examples/packs/groupware --url $NARU_URL --token <naru_dev_…>
naru-admin packs releases groupware
naru-admin packs deploy groupware prod <releaseId>

toolset 만들기

toolsets.yaml
slug: corp
env: prod
name: 사내 업무
include: ["*"]
maxRisk: high
approval: elicitation
masking: [rrn, phone]
bash
naru-admin toolsets apply toolsets.yaml   # → http://localhost:8080/mcp/corp

MCP 클라이언트로 부르기

toolset 주소는 OAuth 2.1을 지원하는 MCP 서버예요. 클라이언트가 처음 붙을 때 나루 로그인 창이 떠요.

bash
claude mcp add --transport http naru-corp http://localhost:8080/mcp/corp

groupware_approval_list를 부르면 처음에는 auth_required와 연결 주소가 와요. 그 주소에서 그룹웨어 계정(hong / hong-pass-1234)을 넣으면 다음부터 그 사람으로 불러요.

테스트

bash
pnpm --filter @naru/sdk run build
pnpm -r run typecheck
pnpm -r run test                    # 서버 E2E(MCP SDK 클라이언트, OAuth, 개발 MCP, plugin, NTLM), SDK, pack fixture
sh sidecars/enterprise/build.sh     # Java sidecar 빌드 + JUnit
pnpm test:integration               # Docker: PostgreSQL·SQL Server·Oracle Free, 실제 JVM sidecar
Esc