Data Connect / 데이터 연결하기

검증된 노동법 데이터를, 당신의 서비스 안에서

IKLPA 데이터 연구소가 정리하고 검증한 노동법 정보와 판례 요약, 지원 창구 데이터를 API와 MCP로 연결해 쓸 수 있습니다. 여러분의 서비스가 노동법 질문을 만났을 때, 출처 있는 데이터가 그 답을 받쳐 주도록 만드는 연결입니다.

파일럿 문의하기 MCP가 무엇인가요

Model Context Protocol

MCP가 무엇인가요

MCP(Model Context Protocol)는 AI 모델이 외부 데이터와 도구에 표준화된 방식으로 연결되도록 하는 개방형 프로토콜입니다. 2024년 공개된 뒤 주요 AI 서비스들이 차례로 받아들이면서 업계 표준으로 자리 잡아 가는 중입니다. 가장 흔한 비유는 "AI용 USB-C 포트"입니다. 기기마다 다르던 충전 단자가 USB-C 하나로 정리된 것처럼, 서비스마다 제각각이던 AI와 데이터의 연결 방식이 MCP라는 공통 규격으로 모이고 있습니다.

이 규격을 따르면 어떤 AI 비서든 IKLPA MCP 서버에 접속해, IKLPA가 검증한 노동법 데이터를 표준 방식으로 조회해 답변에 쓸 수 있습니다. 사용자가 AI에게 해고 예고 수당을 물으면, AI가 그럴듯한 문장을 지어내는 대신 IKLPA의 조문 데이터와 지원 창구 정보를 찾아와 출처가 남는 답을 만드는 식입니다.

API는요?

API는 프로그램끼리 데이터를 주고받는 표준 창구입니다. 고객사의 소프트웨어가 IKLPA 데이터베이스를 실시간으로 조회하는 유료 접속 통로라고 이해하시면 됩니다. AI 비서를 연결하려면 MCP가, 자체 서비스나 사내 시스템에 데이터를 직접 심으려면 API가 맞습니다.

연결 데이터

무엇을 연결할 수 있나요

노동법 데이터베이스

근로기준법을 비롯한 주요 노동 법령의 조문과 상황별 가이드를 구조화한 데이터입니다. 법 개정에 맞춰 계속 갱신합니다.

판례 요약

실제 사건번호가 확인된 판례의 쟁점과 결론을 해설과 함께 정리했습니다. 게재 전에 원문과 대조해 검증합니다.

지원 창구 디렉터리

정부 기관, 양대 노총, 이주민 포털의 상담 창구 정보입니다. 등재 전에 실제 접속을 확인하고 주기적으로 점검합니다.

개인의 사건 기록과 상담 데이터는 어떤 형태로도 제공하지 않습니다.

데이터 사전

데이터셋별 스키마

연결할 수 있는 각 데이터셋의 필드 구조를 정리했습니다. 아래 필드 이름과 타입, 예시는 지금 설계하고 있는 형태를 기준으로 적었습니다. 이미 운영 중인 확정 스키마가 아니라 파일럿을 위해 다듬는 중인 예시 스펙이며, 초기 파트너 의견에 따라 세부는 바뀔 수 있습니다.

노동법 조문 데이터베이스

object: provision

조문 단위로 정규화한 레코드입니다. 하나의 조문이 여러 항·호로 나뉘는 경우 상위 조문과 하위 항목을 분리해 저장합니다.

필드 (field)	타입 (type)	설명 (description)	예시 (example)
`id`	`string`	조문 레코드의 고유 식별자	`prov_lsa_28`
`statute`	`string`	법령 이름	`근로기준법`
`article`	`integer`	조 번호	`28`
`clause`	`integer \| null`	항 번호. 조 전체 레코드면 null	`1`
`title`	`string`	조문 제목	`부당해고등의 구제신청`
`body`	`string`	조문 본문 텍스트	`사용자가 근로자에게 부당해고등을 하면 ...`
`plain_summary`	`string`	일반 이용자용 쉬운 풀이	`부당하게 해고당하면 노동위원회에 구제를 신청할 수 있습니다.`
`source_url`	`string (url)`	국가법령정보센터 등 원문 링크	`https://www.law.go.kr/...`
`effective_on`	`string (date)`	해당 조문 시행일	`2021-11-19`
`updated_at`	`string (datetime)`	IKLPA가 이 레코드를 마지막으로 검증·갱신한 시각	`2026-06-30T09:00:00+09:00`

