Naru

나루 소개

나루는 사내 레거시 시스템을 AI 에이전트의 MCP 도구로 내놓는 게이트웨이예요. 인증·네트워크·승인·마스킹·감사는 나루가 맡고, 시스템마다의 업무 로직은 pack으로 써요.

나루 관리 → 개요. 시스템, toolset, pack, 사람, 토큰과 최근 기록.나루 관리 → 개요. 시스템, toolset, pack, 사람, 토큰과 최근 기록.
나루 관리 → 개요. 시스템, toolset, pack, 사람, 토큰과 최근 기록.

무엇을 하나요

대상은 그룹웨어·JSP 업무 화면, EAI·API Gateway 뒤의 REST·SOAP, Oracle·Tibero·SQL Server 같은 DB, AD 통합 인증 앱이에요. 레거시가 다양한 까닭은 업무 로직이 아니라 붙는 방법(프로토콜, 인증, 인코딩)이라서, 나루는 층을 셋으로 나눠요.

층 하는 일 누가
인증 plugin 로그인, 토큰, 서명, 세션 갱신 나루(내장 13종) 또는 승인한 코드 plugin
driver http, soap, sql, jdbc 나루. JDBC와 Kerberos는 Java sidecar
function 업무 도구(groupware_approval_list) pack 작성자. 갈피에서 vibe-coding해요

function은 비밀값을 보지 않고 네트워크와 파일에 닿지 못해요. 나루가 인증까지 붙여 준 systems.<이름>.http/soap/sql만 써요. 새 유형의 레거시는 driver나 plugin을 한 번 더하면, 그다음부터는 function만 만들면 돼요.

MCP 클라이언트 ── OAuth 2.1 / 토큰 ──▶ /mcp/<toolset> ─┬─ 정책·승인·마스킹·감사
(갈피, Mothership, Claude…)                           ├─ pack runner (격리된 function)
                                                       └─ 시스템 호출 ─ auth chain ─ driver ─▶ 레거시

누구의 자격으로 부르나요

모드 로그인 사람 표시 예
service 공용 연계 계정 없음 코드성 조회, 재고
onbehalf 공용 연계 계정 부른 사람의 사번을 헤더·SOAP 헤더·DB 세션에 실어요 국내 사내 연계에서 가장 흔해요
personal 각자 자기 계정 그 사람 자신 그룹웨어 결재, 메일

personal 시스템에 아직 계정을 잇지 않은 사람이 부르면 도구는 auth_required와 연결 주소(/connect/<시스템>)를 돌려줘요. 사람은 나루 화면에서 자기 계정을 넣고, 나루가 그 자리에서 실제로 로그인해 봐요. 자격 증명은 LLM을 거치지 않아요.

혼자, 그리고 같이

  • 혼자: 아무 MCP 클라이언트(Claude, Cursor, opencode …)로 toolset을 쓰고, naru CLI로 pack을 개발해요.
  • 갈피와: 갈피 프로젝트에서 pack을 개발해 제출하고, 갈피 채팅에서 toolset을 써요.
  • Mothership과: Mothership 앱이 회사 커넥터로 나루를 불러요. 부른 사람이 누구인지 서명해서 보내요.

구성

경로 내용
apps/server 나루 서버: MCP, OAuth 인가 서버, 관리 API·화면, 개발용 MCP, plugin, driver, pack runner
packages/sdk @naru/sdk: defineFunction, plugin 타입, fixture 하네스, naru CLI
packages/cli naru-admin: 시스템·toolset·배포·plugin·토큰·감사 운영
sidecars/enterprise Java 21 sidecar: JDBC(HikariCP), Kerberos
templates/pack 갈피용 pack 템플릿
examples/ 예제 pack(그룹웨어, ERP, 인사 DB), 가짜 레거시, 코드 plugin 예

다음으로

Esc