문서

Brreg를 연결하고 업무에 활용하기

연결 방법, 어시스턴트에 제공되는 도구, 데이터 출처, 사용 한도 및 개인정보 처리 방식까지 필요한 모든 내용을 안내합니다.

연결하기

Brreg는 원격 MCP 서버입니다. 어시스턴트가 단일 주소로 연결되면 사용자가 Publifye 계정으로 로그인합니다. 접근 권한은 이 로그인을 통해서만 부여되며, 생성·복사·교체할 API 키가 없습니다.

https://brreg.publifye.com/mcp

이용하려면 Publifye 계정에 Brreg 요금제가 등록되어 있어야 합니다. 요금제 보기

웹 버전 Claude 및 Claude Desktop

  1. 설정(Settings)을 연 다음 커넥터(Connectors)로 이동하십시오.
  2. 맞춤형 커넥터 추가(Add custom connector)를 선택하고 이름을 Brreg로 지정한 뒤 위의 주소를 붙여넣으십시오.
  3. 연결(Connect)을 선택하고 Publifye 계정으로 로그인한 다음 접근을 승인하십시오.
  4. 대화창의 도구 메뉴(tools menu)에서 Brreg가 활성화되어 있는지 확인하고 질문을 입력하십시오.

Claude Code

서버를 한 번 추가한 뒤, Claude Code 내에서 /mcp 명령을 실행하여 로그인하십시오:

claude mcp add --transport http brreg https://brreg.publifye.com/mcp

기타 MCP 클라이언트

전송 방식
위 주소에서 Streamable HTTP(POST 기반 JSON-RPC)를 사용합니다.
로그인
Publifye 로그인을 통한 PKCE 기반 OAuth 2.1입니다. 클라이언트가 자동으로 자체 등록(동적 클라이언트 등록)되므로 사전 설정이 필요하지 않습니다.
디스커버리
https://brreg.publifye.com/.well-known/oauth-protected-resource

도구

연결 시 어시스턴트가 받는 도구들이며, 운영 중인 서버에서 직접 가져옵니다. 모든 도구는 데이터를 읽기만 합니다.

entity_lookup

조직번호로 하나 이상의 조직을 조회하여 등기부 항목을 반환합니다. 주요 재무 수치, 제출된 연차 결산서의 연도, 그리고 제출된 문서 자체는 요청할 때만 제공합니다.

  • compact
  • cursor
  • document_year
  • fields
  • include_subunits
  • live
  • max_bytes
  • orgnr
  • orgnrs
  • snapshot_id

entity_nearby

Finds the organisations registered nearest a map point, closest first, with the distance to each. The point is the address in the register, not where the business actually operates.

  • radius_km
  • city
  • compact
  • cursor
  • employees_max
  • employees_min
  • fields
  • kind
  • lat
  • limit
  • lon
  • max_bytes
  • municipality
  • nace
  • org_form
  • orgnr
  • parent_orgnr
  • postcode
  • public_body
  • sector
  • snapshot_id
  • status
  • vat_registered

entity_distance

Measures how far apart organisations are, and which of several is nearest a given place. This is the straight-line distance between registered addresses, not driving distance and not travel time.

  • from
  • to
  • compact
  • cursor
  • max_bytes
  • snapshot_id

entity_financials

Fetches key figures from the annual accounts, the years a company has actually filed, a comparison with its industry, and the filed document itself, only for the companies you ask about.

  • compact
  • cursor
  • document_year
  • include
  • max_bytes
  • orgnr
  • orgnrs
  • snapshot_id

entity_resolve

회사 이름(이전 명칭 포함)을 조직번호가 붙은 후보 조직 목록으로 바꿔 주며, 그중 하나를 대신 골라 주지는 않습니다.

  • name
  • compact
  • cursor
  • fields
  • include_deleted
  • kind
  • limit
  • max_bytes
  • municipality
  • public_body
  • snapshot_id

entity_structure

