기관표준용어 시스템 · 2026

공통표준용어
MCP 서버

AI가 사내 DB 설계 규칙을 직접 알고
정확한 컬럼명을 추천하는 시스템

v1.0.0

표준 단어 · 도메인 · 용어 MCP 26 도구 REST + Swagger SKILL × 8 + Harness 관리자 패널 · 편집 Prometheus /metrics DDL 자동 검증 감사 로그 · 알림

Claude 스킬 다운로드 ncaco-std-skills.zip · 8가지 슬래시 커맨드

WHY WE BUILT THIS

매번 반복되는 이런 질문들...

01

이 필드 영문명 뭐로 하지? CUST야, CUST_ID야?

02

공통표준에 이 용어 있어? 엑셀 어디 있더라...

03

Claude한테 물어봤더니 맘대로 컬럼명 짓더라

SOLUTION

std-mcp 가 해결합니다

Claude / LLM

Claude, Cursor
Windsurf IDE

MCP 프로토콜

std-mcp 서버

26가지 도구
Python + FastAPI

SQLAlchemy

MariaDB

표준단어 · 도메인
용어 3종 DB

AI가 공통표준용어 DB에 직접 접근해
정확한 컬럼명과 도메인 규칙을 제안합니다.
설계자가 일일이 엑셀을 뒤질 필요가 없습니다.

DATA CATALOG

3가지 표준 데이터

표준 단어

고객 → CUST (Customer)
주문 → ORD (Order)
금액 → AMT (Amount)

공통표준 ORG 기관표준

4,252 건

표준 도메인

가격N10 → NUMERIC(10,2)
코드C4 → CHAR(4)
일자D8 → DATE

공통표준 ORG 기관표준

177 건

표준 용어

고객명 → CUST_NM
주문금액 → ORD_AMT
등록일시 → REG_DT

공통표준 ORG 기관표준

15,365 건

MCP TOOLS

Claude가 사용하는 26가지 도구

읽기 도구 (항상 활성화)

get_design_rules 사내 DB 설계 규칙 조회

search_standard_word 단어 검색 (한/영 혼합)

search_standard_domain 도메인 검색

search_standard_term 용어 검색

get_word 단어 단건 조회

get_domain 도메인 단건 조회

get_term 용어 단건 조회

suggest_similar_word 중복 방지 유사 단어 제안

batch_search_terms 용어 다건 일괄 검색

suggest_domain 용어명 기반 도메인 추천

find_term 컬럼명 설계용 8단계 용어 탐색

reverse_lookup 영문약어 _ 분해 + 단어 매칭

check_word_policy 동의어·금칙어 정책 검사

get_history 표준 항목 변경 이력

health DB/alembic/카운트 점검

validate_ddl DDL 4단계 자동 검증

audit_search 감사 로그 검색

diff_standard 기간별 변경 요약

쓰기 도구 (MCP_ALLOW_WRITE=true 시 활성화)

WRITE upsert_word 단어 등록/수정 (UPSERT)

WRITE upsert_domain 도메인 등록/수정 (UPSERT)

WRITE upsert_term 용어 등록/수정, 단어 자동 분해·검증

WRITE batch_upsert_term 용어 일괄 UPSERT — 다중 테이블 설계 가속

관리자 도구 (MCP_ALLOW_ADMIN=true 시 활성화)

ADMIN approve_pending 대기 항목 일괄 승인

ADMIN reject_pending 대기 항목 일괄 거부(DELETE)

ADMIN bulk_approve 필터 기준 일괄 승인

ADMIN bulk_reject 필터 기준 일괄 거부

WRITE CAPABILITY

AI가 신규 표준을 직접 등록합니다

MCP_ALLOW_WRITE=true 환경변수 설정 시 활성화

upsert_word

단어 등록·수정 — 영문약어 중복 방지

upsert_domain

도메인 등록·수정 — 타입·길이 규격 관리

upsert_term

용어 등록·수정 — 구성 단어 자동 분해·검증

batch_upsert_term

용어 일괄 UPSERT — 다중 테이블 설계 라운드트립 단축

활용 시나리오

"고객사코드" 표준 용어가 없어. 추가해줘.

suggest_similar_word("고객사코드") → 유사어 없음

upsert_word("고객사코드", abbr_en="CUST_CD", std_type="NCACO")

upsert_term("고객사코드", domain_name="코드C10", abbr_en="CUST_CD")

CUST_CD 단어 + 고객사코드 용어 등록 완료

자동 중복 검사 · 단어 분해 검증 · 공통 / 엔카코 타입 분리 관리

