gongsi-mcp

공시담당자를 위한 DART 전자공시 + 공정위 기업집단포털 MCP 서버. 공정거래위원회 기업집단 공시(대규모내부거래·기업집단현황·비상장사 중요사항)의 대상 판정 · 기한 계산 · 예상 과태료 · 제출 전 자가점검 · 타사 선례를 — 모든 답에 근거(조문·계산식·원천 데이터)를 동봉해서.

기존 DART MCP들은 전부 투자·재무 분석 관점입니다. 이 서버는 반대편 — 공시를 제출하는 사람 — 을 위해 만들었습니다.

"이거 공시사항이야?"라는 전화를 받은 순간부터 점검을 통과할 때까지, 물어볼 사람이 없어도 혼자서 확신을 가질 수 있도록.

⚡ 30초 설치

Node.js 22.13+ 만 있으면 됩니다.

npx -y gongsi-mcp setup

대화형 마법사가 ① 인증키를 실제 API 호출로 검증하고 ② ~/.gongsi-mcp/.env 에 저장한 뒤 ③ 룰 엔진 자가검증(실제 공시 사례 재현)까지 돌립니다. 이어서:

claude mcp add gongsi-mcp -- npx -y gongsi-mcp

다른 클라이언트(Claude Desktop·Cursor 등)는 아래 설치 상세 참고.

💡 이렇게 물으면, 이렇게 답합니다 — 전부 실측 사례

도구 이름을 알 필요 없습니다. 그냥 말하면 Claude 가 알아서 맞는 도구를 부릅니다.

💬 "비상장 계열사에 80억 자금대여 의결했어 (자본총계 1,200억). 공시 대상이야? 기한은?"

공시 대상입니다. 기준금액 = min(100억, max(5억, 자본총계 1,200억 × 5%)) = 60억 ≤ 거래 80억. 이사회 의결일(7/22) 다음 날부터 7영업일 — 기한 7/31. 근거: 대규모내부거래 고시 §6①. (실제 공시 사례와 대조 검증된 계산입니다. 참고로 웹에 퍼진 "1일 이내"는 오정보 — 고시 원문은 상장 3영업일 / 비상장 7영업일)

💬 "30억 내부거래 공시를 5일 늦게 냈어. 과태료 얼마 나와?"

예상 165만원. 산식 전문을 함께 드립니다: (기본금액 500만원 + 일수가산 50만원) × 거래금액 적용비율 60%(20억~40억 구간) = 기준금액 330만원 − 지연 7일 이하 감경 50% = 165만원 거래금액을 안 알려주시면 "이 값은 상한선(최대 275만원)"이라고 명시합니다 — 조용히 과대·과소 산정하지 않습니다.

💬 "기한 놓친 지 3일째인데 아직 공시 전이야. 지금 내면 뭐가 달라져?"

자진시정 골든타임(기한 다음 날부터 10영업일)이 아직 열려 있습니다 — 종료일·남은 영업일·면제 요건(신규 지정 30일 내, 사소한 부주의 등)을 알려드립니다. 골든타임이 지나도 지연 3일 이하는 75% 감경 구간이라, 하루라도 빨리 내는 게 유리하다는 계산까지.

💬 "우리 회사 6~7월 대규모내부거래 공시, 지연된 거 있는지 감사해줘"

해당 기간 공시 5건 전수 대조 완료 — 원본 접수일 vs 원문 이사회 의결일 기준 전부 기한 내입니다. 집단 단위 감사도 됩니다(실측: 삼성 67개 계열사 조인). 대규모내부거래 위반의 94~95%가 "기한" 유형(공정위 실측) — 이 도구가 잡는 게 바로 그것입니다.

💬 "기업집단현황공시에 적힌 거래내역이랑 대규모내부거래 공시를 대조해서, 공시 안 하고 넘어간 거래가 있는지 봐줘"

접수분만 보는 기한 감사가 원리상 못 하는 일 — 공시 자체가 없는 거래를 보는 — 의 유일한 경로입니다. 실제 제출된 연1회 공시 1건으로 돌린 결과: 자금 차입 3건은 전부 차입일 직전에 해당 유형 공시가 접수돼 있었습니다(건별 근접 대조 −5일·−4일·−2일) — 미공시 후보 0건. 상품·용역에서 연간 2,054.5억원 거래 1건이 남았지만 "미공시"라고 하지 않고 조건부 후보로 냅니다 — 이 유형의 공시의무는 상대방이 "자연인인 동일인이 단독으로 또는 친족과 합하여 20% 이상 출자한 계열회사"일 때만 성립하는데(법 §26①4호·령 §33②) 지분 데이터가 없어 요건을 확인할 수 없기 때문입니다. 유가증권 36쌍도 공시 존재 4 / 기준 미달 24 / 판정 불가 8 로 갈라서 돌려줍니다 — 확인 못 한 8건을 "문제 없음"에 섞지 않습니다.

