ChatGPT 插件和 MCP

直接在 ChatGPT、Claude 和其他 AI 智能体中使用企业数据。

借助 ChatGPT 插件和 MCP 服务器，你的 AI 智能体会自行查询官方企业数据。你在对话中提问，智能体选择合适的工具，并用登记册中的数据作答。

ChatGPT 插件

ChatGPT 插件是最快的方式。你不需要 API 密钥，因为连接时你会用 handelsregister.ai 账户登录。

打开 ChatGPT 插件，并在 ChatGPT 中添加它。
用你的 handelsregister.ai 账户登录并确认授权。
提出你的问题，例如“谁在经营 Hetzner Online GmbH，其营业收入如何变化？”

能否使用插件取决于你的 ChatGPT 套餐。在企业工作区中，管理员可以允许或禁止插件。

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 密钥。

Terminal

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 服务器。许多其他客户端使用相同的格式。

mcp.json

{
    "mcpServers": {
        "handelsregister": {
            "url": "https://mcp.handelsregister.ai/mcp",
            "headers": {
                "x-api-key": "YOUR_API_KEY"
            }
        }
    }
}

其他 MCP 客户端

填入服务器 URL，并在每个请求的 x-api-key 请求头中发送你的 API 密钥。也可以在 Authorization 请求头中使用 Bearer 令牌；如何创建令牌，见身份验证。

你的 API 密钥位于“账户 › API 密钥”下。它应放在你本机的配置中，绝不能放进公开的代码仓库。

可用工具

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	损益表（P&L）。	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	改制与并购。 · Max	每页 20
get_recent_company_changes	最多五家指定公司的所有变更。	每页 20
get_signal_details	单条信号及其全部详情。	20

费用

每次工具调用消耗的积分与通过 API 进行相同请求一致。MCP 不另行收费。积分从你登录的账户或 API 密钥所属的账户中扣除。

规则与 API 相同：没有数据的功能不收费，失败的调用不收费。AI 模式即使没有匹配也计费，实时模式在每次成功的实时获取时计费。每个结果都在 meta.request_credit_cost 中给出扣除的积分，在 meta.credits_remaining 中给出你的余额。

限制也与 API 相同，例如文件为每分钟 5 次请求。详见计费和限制。

身份验证 API 密钥、Bearer 令牌和 OAuth 一览。计费每个请求的费用，以及如何追踪。