ChatGPT 플러그인과 MCP
ChatGPT, Claude 및 기타 AI 에이전트에서 바로 쓰는 회사 데이터.
ChatGPT 플러그인과 MCP 서버를 쓰면 AI 에이전트가 공식 회사 데이터를 스스로 찾아봐요. 채팅에서 질문하면 에이전트가 알맞은 도구를 골라 등기부 데이터로 답해요.
ChatGPT 플러그인
ChatGPT 플러그인이 가장 빠른 방법이에요. 연결할 때 handelsregister.ai 계정으로 로그인하므로 API 키가 필요 없어요.
- ChatGPT 플러그인을 열고 ChatGPT에 추가하세요.
- handelsregister.ai 계정으로 로그인하고 접근을 허용하세요.
- 질문하세요. 예: “Hetzner Online GmbH는 누가 운영하고, 매출은 어떻게 변해 왔어?”
Claude, Cursor 및 기타 MCP 클라이언트
MCP(Model Context Protocol)는 AI 에이전트가 도구와 데이터 소스에 접근할 때 쓰는 개방형 표준이에요. URL로 MCP 서버에 연결하는 클라이언트라면 어떤 것이든 저희 서버를 쓸 수 있어요.
| 항목 | 값 |
|---|---|
| 서버 URL |
https://mcp.handelsregister.ai/mcp |
| 전송 방식 | Streamable HTTP |
| 로그인 | 계정으로 OAuth, x-api-key 헤더의 API 키 또는 Authorization 헤더의 Bearer 토큰 |
Claude
Claude에서는 MCP 서버를 사용자 지정 커넥터로 추가해요. 커넥터 설정에서 “Add custom connector”를 고르고, 이름과 서버 URL을 입력한 뒤 handelsregister.ai 계정으로 로그인하세요. 그다음 채팅의 “+” › “Connectors”에서 커넥터를 켜세요.
Team과 Enterprise 워크스페이스에서는 소유자가 모두를 위해 커넥터를 추가해요. 그러면 각 멤버가 자기 handelsregister.ai 계정을 연결해요.
Claude Code
Claude Code에서는 명령 하나로 서버를 추가해요. 헤더가 있으면 Claude Code가 API 키를 써요.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: YOUR_API_KEY"
헤더 없이 추가하면 대신 브라우저에서 로그인해요: 세션을 시작하고 /mcp에서 서버를 고르세요.
Cursor
Cursor는 프로젝트의 .cursor/mcp.json 또는 모든 프로젝트용 ~/.cursor/mcp.json에서 MCP 서버를 읽어요. 다른 많은 클라이언트도 같은 형식을 써요.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "YOUR_API_KEY" } } } }
기타 MCP 클라이언트
서버 URL을 입력하고 요청마다 x-api-key 헤더로 API 키를 보내세요. 또는 Authorization 헤더에 Bearer 토큰을 쓰세요. 만드는 방법은 인증에 있어요.
제공 도구
MCP 서버는 계정, 회사 프로필, 인물, 문서, 검색, Signals용 도구를 제공해요. 모든 도구는 읽기만 해요. 아무것도 만들지 않고 설정도 바꾸지 않아요. API에 같은 요청을 보낼 때와 같은 크레딧이 들어요.
회사 도구는 q 파라미터로 entity_id, 회사명 또는 등기 법원과 등기 번호(예: “Ansbach HRB 6089”)를 받아요. 검색에서 얻은 entity_id가 가장 확실해요. 대부분의 회사 도구에서 ai_search는 AI 모드를, realtime은 실시간 모드를 켜요.
계정
| 도구 | 반환 내용 | 크레딧 |
|---|---|---|
| get_account_status | 플랜, 잔액, 다음 크레딧 만료일, 플랜으로 열리는 데이터. | 무료 |
회사 프로필
각 회사 도구는 fetch-organization과 똑같이 회사 프로필 기본 가격에 해당 기능의 가격을 더한 비용이 들어요. 기능은 데이터를 반환할 때만 과금돼요.
| 도구 | 반환 내용 | 크레딧 |
|---|---|---|
| get_company_overview | 기본 데이터: 이름, 상태, 법적 형태, 등기, 주소, 자본금, 사업 목적, 업종. | 5 |
| get_company_snapshot | 기본 데이터, 재무 KPI, 현재 경영진을 한 번의 호출로. | 5 + 1 + 2 |
| get_financials | 회계연도별 재무 KPI, 예: 매출, 당기순이익, 직원 수. | 5 + 1 |
| get_balance_sheet | 모든 항목이 담긴 재무상태표. | 5 + 3 |
| get_profit_and_loss | 손익계산서. | 5 + 3 |
| get_annual_financial_statements | Markdown으로 된 연간 재무제표 전문. | 5 + 5 |
| get_annual_financial_statements_html | HTML로 된 연간 재무제표 전문. | 5 + 5 |
| get_related_persons | 경영진과 기타 등기된 인물, 요청하면 이전 인물도. | 5 + 2 |
| get_shareholders | 지분과 함께 주주. | 5 + 5 |
| get_ubos | 실소유자(UBO). | 5 + 10 |
| get_shareholdings | 회사가 다른 회사에 보유한 지분. | 5 + 5 |
| get_mergers_and_acquisitions | 인수합병(M&A)과 기업 계약. | 5 + 20 |
| get_publications | 등기 공고 이력. | 5 + 1 |
| get_insolvency_publications | 파산 공고. | 5 + 5 |
| get_news | 웹에서 가져온 회사 관련 뉴스. | 5 + 10 |
| get_website_content | Markdown으로 된 회사 웹사이트 내용. 이 도구는 항상 AI 모드를 써요. | 5 + 20(AI 모드) |
| get_company_features | 여러 기능을 한 번의 호출로, 기본 가격은 한 번만. | 5 + 기능 |
인물과 문서
| 도구 | 반환 내용 | 크레딧 |
|---|---|---|
| fetch_person | 인물 프로필: 이름과 관련 회사로 찾은 인물의 직위, 지분, 경력. · Plus부터 | 15, 지분 포함 시 + 5 |
| fetch_document | 등기부 문서: Aktueller Abdruck(AD, 현재 등본), Chronologischer Abdruck(CD, 연대순 등본), Strukturierter Registerinhalt(SI, 구조화 등기 내용), Gesellschafterliste(주주 명부) 또는 정관. | 15 |
검색
검색 도구는 페이지당 최대 30개 결과를 각각 entity_id와 함께 반환해요. 에이전트는 이것으로 회사 프로필을 가져와요.
| 도구 | 반환 내용 | 크레딧 |
|---|---|---|
| search_organizations | 이름이나 필터로 회사 찾기. | 페이지당 1 |
| search_organizations_advanced | API의 모든 필터와 정렬로 검색, 예: 매출이나 설립일순. | 페이지당 1 |
| find_companies_by_industry | 말로 설명하거나 WZ 코드로 지정한 업종의 회사. | 페이지당 1 |
| find_companies_by_financials | 매출, 직원 수, 당기순이익, 자기자본 등 KPI별 회사. | 페이지당 1 |
| find_companies_near | 위치 주변의 회사, 가까운 순. | 페이지당 1 |
| find_newly_registered_companies | 기간 내 새로 등기된 회사. | 페이지당 1 |
| find_recently_changed_companies | 최근 변경이 있는 회사, 예: 경영진, 본점 소재지, 자본금. | 페이지당 1 |
| find_related_companies | 지분, 직위, 합병, 기업 계약으로 연결된 회사. | 페이지당 1 |
| find_companies_by_person | 한 인물이 직위를 가진 회사. 주주로 검색은 Pro와 Max에서 가능해요. | 페이지당 1 |
| find_companies_by_ownership | 소유 구조별 회사, 예: 오너 경영 또는 가족 소유. · Pro, Max | 페이지당 1 |
| find_companies_by_management | 경영진의 연령과 규모별 회사. · Pro, Max | 페이지당 1 |
| find_companies_in_insolvency | 단계와 기간별 파산 절차 중인 회사. · Pro, Max | 페이지당 1 |
| get_search_filter_reference | 검색 필터의 허용 값. | 무료 |
| find_industry_codes | 말로 설명한 업종의 WZ 코드, 예: “소프트웨어 개발”. | 무료 |
Signals
Signals 도구는 모든 회사에 걸친 등기부의 변경 사항을 페이지당 최대 20개 반환해요. 페이지는 비어 있어도 과금돼요.
| 도구 | 반환 내용 | 크레딧 |
|---|---|---|
| get_recent_new_registrations | 신규 등기. | 페이지당 20 |
| get_recent_management_changes | 경영진 변경. | 페이지당 20 |
| get_recent_capital_changes | 자본금 변경. | 페이지당 20 |
| get_recent_master_data_changes | 이름, 본점 소재지, 주소 같은 기본 데이터 변경. | 페이지당 20 |
| get_recent_company_closures | 폐업 및 해산. | 페이지당 20 |
| get_recent_insolvency_events | 파산. · Pro, Max | 페이지당 20 |
| get_recent_mergers_and_transformations | 조직 변경 & M&A. · Max | 페이지당 20 |
| get_recent_company_changes | 특정 회사 최대 다섯 곳의 모든 변경. | 페이지당 20 |
| get_signal_details | 모든 세부 정보가 담긴 개별 Signal. | 20 |
비용
각 도구 호출에는 API에 같은 요청을 보낼 때와 같은 크레딧이 들어요. MCP 전용 요금은 없어요. 크레딧은 로그인한 계정 또는 API 키가 속한 계정에서 차감돼요.
API와 같은 규칙이 적용돼요: 데이터가 없는 기능은 무료이고, 실패한 호출도 무료예요. AI 모드는 일치 결과가 없어도, 실시간 모드는 실시간 조회가 성공할 때마다 과금돼요. 모든 결과에는 차감된 크레딧이 meta.request_credit_cost에, 잔액이 meta.credits_remaining에 표시돼요.