상위 조직, 하위 단위, 그리고 공공기관의 경우 산하 기관까지 조직 간의 관계를 보여 줍니다.

  • orgnr
  • compact
  • cursor
  • fields
  • limit
  • max_bytes
  • section
  • snapshot_id

code_list

조직 형태, 업종, 지자체 등 필터링에 사용할 수 있는 코드를 나열합니다.

  • list
  • compact
  • cursor
  • fields
  • limit
  • max_bytes
  • query
  • snapshot_id

snapshot_status

등기부 데이터가 얼마나 최신인지, 즉 Brønnøysundregistrene에서 마지막으로 가져온 시점을 알려 줍니다.

  • detail
  • max_bytes

operator_guide

Explains what Brreg can do, how to connect, and ways to use it with your assistant.

특정 장소 주변 검색

entity_search에 좌표와 반경(lat, lon, radius_km)을 지정하면 등록된 주소가 해당 거리 내에 있는 조직을 가장 가까운 순서대로 나열하며, 각각의 거리와 주소 좌표를 함께 제공합니다. 이름 검색어를 함께 사용할 경우 관련도순 정렬이 유지되고 반경은 필터로 작동합니다.

  • 반경은 단독으로 최대 10 km까지, 또는 조직 형태, 업종, 이름 등 다른 필터와 함께 사용하는 경우 최대 50 km까지 설정할 수 있습니다.
  • 좌표는 등록된 주소(본 단위의 경우 사업장 주소, 하위 단위의 경우 소재지 주소)의 Kartverket 주소 좌표입니다. 건물의 외곽선이 아니며, 반드시 실제 업무가 이루어지는 장소를 의미하지도 않습니다.
  • c/o 주소, 사서함, 해외 주소 및 주소 등록부와 일치하지 않는 주소에는 좌표가 부여되지 않으며, 반경 검색에도 표시되지 않습니다.
  • 회계사 사무실처럼 여러 조직이 하나의 주소를 공유하는 경우가 많습니다. 각 검색 결과에는 해당 좌표를 공유하는 조직의 수가 표시됩니다.
entity_search lat=60.3913 lon=5.3221 radius_km=2 org_form=["KIRK"]

패턴으로 필드 일치시키기

entity_search에 match 필터를 지정하면 해당 필드가 패턴과 일치하는 조직만 유지합니다. 필드당 하나씩 최대 4개까지 지정할 수 있으며, 다른 필터와 함께 적용됩니다.

  • 일치 여부를 비교할 수 있는 필드는 activity, address, city, email, name, phone, website 등 7개입니다.
  • 패턴은 RE2 정규 표현식이며 대소문자 구분 없이 일치 여부를 판별하고, 앵커는 직접 지정합니다. 마침표 하나만 지정하면 필드가 존재하는지만 테스트합니다.
  • 가능하면 앵커를 지정하십시오. ^post는 검색 범위를 좁히므로 빠릅니다. 앵커가 없는 패턴은 처음 사용할 때 해당 필드의 모든 값을 읽으므로(약 10분의 1초 소요) 이후 호출자를 위해 결과를 보관합니다.
  • 일치 작업은 주간 판본에서 실행되므로, 마지막 재구축 이후 등록된 조직이나 변경된 값은 해당 판본에 수록된 내용을 기준으로 일치 여부를 확인합니다.
entity_search match=[{"field":"email","pattern":"^post"}] municipality="4601"

데이터 및 출처

