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

연결하기

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

이용하려면 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 명령을 실행하여 로그인하십시오:

기타 MCP 클라이언트

전송 방식

위 주소에서 Streamable HTTP(POST 기반 JSON-RPC)를 사용합니다.

로그인

Publifye 로그인을 통한 PKCE 기반 OAuth 2.1입니다. 클라이언트가 자동으로 자체 등록(동적 클라이언트 등록)되므로 사전 설정이 필요하지 않습니다.

디스커버리

https://brreg.publifye.com/.well-known/oauth-protected-resource

도구

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

특정 장소 주변 검색

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

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

데이터 및 출처

Enhetsregisteret

Brønnøysundregistrene의 본 단위 및 하위 단위 데이터로, 매주 전체 등기부를 바탕으로 새로 구축됩니다. 개방 데이터에서 항목이 삭제되면 24시간 이내에 Brreg에서도 삭제됩니다.

Regnskapsregisteret

최근 제출된 연차 결산서의 주요 재무 수치로, 명시적으로 요청할 때만 조회되며 항상 해당 연도와 함께 표시됩니다.

Kartverket 주소 좌표

Kartverket의 국가 주소 등록부(Matrikkelen – Adresse)로, 매주 가져와 각 조직의 등록된 주소와 매칭하여 지도에 위치를 표시합니다.

코드

조직 형태, 지자체, 업종 코드(NACE), 제도 부문을 건수와 함께 등기부가 공개하는 그대로 제공합니다.

데이터 최신성

모든 답변에는 등기부의 어느 주간 판본에서 가져온 데이터인지 표시되며, 어시스턴트는 데이터가 얼마나 최신인지 확인할 수 있습니다.

포함되지 않는 항목

• 직책 및 인물 정보: 이사회 구성원, 대표이사 또는 소유자 제외.
• 전체 연차 결산서 원문, 주석 또는 감사 보고서.
• 개인사업자의 연락처 정보, 이전 명칭 및 사업 활동 설명.
• 대량 내보내기 또는 등기부 복사본.

사용 한도

일일 호출 한도

각 요금제에는 Publifye 계정당 도구 호출 일일 한도가 포함되어 있습니다. 한도는 UTC 기준 자정에 초기화됩니다. 요금제별 사용 한도

주요 재무 수치

계정당 분당 최대 30회의 신규 Regnskapsregisteret 조회가 가능합니다. 이를 초과하면 이미 조회된 수치가 제공되거나 다시 시도할 수 있는 시점을 안내합니다.

응답 크기

기본적으로 응답당 약 24 KiB이며, 4~48 KiB 범위에서 조정할 수 있습니다. 결과가 더 길면 15분간 유효한 커서로 계속 이어집니다.

반경

단독 반경 검색 시 최대 10 km, 다른 필터와 함께 사용 시 최대 50 km입니다.

검색 깊이

검색 시 최대 10,000개의 결과까지 페이지별로 탐색합니다. 그 이상의 결과를 확인하려면 필터를 사용해 범위를 좁히십시오.

일일 사용 한도 소진 시

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

개인정보 보호

• Brreg는 조직에 관한 서비스입니다. 인명 등기부가 아니며 인물을 조회하는 용도로 사용할 수 없습니다.
• 개인사업자는 한 사람과 연결되어 있으므로 Brreg는 이전 명칭, 사업 활동 설명, 연락처 정보를 제공하지 않으며, 명칭을 지정하지 않은 검색에는 개인사업자가 결코 표시되지 않습니다.
• 주소만을 이용한 개인 조회 및 대량 내보내기는 지원하지 않습니다.
• 개인사업자 및 그 하위 단위는 지도 좌표가 부여되지 않아 반경 검색에 표시되지 않으며, 동일 좌표 공유 시에도 집계되지 않습니다.
• 주요 재무 수치는 명시적으로 요청할 때만 조회됩니다.
• 기록 항목: 고객 계정의 모든 도구 호출에 대해 계정, 클라이언트 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 보기

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

지원

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