💬 "기업집단현황공시 제출본, 숫자 틀린 데 없는지 점검해줘"

재무현황 표에서 불일치 3건을 찾았습니다 — 예: ○○사 자산총계가 유동+비유동 합계와 7.28억 차이. 각 건의 행·기대값·실제값을 제시하니 제출 전에 원본과 대조하세요. (실제 제출된 공시에서 검출된 실측 사례, 오탐 0. 공시의무 위반 건수의 84%가 이 공시(J004)에서 나옵니다)

💬 "사모사채 발행 공시, 다른 회사는 어떻게 썼는지 5년치 선례 찾아줘"

3개사 선례를 원문과 함께 가져왔습니다. 어디까지 훑었는지(coverage)도 함께 — 훑지 않은 구간을 "없다"고 말하지 않습니다.

💬 "계열사 발행어음이 만기 자동연장됐는데, 이것도 공시해야 해?"

규칙만으로 판정하기 어려운 경계사례라, 공정위 공시 업무 매뉴얼(2026. 4.)의 해당 공식 문답을 원문 그대로 출처·연도와 함께 인용해 드립니다.

💬 "올해 우리가 언제 뭘 공시해야 하는지 달력으로 뽑아줘"

2026년에 기한이 도래하는 정기공시 19건을 D-day 와 함께 시간순으로. 기업집단현황공시 연1회는 법정 기한 5/31이 일요일이라 실제 기한은 6/1이고, 그날 1분기 공시·비상장 주요주주 지분변동까지 3건이 겹칩니다(연1회와 1분기는 같은 날이라 단일 서식 1건으로 함께 제출 — 두 번 내는 게 아닙니다). 분기 공시 항목의 기준일이 "공시기한일의 직전 분기"라는, 담당자가 가장 자주 틀리는 지점도 항목마다 붙습니다. 그리고 달력이 비었다고 공시할 게 없다는 뜻이 아니라고 먼저 말합니다 — 대규모내부거래 개별거래·비상장 중요사항 등 사유 발생형 4종은 애초에 달력에 올릴 수 없어 따로 알려드립니다.

💬 "2027년 5월 1일이 기한 말일이면 실제로 언제까지 내면 돼?"

5/4(화) 까지입니다. 5/1 노동절(2026-04-30 규정 개정으로 신설) · 5/2 일요일 · 5/3 대체공휴일을 건너뛴 결과 — 건너뛴 날짜와 사유·근거 조문을 동봉합니다. (모델의 달력 지식이 아니라 공식 공고와 대조 검증된 데이터로 계산)

이런 사람에게 딱

• 기업집단 소속 회사의 공시담당자·공정거래팀 — 대상 판정, 기한 관리, 제출 전 점검이 일상인 사람

• "GPT한테 물어봤더니 이상한 말만 해서" 근거 조문이 있는 답이 필요한 사람

• 물어볼 선배가 없는 신규 담당자 (공정위가 공식 지목한 위반 1순위 원인이 "신규 담당자 업무 미숙")

이런 사람한텐 다른 도구가 낫다

• 투자·재무 분석이 목적 — 재무비교·내부자거래·XBRL은 투자 관점 DART MCP들이 훨씬 잘합니다 (관점이 정반대라 같이 설치해도 됩니다)

• 거래소(KRX) 공시 판정 — 이 서버는 공정위 공시 전용. 유가증권시장 공시 규정 판정은 다루지 않습니다

• 서식 자동 작성·자동 제출을 원하는 사람 — 의도적으로 만들지 않았습니다. 판정·근거·초안까지만, 제출은 담당자의 몫

솔직한 진입 장벽

• OpenDART 인증키 발급이 필요합니다 (무료, 즉시 — 판정·기한·과태료 등 핵심 기능은 키 없이도 동작)

• 판정 결과는 법령·고시 원문 기반 참고 정보입니다 — 공정위 유권해석이 아니며, 최종 확인은 소관 부서에

기존 DART MCP와의 차별점

공개 DART MCP 5종 조사 결과(2026-07 기준) 전부 투자·재무 관점이었고, 공정위 기업집단 공시 판정을 다루는 것도, 공정위 기업집단포털 API를 쓰는 것도 없었습니다.

포지셔닝 한 줄

투자 관점 DART MCP가 "이 회사 사도 되나"에 답한다면, gongsi-mcp 는 "이거 공시해야 하나, 언제까지, 안 하면 얼마"에 답합니다.

정직한 약점

• DART 일반 조회 커버리지는 좁습니다 — 재무·검색·원문 등 6개 범용 도구만 있고, XBRL·지분공시·임원보수 같은 투자 분석 엔드포인트는 없습니다. 그쪽이 필요하면 투자 관점 MCP를 같이 쓰세요.

• 기업집단포털은 연 1회(매년 5/1 기준) 갱신입니다 — 연중 신규 편입은 포털에 늦게 반영되며, 응답에 기준 시점을 명시합니다.