판례 요약

object: case_summary

사건번호가 확인된 판례만 등재합니다. 요약은 원문 대조를 거쳐 게재하며, 원문 자체를 재배포하지는 않습니다.

필드 (field)	타입 (type)	설명 (description)	예시 (example)
`id`	`string`	판례 요약 레코드의 고유 식별자	`case_2019du...`
`court`	`string`	선고 법원	`대법원`
`case_no`	`string`	사건번호	`2019두12345`
`decided_on`	`string (date)`	선고일	`2021-03-25`
`issues`	`string[]`	핵심 쟁점 태그 배열	`["부당해고", "해고예고수당"]`
`summary`	`string`	쟁점과 결론을 정리한 요약	`해고 예고를 하지 않은 경우 ...`
`related_provisions`	`string[]`	연결되는 조문 id 배열	`["prov_lsa_26", "prov_lsa_28"]`
`source_url`	`string (url)`	판례 원문 열람 링크	`https://www.law.go.kr/...`
`updated_at`	`string (datetime)`	마지막 검증·갱신 시각	`2026-06-30T09:00:00+09:00`

지원 창구 디렉터리

object: support_channel

등재 전에 실제 접속을 확인하고 주기적으로 점검합니다. 링크가 끊기거나 창구가 사라지면 상태 값으로 표시합니다.

필드 (field)	타입 (type)	설명 (description)	예시 (example)
`id`	`string`	창구 레코드의 고유 식별자	`chan_molab_1350`
`name`	`string`	창구 이름	`고용노동부 고객상담센터`
`category`	`string`	분류(정부·노총·이주민 포털 등)	`government`
`phone`	`string \| null`	대표 상담 전화	`1350`
`url`	`string (url)`	공식 페이지 링크	`https://www.moel.go.kr/...`
`languages`	`string[]`	상담 지원 언어	`["ko", "en", "vi"]`
`status`	`string`	점검 상태(active·moved·closed)	`active`
`last_checked_at`	`string (datetime)`	마지막으로 접속을 확인한 시각	`2026-06-28T14:00:00+09:00`

요청·응답 예시

한 번의 호출은 이렇게

조회 한 번이 어떻게 오가는지 보여드립니다. 특정 법령의 특정 조문을 요청하면, 출처가 붙은 구조화된 레코드가 돌아옵니다. 엔드포인트와 필드 형태는 아직 설계 중인 스펙이라, 아래 경로와 키 이름은 확정된 계약이 아니라 이해를 돕는 예시로 봐 주세요.

요청

GET /v1/provisions?statute=근로기준법&article=28
Host: api.iklpa.org
Authorization: Bearer <YOUR_API_KEY>
Accept: application/json

응답

{
  "object": "list",
  "api_version": "v1",
  "count": 1,
  "data": [
    {
      "id": "prov_lsa_28",
      "statute": "근로기준법",
      "article": 28,
      "clause": 1,
      "title": "부당해고등의 구제신청",
      "plain_summary": "부당하게 해고당하면 노동위원회에 구제를 신청할 수 있습니다.",
      "source_url": "https://www.law.go.kr/...",
      "effective_on": "2021-11-19",
      "updated_at": "2026-06-30T09:00:00+09:00"
    }
  ]
}

주: 인증은 베어러 API 키로 이루어지며, 모든 레코드에 source_url과 updated_at이 담겨 있어 그 데이터로 만든 답이 언제 확인된 무엇에서 왔는지 항상 되짚을 수 있습니다.

MCP 연결 설정

AI 클라이언트에 IKLPA 붙이기

AI 비서를 MCP로 연결하려면, 사용하는 클라이언트의 서버 설정에 항목 하나를 추가합니다. 아래 예시는 URL과 API 키로 "iklpa" 서버를 등록하는 형태입니다. 이 항목을 넣고 클라이언트를 다시 시작하면, 비서가 대화 도중 위의 검증된 데이터셋을 스스로 조회해 답에 쓸 수 있습니다.

mcpServers 설정