Enhetsregisteret
Brønnøysundregistrene의 본 단위 및 하위 단위 정보로, 매주 전체 등기부를 바탕으로 재구축됩니다. 재구축 주기 사이에는 등기부 자체의 업데이트 피드가 주간 판본에 이미 포함된 항목을 갱신하고 삭제된 항목을 제외합니다(해당 피드는 약 1시간에 한 번, 야간에는 더 적은 빈도로 확인합니다). 직전 재구축 이후 등록된 조직은 조직번호 조회를 통해 찾을 수 있지만, 다음 재구축 전까지는 검색 결과에 나타나지 않습니다. 개방 데이터에서 항목이 삭제되면 24시간 이내에 Brreg에서도 삭제됩니다.
Regnskapsregisteret
최근 제출된 연차 결산서의 주요 재무 수치, 해당 조직이 실제로 제출한 회계연도 내역, 그리고 제출된 결산서 원본을 제공합니다. 이는 제출된 형태 그대로의 약 15년 치 전체 문서이며, 주요 재무 수치를 이용할 수 없는 은행 및 보험사에 대한 유일한 확인 경로입니다. 이 문서는 만료 기한이 있는 비공개 링크로 제공되며 텍스트 레이어가 없는 스캔 이미지이므로, 어시스턴트가 수치를 추출하기 위한 것이 아니라 사람이 직접 열어 읽기 위한 용도입니다. 모든 데이터는 명시적으로 요청할 때만 조회되며, 수치에는 항상 해당 연도가 표기됩니다.
Kartverket 주소 좌표
Kartverket의 국가 주소 등록부(Matrikkelen – Adresse)로, 매주 가져와 각 조직의 등록된 주소와 매칭하여 지도에 위치를 표시합니다.
matrikkel 단위 및 건물
지도 좌표가 있는 조직의 경우: matrikkel 단위(gnr/bnr 및 주소에 섹션이 정확히 하나만 있는 경우의 섹션 번호), grunnkrets, 교구 및 tettsted, 그리고 해당 주소의 기존 건물 중 최소 하나가 주거용이 아닌 경우의 건물 정보가 제공됩니다. 매주 Kartverket의 Matrikkelen – Adresse, Bygningspunkt 및 Adresse Leilighetsnivå에서 가져옵니다. 이는 조직이 소유한 부동산이 아니라 등록된 주소의 matrikkel 단위입니다.
코드
조직 형태, 지자체, 업종 코드(NACE), 제도 부문을 건수와 함께 등기부가 공개하는 그대로 제공합니다.
데이터 최신성
모든 답변에는 등기부의 어느 주간 판본에서 가져왔는지가 명시됩니다. 조직번호 조회 시 그 이후 발표된 변경 사항도 데이터를 읽어온 시각과 함께 표시되며, 어시스턴트는 데이터가 얼마나 최신인지 확인할 수 있습니다.

포함되지 않는 항목

  • 직책 및 인물 정보: 이사회 구성원, 대표이사 또는 소유자 제외.
  • 데이터 형태의 전체 연차 결산서: 상세 계정과목, 주석 및 감사보고서는 제공되지 않으며, 위의 주요 재무 수치만 데이터로 제공됩니다. 제출된 문서 자체는 요청 시 만료 기한이 있는 링크로 이용할 수 있으나, 텍스트 레이어가 없는 스캔 이미지이므로 문서 내 내용을 검색하거나 파싱할 수 없습니다. 40 MiB를 초과하는 문서는 전달되지 않으며, 대신 문서를 가져올 수 있는 공개 데이터 출처가 응답에 안내됩니다.
  • 개인사업자의 연락처 정보, 이전 명칭 및 사업 활동 설명.
  • 대량 내보내기 또는 등기부 복사본.

사용 한도

일일 호출 한도
각 요금제에는 Publifye 계정당 도구 호출 일일 한도가 포함되어 있습니다. 한도는 UTC 기준 자정에 초기화됩니다. 요금제별 사용 한도
주요 재무 수치 및 제출 문서
계정당 분당 Regnskapsregisteret에서 최대 30회의 신규 조회가 가능하며, 이는 주요 수치와 제출 내역이 공유합니다. 제출 문서는 수 메가바이트에 달하므로 분당 3회로 훨씬 더 엄격하게 제한됩니다. 어느 쪽이든 한도를 초과하면 이미 조회된 데이터를 받거나 다시 시도할 수 있는 시점을 안내하는 메시지가 표시됩니다.
응답 크기
기본적으로 응답당 약 24 KiB이며, 4~48 KiB 범위에서 조정할 수 있습니다. 결과가 더 길면 15분간 유효한 커서로 계속 이어집니다.
반경
단독 반경 검색 시 최대 10 km, 다른 필터와 함께 사용 시 최대 50 km입니다.
검색 깊이
검색은 결과의 맨 끝까지 페이지별로 탐색할 수 있습니다. cursor를 따라가면 누락되는 내용이 없습니다. 첫 호출 시 앞부분을 건너뛰는 offset 단축 기능만 10,000개에서 중단됩니다.