• 대규모 기간·집단 전체 감사는 MCP 클라이언트의 60초 제한 때문에 분할 안내를 돌려줍니다 (원문 캐시가 쌓이면 재감사는 빨라집니다).

• 판정은 참고 정보입니다. 법률 자문·유권해석이 아닙니다.

도구 (16개)

판정·리스크 (공정위 공시 특화 — 이 서버에만 있는 것)

검색·원문·선례 (범용)

설치 상세

0단계: 인증키 발급 — DART 키 하나면 됩니다

DART_API_KEY 하나만 OpenDART에서 무료 발급받으세요 (즉시, 일 20,000건).

참고로 핵심 판정 기능(공시의무 판정·기한·과태료·영업일 계산·정정 리스크·공정위 Q&A)은 룰 엔진 + 내장 데이터로 동작해서 키가 없어도 사용 가능합니다. 키가 더 필요한 고급 기능(계열사 전수 조회 등)을 부르면 도구가 발급 절차를 그 자리에서 안내합니다.

방법 1: setup 마법사 + Claude Code (권장)

npx -y gongsi-mcp setup
claude mcp add gongsi-mcp -- npx -y gongsi-mcp

마법사가 키를 실호출로 검증하고 ~/.gongsi-mcp/.env 에 저장 — 서버가 자동으로 읽는 위치라 등록 시 env 를 다시 줄 필요가 없습니다. 비대화 모드: npx gongsi-mcp setup --dart-key <키> [--egroup-key <키>] --no-input

방법 2: Claude Desktop / Cursor 등 (설정 파일)

설정 파일에 추가 (YOUR_API_KEY 교체):

{
  "mcpServers": {
    "gongsi-mcp": {
      "command": "npx",
      "args": ["-y", "gongsi-mcp"],
      "env": {
        "DART_API_KEY": "OpenDART에서 발급받은 키"
      }
    }
  }
}

Windows에서 실행 실패 시: 클라이언트가 npx 를 못 찾는 경우 "command": "cmd", "args": ["/c", "npx", "-y", "gongsi-mcp"] 로 래핑하세요.

MS 스토어판 Claude Desktop: 설정 파일이 가상화 경로에 있습니다 — %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json. %APPDATA%\Claude 를 고쳐도 앱이 읽지 않습니다.

방법 3: 소스 클론 (개발)

git clone https://github.com/dolseom/gongsi-mcp.git && cd gongsi-mcp
npm install && npm run build
node dist/src/cli.js setup
claude mcp add gongsi-mcp -- node <절대경로>/dist/src/cli.js

요구사항: Node.js 22.13+ (런타임 의존성 2개 — MCP SDK, zod. SQLite는 Node 내장 node:sqlite 사용 — v22.13.0부터 --experimental-sqlite 플래그 없이 동작)

설계 원칙 — 이 도구가 가장 피하는 실패는 "거짓 안심"

감사·판정 도구의 최악의 출력은 틀린 경고가 아니라 확인하지 못했는데 "문제 없음"이라고 말하는 것입니다. 담당자가 그 말을 믿고 공시를 안 하면 과태료가 나옵니다. 그래서:

• 모든 판정에 근거 동봉 — 조문·계산식·원천 데이터 없이 결론만 주지 않는다

• 절단을 조용히 넘기지 않는다 — 모든 검색 응답에 diagnostics(truncated·partial_results·분할 내역), 선례 검색에 coverage(훑은 구간·전수 여부) 동봉

• 확인 못 한 것은 "없음"이 아니라 "미확인"으로 — 대사 실패는 "정합"이 아니고, 예산 초과로 못 훑은 구간은 "그런 공시 없음"이 아니다

• 정정 이전 원본을 보존한다 — 검색 기본값이 원본 접수분. 최종본만 보면 지연 판정이 불가능하다

• 법령 세부는 원문으로만 — 웹에 퍼진 "공시기한 1일"·"50억 기준" 같은 오정보를 원문 대조로 걸러냄

• 자동 제출 기능은 만들지 않는다 — 초안·판정·근거까지만. 최종 제출은 담당자의 몫

검증: 테스트 299개 · 공휴일 데이터 공식 공고 대조(2026·2027) · 실제 공시 사례 재현 · 3자 교차검토(치명 경로 전수 수정).

면책

본 도구의 판정·과태료 추정은 법령·고시 원문에 근거한 참고 정보이며 법률 자문·공정위 유권해석이 아닙니다. 공휴일 데이터(기한 계산의 기초)는 2026·2027년분이 공식 공고와 대조 검증되어 있으며, 미검증 연도는 응답에 경고가 동봉됩니다.

참고

• OpenDART — 금융감독원 전자공시 API

• 공정위 기업집단포털 — 지정 집단·소속회사·재무 (공공데이터포털 API)

라이선스

MIT