{
  "mcpServers": {
    "iklpa": {
      "url": "https://mcp.iklpa.org/v1",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

주: 위 URL과 키는 자리표시자입니다. 파일럿 파트너에게는 연결을 열어 드릴 때 실제 서버 주소와 키를 전달합니다.

버저닝·갱신 정책

데이터를 최신으로 지키는 방식

API는 경로에 버전을 담으며 v1에서 시작합니다. v1은 안정적인 표면으로 다룹니다. 그 안에서 필드와 데이터셋을 더하기는 해도, 이미 있던 필드를 조용히 이름 바꾸거나 없애지 않습니다. 기존 사용자를 깨뜨릴 변경은 v1을 밑에서 바꾸는 대신 새 버전으로 옮깁니다.

내용 갱신은 현실을 따라갑니다. 법이 개정되거나 새 공식 통계가 발표되면 영향을 받는 레코드를 갱신하고, 각 레코드에 updated_at을 찍어 마지막으로 확인한 시점을 그대로 보여드립니다. 판례 요약은 어떤 변경이든 반영하기 전에 원문과 다시 대조합니다.

언젠가 어떤 필드나 엔드포인트를 거둬들여야 할 때는, 폐기 예고를 통해 미리 알리고 정해진 기간 동안 기존 형태를 그대로 유지한 뒤 제거합니다. 파일럿 기간에는 그 기간을 아직 정하는 중이며, 파트너와 서면으로 확정하겠습니다.

제공 범위와 한계

무엇을 제공하고, 무엇은 제공하지 않는가

제공하는 것

쉬운 풀이와 원문 링크가 붙은 구조화된 노동법 조문.
사건번호가 확인되고 원문과 대조한 판례 요약.
주기적으로 접속을 확인하는 지원 창구 디렉터리.
언제 마지막으로 검증했는지 시각이 찍힌 각 레코드.

제공하지 않는 것

개인의 사건 기록과 상담 데이터. 어떤 형태로도 제공하지 않으며, 이 선은 바뀌지 않습니다.
IKLPA에 연락한 노동자를 식별할 수 있는 어떤 개인정보.
판례 원문 전체의 재배포. 원문은 링크로 대신합니다.
특정 분쟁에 대한 법률 자문이나 결과 보장.

수록 범위에 관하여: 위 조문과 판례, 창구의 개수는 파일럿을 거치며 늘어납니다. 실제로 검증한 작은 묶음을 보여드릴지언정 숫자를 부풀리지는 않으려 하며, 지금 보이는 수치는 여기까지 우리 점검을 통과한 만큼입니다.

이 페이지의 검증 기준

주: 지금 약속드리는 것은 검증 원칙과 개인정보 미제공 선입니다. 모든 레코드는 게재 전 원문과 대조하고 검증 시각을 남기며, 개인의 사건·상담 데이터는 결코 포함하지 않습니다. 아직 설계 중인 것은 위에 보인 정확한 엔드포인트 경로와 필드 이름, 요금, 버전 지원 기간입니다. 이들은 파일럿 단계의 예시 스펙이며, 초기 파트너와 함께 확정합니다.

활용처

누가 쓰면 좋나요

HR 서비스·리걸테크

제품 안에서 노동법 질문에 답해야 한다면, 그 답변의 근거를 IKLPA 데이터로 받칠 수 있습니다.

사내 챗봇

직원들의 노동 관련 문의에 회사 챗봇이 정확한 조문과 지원 창구를 안내하도록 만들 수 있습니다.

연구자·언론

여기저기 흩어져 있던 노동법과 판례 정보를 정리된 구조로 받아 분석과 취재에 쓸 수 있습니다.

이용 안내

이렇게 이용할 수 있습니다

개인·비영리

개인 개발자와 비영리 프로젝트에는 무료로 제공하는 것을 원칙으로 합니다. 신청 절차와 호출 한도 같은 세부 기준은 파일럿 기간에 확정합니다.

상업 서비스

호출량 기반의 월 라이선스로 제공합니다. 구체적인 금액은 아직 확정 전이라, 문의 주시면 준비 중인 기준을 안내해 드립니다.

지금은 어느 단계인가요

현재 파일럿 파트너를 모집하고 있습니다. 정식 공개 전 단계로, 초기 파트너와 함께 데이터 범위와 연결 방식, 요금 구조를 다듬어 가고 있습니다.

아직 내세울 고객 사례는 없습니다. 대신 파일럿에 참여하시면 처음부터 스펙을 함께 정할 수 있습니다.

파일럿 문의하기

파일럿으로 함께 시작해 보세요

연결하려는 서비스와 쓰임새를 알려 주세요. 지금 준비된 범위와 일정을 있는 그대로 말씀드리고, 필요한 연결부터 함께 열어 가겠습니다.

문의하기 데이터 연구소 보기