SMART SEARCH

3가지 검색 모드

like

DB에서 %키워드% LIKE 검색만 수행. 점수 평탄(100.0). 빠르고 정확한 포함어 검색.

DB 부하 최소 · 정확한 포함어 검색

fuzzy

rapidfuzz WRatio 유사도 기반으로 전체 레코드 재정렬. 오타와 유사 표현에 관대함.

오타 허용 · 유사어 인식

DEFAULT

mixed

LIKE로 후보군 먼저 추출한 뒤 rapidfuzz로 재정렬. 정확성과 유연성을 동시에.

권장 · 정확성 + 유연성

쿼리 입력 → LIKE 후보 추출 → rapidfuzz 재정렬 → 점수 기반 결과 반환

ARCHITECTURE

하나의 서버, 두 가지 접근

MCP 프로토콜 AI-Native

Streamable HTTP 기반 MCP 서버로 동작. Claude, Cursor 등 AI 도구에서 네트워크로 직접 연결해 26가지 도구를 자연어로 호출.

Claude (Desktop / Code) Cursor / Windsurf IDE MCP 지원 AI 도구 전체

REST API HTTP

FastAPI 기반 REST API. Swagger UI에서 바로 테스트하거나 다른 시스템에서 HTTP로 호출 가능. 단어·도메인·용어 일괄 갱신용 batch 엔드포인트까지 풀 셋.

Swagger UI (/docs) 시스템 간 HTTP 연동 엑셀 데이터 직접 적재 /{words,domains,terms}/batch /admin/api/edit · trend · mcp-stats /metrics · /health 확장

동일한 비즈니스 로직 공유 — MCP와 REST API 모두 같은 서비스 계층을 호출합니다

LIVE DEMO

실제로 이렇게 씁니다

주문 관련 테이블 설계해줘. 주문 금액 컬럼명은 뭐가 맞아?

search_standard_term(query="주문금액", mode="mixed")

get_design_rules() — TB_ 접두어, BIGINT PK 규칙 확인

공통표준용어 조회 결과:

ORD_AMT — 주문금액 (도메인: 가격N10, NUMERIC(10,2))

TB_ORDER 테이블 설계를 추천합니다.

ORD_SN BIGINT AUTO_INCREMENT (PK)
ORD_AMT NUMERIC(10,2) — 공통표준 준수
ORD_DT DATE — 주문일자

GETTING STARTED

Claude 연결 1분 완성

.mcp.json

{
  "mcpServers": {
    "std-mcp": {
      "type": "http",
      "url": "https://std-mcp.ncacoding.com/mcp/"
    }
  }
}

REST API

https://std-mcp.ncacoding.com/docs

연결 순서

1 프로젝트 루트에 .mcp.json 생성

2 위 JSON 내용 붙여넣기

3 Claude 재시작 (Code / Desktop)

4 도구 목록에서 std-mcp 26개 확인

CLAUDE CODE SKILLS

8가지 슬래시 커맨드

/ncaco:std-explore

단어·도메인·용어·설계규칙 탐색

"있나요?" · "찾아줘" · "설계 규칙"

/ncaco:std-ddl-single

단일 테이블 표준 DDL 설계

"테이블 설계해줘" · "DDL 만들어줘"

/ncaco:std-ddl-multi

다중 테이블 · 모듈 단위 DDL + ERD

"테이블들" · "모듈 전체" · "ERD"

/ncaco:std-ddl-review

기존 DDL 표준 준수 검토 · 등급 산정

"검토해줘" · "맞는지 확인" + DDL 코드

/ncaco:std-register

단어·도메인·용어 직접 등록

"등록해줘" · "추가해줘"

/ncaco:std-bulk-import

엑셀/CSV → batch UPSERT 일괄 이관

"엑셀에서 가져와줘" · "일괄 등록"

/ncaco:std-diff

두 시점 사이 표준 변경 리포트

"지난주 변경" · "이번달 신규"

/ncaco:std-upgrade

로컬 스킬을 서버 최신 버전으로 자동 업그레이드

버전 불일치 감지 시 · 팀원 배포 후 동기화

슬래시 커맨드 없이 자연어로 요청해도 키워드 기반으로 자동 판별됩니다. 스킬 파일은 .claude/commands/ncaco/ + .claude/guides/ncaco-std-*/ 에 분리 보관되어 팀 전체가 공유합니다.

SKILL DETAIL · 01 / 07

/ncaco:std-explore 표준 탐색

1

검색 대상 분류