일일 사용 한도 소진 시

초기화 전까지 호출이 거부되며 어시스턴트가 읽고 설명할 수 있는 오류가 반환됩니다. 형태는 다음과 같습니다:

{"reason": "quota_exceeded", "service": "brreg-service", "window": "day", "limit": …, "resets_at": "…T00:00:00Z"}

개인정보 보호

  • Brreg는 조직에 관한 서비스입니다. 인명 등기부가 아니며 인물을 조회하는 용도로 사용할 수 없습니다.
  • 개인사업자는 한 사람과 연결되어 있으므로 Brreg는 이전 명칭, 사업 활동 설명, 연락처 정보를 제공하지 않으며, 명칭을 지정하지 않은 검색에는 개인사업자가 결코 표시되지 않습니다.
  • 주소만을 이용한 개인 조회 및 대량 내보내기는 지원하지 않습니다.
  • matrikkel 단위 및 건물에는 동일한 규칙이 적용됩니다. 개인사업자, 해당 하위 단위 또는 c/o로 기재된 주소에는 아무런 정보도 제공되지 않습니다. matrikkel의 정보는 해당 정보 주체의 동의 없이 광고 또는 마케팅 목적으로 사용할 수 없습니다(utleveringsforskriften § 5 제3항).
  • 개인사업자 및 그 하위 단위는 지도 좌표가 부여되지 않아 반경 검색에 표시되지 않으며, 동일 좌표 공유 시에도 집계되지 않습니다.
  • 주요 재무 수치는 명시적으로 요청할 때만 조회됩니다.
  • 기록 항목: 고객 계정의 모든 도구 호출에 대해 계정, 클라이언트 IP 주소, 도구 및 결과를 기록하며, 사용자가 전송한 인수는 절대 기록하지 않습니다. 감사 기록은 365일간 보관됩니다.
  • 삭제 처리: Brønnøysundregistrene의 개방 데이터에서 항목이 삭제되면 Brreg는 24시간 이내에 해당 항목을 삭제합니다.

라이선스 및 출처 표기

등기부 데이터는 NLOD 2.0(Norwegian Licence for Open Government Data)에 따른 Brønnøysundregistrene의 개방 데이터입니다. 모든 답변에는 라이선스에서 요구하는 출처 표기가 포함됩니다:

Inneholder data under Norsk lisens for offentlige data (NLOD) tilgjengeliggjort av Brønnøysundregistrene.

지도 좌표 및 거리는 Creative Commons Attribution 4.0 (CC BY 4.0) 라이선스에 따라 Matrikkelen – Adresse(© Kartverket)에서 제공됩니다. Publifye는 각 조직의 등록된 주소에 주소 좌표를 매칭하였으며, 이는 사업체가 실제로 운영되는 물리적 위치를 나타내지는 않습니다. 좌표나 거리가 포함된 답변에도 이 출처 표기가 포함됩니다. CC BY 4.0 보기

matrikkel 단위 또는 건물이 포함된 답변에는 utleveringsforskriften § 5 제10항의 요구에 따라 정보가 민간 등록부에서 제공된다는 사실이 명시됩니다.

Brreg는 Publifye AS에서 운영하며 공식 등기부가 아닙니다. 법적 효력이 있는 내용은 virksomhet.brreg.no에서 공식 기록을 확인하십시오. 라이선스 읽기

지원

질문이 있거나, 답변이 잘못되었거나, 누락된 내용이 있습니까? Publifye 지원팀에 문의할 때 Brreg를 언급해 주십시오. 고객지원 문의

시작하기