요청에서 단어·도메인·용어·설계규칙 유형 파악

2

MCP 도구 호출

search_standard_word · get_word · suggest_similar_word
search_standard_domain · search_standard_term
get_design_rules

3

결과 정리 · 표 형식 출력

점수 내림차순 / 상위 5건 상세 · 6건 이상 핵심만

4

연관 정보 안내

도메인 연결 · 동의어/금칙어 · 미등록 시 /ncaco:std-register 제안

출력 예시

점수표준단어명영문약어형식단어

98.0구독SUBSN

82.0정기구독PRDC_SUBSN

74.5구독권SUBS_VCHRN

org_se_cd 전략: C001(공공표준)을 우선으로, C002(엔카코)는 보조

트리거 예시 "구독이라는 단어 있나요?" · "설계 규칙 알려줘" · "가격 도메인 목록"

SKILL DETAIL · 02 / 07

/ncaco:std-ddl-single 단건 DDL 설계

1

요구사항 수집 (인터뷰)

DB 엔진 · 설계 심도(하/중/상) · 조직 구분 · 비즈니스 설명

2

DDL 초안 설계 + 컬럼 표준 검증

search_standard_term → 용어 확인 → get_domain → 타입/길이 일치 검사

3

신규 항목 식별 · 사용자 확인

신규 단어·도메인·용어 목록 도출 → 유사 항목 검사 → 승인 요청

4

표준 DB 등록 (순서 엄수)

upsert_word → upsert_domain → upsert_term · APRV_YN=N

5

최종 DDL + 등록 요약 제공

표준 기반 완성 DDL · 신규 등록 항목 요약 · 승인 대기 안내

최종 출력 예시

CREATE TABLE TB_SUBS ( SUBS_SN BIGINT NOT NULL AUTO_INCREMENT, SUBS_NO VARCHAR(20) NOT NULL, SUBS_NM VARCHAR(100), USE_YN CHAR(1) DEFAULT 'Y', REG_DT DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, ... 감사 컬럼 5개 ... PRIMARY KEY (SUBS_SN) ) COMMENT = '구독';

하 업무 컬럼 3~5개   중 6~12개   상 13개+

SKILL DETAIL · 03 / 07

/ncaco:std-ddl-multi 다중 DDL + ERD

1

요구사항 수집

도메인/모듈 범위 · 테이블 간 관계 · 기존 연관 테이블 파악

2

테이블 목록 제안 · 확정

도메인 분석 → 테이블 목록 제안 → 추가/제외 반영

3

테이블별 표준 검증 (반복)

각 테이블 → ddl-single Phase 2~3 수행 · 중복 등록 방지

4~5

신규 항목 일괄 확인 · 등록

전체 단어 → 전체 도메인 → 전체 용어 순 일괄 처리

6

통합 DDL + 텍스트 ERD 제공

전체 스크립트 · FK 관계 · 테이블 관계도 출력

+

FK·감사 컬럼 보강 + Mermaid ERD

FK 명명·ON DELETE 정책·인덱스 규약 · 감사 6컬럼 체크리스트 · 등록 직전 중복 재검사 · 텍스트 + Mermaid erDiagram 동시 출력 (PR/위키 첨부용)

텍스트 ERD 예시

TB_MBR (회원) │ 1 │ N TB_SUBS (구독) ──── TB_SUBS_PLN (구독플랜) │ 1 1 │ N N TB_SUBS_PYMT TB_SUBS_PAUSE (구독결제) (구독일시정지)

중복 방지: 세션 내 등록 추적 — 이미 등록된 단어·용어는 재등록 없이 재사용

SKILL DETAIL · 04 / 07

/ncaco:std-ddl-review DDL 표준 검토

1

DDL 입력 · 파싱

테이블명 · 컬럼 목록 · PK/UK/INDEX/FK 추출

2

설계 규칙 검증 + validate_ddl

MCP validate_ddl 자동 호출 → 4단계 위반 + auto-fix ALTER JSON
TB_ 접두어 · PK 형식 · 감사 6컬럼 · COMMENT 존재 · 접미어

3

컬럼별 표준 매핑 검사

search_standard_term → 점수 판정 → get_domain → 타입/길이 일치 검사

4

검토 보고서 + 권고 DDL 제안

✅ 준수 · ⚠️ 권고 · ❌ 필수 수정 목록 · ALTER SQL · 등급 산정

위반 심각도 4단계

C

Critical — PK _SN 누락, 감사 6컬럼·COMMENT 누락 · auto-fix ALTER

H

High — 표준 미매핑, 임의 약어, 분해 실패 · 후보 제안

M

Medium — 도메인 타입 불일치, NULL/DEFAULT 위배 · auto-fix ALTER

L

Low — COMMENT 부정확, FK 인덱스 누락, 개인정보 태그 누락

심각도별 auto-fix ALTER 템플릿 매핑 — 컬럼 RENAME / 감사컬럼 ADD / 도메인 타입 MODIFY / FK 인덱스 ADD 자동 생성

SKILL DETAIL · 05 / 07

/ncaco:std-register 표준 직접 등록

1

등록 대상 · 정보 수집

단어 / 도메인 / 용어 유형 확인 · 필수/선택 필드 수집 · org_se_cd=C002

2

중복 · 유사 항목 검사

suggest_similar_word · search_standard_domain · search_standard_term → 점수 ≥ 90 시 대체 검토 유도

3

등록 실행 (순서 엄수)

단어 → 도메인 → 용어 순 · upsert_term은 단어 분해 검증 자동 수행

4

등록 결과 확인 · 안내

APRV_YN=N 상태로 저장 · 관리자 승인 후 정식 표준 확정

도메인명 명명 규칙

도메인명분류타입길이

가격N10가격NUMERIC10

명V100명칭VARCHAR100

여부C1여부CHAR1

일자D8일자DATE8

단어
upsert_word

→

도메인
upsert_domain

→

용어
upsert_term

용어 등록 전 단어가 없으면 TermValidationError 발생 — 순서 필수

SKILL DETAIL · 06 / 07

/ncaco:std-bulk-import 엑셀/CSV 일괄 이관

1

파일 형식 파악 · 열 매핑

시트 구조 · 헤더 위치 · 한글명/약어/설명 컬럼 매핑 · 인코딩 확정

2

단어 batch UPSERT

50건씩 분할 · suggest_similar_word 사전 점검 · 영문약어 충돌 확인

3

도메인 batch

POST /domains/batch · 도메인은 단어 의존성 없음

4

용어 batch (분해 검증 자동)

batch_upsert_term · 항목별 트랜잭션 분리 · 실패 사유 results[].error 에 포함

5

실패 정리 + 보고

미등록 단어 추가 후 재시도 · 형식단어 종결 보정 · APRV_YN=N 승인 대기

이관 순서 (필수)

단어
50건/batch

→

도메인
batch

→

용어
50건/batch

이관 완료 ─ bulk-import ───────────────────────────── [단어] 120건 → 117건 등록, 3건 충돌 [도메인] 8건 → 8건 등록 [용어] 450건 → 442건 등록, 8건 실패 승인 대기 일괄 처리: bulk_approve(target_type="term", q="필터", max_count=50)

한 batch 50건 권장 — 한도 100건. 부분 실패 식별이 쉬워야 재시도가 빠릅니다.

SKILL DETAIL · 07 / 07

/ncaco:std-diff 표준 변경 리포트

1

기간 정규화

"최근 1주" / "지난주" / "이번달" → 절대 YYYY-MM-DD 변환

2

diff_standard 호출

감사 로그(jsonl + .gz) 자동 스캔 · 단어/도메인/용어별 등록·승인·삭제 집계

3

리포트 작성

메서드별 카운트 · 주요 항목 샘플 · 행위자 TOP 3

4

활용

주간 회의 자료 · 릴리스 노트 · 감사 시점 변경 점검

리포트 예시

표준 변경 리포트 (2026-05-11 ~ 2026-05-18) ───────────────────────────── [단어] POST : 47건 (신규) PUT : 12건 (수정) DELETE : 3건 (거부) 주요: 고객사코드, 결제수단, ... [도메인] POST : 5건 [용어] POST : 132건 PUT : 18건 DELETE : 7건 행위자 TOP 3 yyt : 84건 kim : 47건 park : 32건

AUDIT_LOG_DIR 필요 · 회전된 .gz 백업도 자동 디코드. 보존 기간(기본 90일) 내 모든 변경 추적.

ADMIN CONSOLE

운영 사이클을 웹에서 닫습니다

승인 대기 큐 · 검색

한글명/약어 검색 · 공백 토큰 AND · 무한 스크롤

일괄 승인/거부 · cursor 페이지네이션

감사 로그 검색 · XLSX

actor · 기간 · 메서드 다중 체크 · 대상명 필터

CSV/XLSX 다운로드 · gzip 회전 백업

Discord 알림

신규 등록 시 webhook 배치 발송

5분 묶음 · MCP·REST 모두 커버

Bearer 토큰 인증

ADMIN_TOKEN 단일 토큰 운영

DB 스키마 변경 0건 · 즉시 적용

관리자 직접 편집

aprv_yn 강등 없이 한글명·약어·설명 인라인 수정

PUT /admin/api/edit · 화이트리스트 필드만

등록 트렌드 + MCP 통계

최근 14일 일별 등록 스파크라인 · 도구별 호출 TOP 5

/admin/api/trend · /admin/api/mcp-stats

Claude가 등록 → 알림 → 관리자 1클릭 승인 — DB 수작업 0

DESIGNER DX

설계자 일상 업무 단축

영문약어 분해

CUST_NM → CUST + NM 매칭 검증

reverse_lookup · 마지막 형식단어 검사

xlsx 내보내기

단어·도메인·용어·전체 4모드

조직·승인 필터 · openpyxl streaming

동의어·금칙어 정책

YAML 기반 — 등록 시 자동 차단/경고

check_word_policy · config/*.yaml

변경 이력 조회

표준 항목별 audit log 파생 history

get_history · /admin/api/history

설계자가 매번 엑셀 뒤지고 단어 외우는 일 — Claude 에서 한 번에

DIAGNOSTIC TOOLS

DDL·표준을 스스로 검증하는 4가지 도구

validate_ddl — DDL 자동 검증

CREATE TABLE 텍스트 → 위반 4단계(C/H/M/L) JSON · auto-fix ALTER 동봉

/ncaco:std-ddl-review 스킬이 우선 호출 · CI 연동도 가능

audit_search — 감사 로그 AI 질의

"yesterday 누가 뭘 바꿨지?" → MCP가 직접 jsonl 검색해 답변

actor · 기간 · method · 대상명 필터

diff_standard — 기간별 변경 요약

두 시점 사이 단어·도메인·용어 등록/승인/삭제 집계 + 샘플

/ncaco:std-diff 스킬 + 회전 .gz 자동 디코드

health — 한 번에 상태 점검

DB 연결 · alembic 리비전 · 정책 파일 · 표준 카운트 합본

REST /health + MCP health (인증 불필요)

AI가 직접 DDL 검토하고 변경을 추적 — 사람의 수기 점검 시간 축소

OBSERVABILITY

장애가 발생하면 먼저 안다

/metrics — Prometheus 노출

요청 수 · 지연 히스토그램 · 승인 대기 큐 게이지 · 외부 의존 0

표준 text exposition · 그라파나 즉시 연동

alembic 리비전 검증

DB ≠ head 면 시작 거부 · 마이그레이션 누락 사고 0

SKIP_MIGRATION_CHECK=1 로 일회성 우회

rate-limit 위반 Discord 알림

slowapi 임계 초과 시 webhook · 1분 디바운스 · 카운트 누적

남용 탐지 · 자동화 폭주 조기 발견

audit.jsonl 자동 gzip 회전

자정 회전 후 백업 .gz 압축 · 디스크 절감 · 검색 시 자동 디코드

90일 보존 기본 · 환경변수로 조정 가능

MCP 도구 호출 통계

도구별·일자별 호출수 + 평균 지연 · 어떤 도구가 진짜 쓰이는지

Admin UI 카드 + /admin/api/mcp-stats

등록 트렌드 미니 카드

최근 14일 일별 단어·도메인·용어 등록 스파크라인

활동 가시화 · 주간 회의 즉시 활용

Prometheus · Discord · 자동 정리 — 추가 의존성 없이 운영 신호 강화

SECURITY & QUALITY

운영 등급 보안 · 품질 보강

Rate Limiting

읽기 200 · 쓰기 10 · 관리 30~120 req/min

slowapi · actor + XFF IP 복합 키

보안 헤더 일괄 주입

CSP · X-Frame-Options · X-Content-Type-Options

Referrer-Policy · Permissions-Policy

감사 로그 + gzip 회전

POST · PUT · DELETE 자동 기록 · X-Actor-Id 필수 강제

90일 보존 · .gz 압축 · MCP audit_search 직접 질의

pytest 회귀 차단

services · API · MCP · 보안 fix 회귀 27건

CORS 가드 · enforce_pending · TermCreate.force 차단

내부망이지만 운영 등급 방어선 확보 — 보안 + 관측 + 자동 차단까지

AI가 사내 표준을
이해하는 시대

4,252 표준 단어

177 표준 도메인

15,365 표준 용어

지금 바로 Claude에 연결하세요

문의: yyt@ncacoding.com