Apier

Apier MCP サーバー — AI エージェント向けのノルウェー企業データとコンプライアンス

Apier は、AI エージェントがノルウェーの企業データや規制コンプライアンスに構造化された形でアクセスできる、ホスト型の MCP（Model Context Protocol）サーバーです。9 桁の organisasjonsnummer（組織番号）を Brønnøysundregistrene（Brønnøysund 登録センター／Enhetsregisteret）で照合し、企業の署名権限（signaturrett と prokura）の保有者を回答し、Regnskapsregisteret の年次決算書（årsregnskap）を読み取り、MVA、A-melding、Årsregnskap の提出期限を算出します。また、Maskinporten を介して Skatteetaten などの機関に上流認証する Altinn 3 の systembruker を通じて委任される、範囲を限定でき、取り消し可能な企業からエージェントへの権限である fullmakt を仲介します。このリポジトリは、ローカルの stdio MCP クライアントをホスト型サーバーに接続する、軽量で堅牢化された npm プロキシ（@apier-no/mcp）です。

質問できること

このサーバーに接続すると、AI エージェントは次のような質問に回答できます。

• 「Equinor の organisasjonsnummer は何ですか？」(search_companies)
• 「組織番号 923 609 016 を代表して法的に署名できるのは誰ですか。また、それは signaturrett と prokura のどちらですか？」(get_company_authority)
• 「この企業は VAT 登録されていますか。また、どのような規制上の義務がありますか？」(get_company_summary)
• 「この企業が今後 6 か月に迎える提出期限を教えてください。」(get_company_deadlines)
• 「この企業の最新の年次決算書（årsregnskap）を表示してください。」(get_company_accounts)
• 「この古い Altinn 2 のロールコードに相当する Altinn 3 のロールを教えてください。」(get_altinn_migration_guidance)
• 「EUR から NOK への Norges Bank の現在の為替レートはいくらですか？」(get_exchange_rate)
• 「この企業を代表して手続きを行えるよう fullmakt を申請し、提出前に検証してください。」(request_fullmakt, check_fullmakt)

ツール

ホスト型サーバーが https://www.apier.no/api/mcp で公開する全 25 個のツール（2026-10-10 に tools/list を通じてライブで検出。各行はライブ説明の冒頭の文であり、全文は tools/list を 1 回呼び出せば確認できます）：

ツール	説明
get_company_summary	ノルウェーの組織の義務と期限を一度にまとめます。企業の概要を把握する際に最初に呼び出すツールです。
get_public_obligations	キー不要。ノルウェーの法人形態に共通する義務一式を取得します。組織形態に該当することで適用されるすべての規制上の義務を、企業ごとの Tier-2 データを加味する前に取得します。
get_exchange_rate	キー不要。NOK に対する通貨の Norges Bank 参照為替レートです。これはノルウェーの税務・会計規則で外貨建ての義務に適用される基準レートです。
list_acting_capacity	特定の組織に代わって、ある人物が現在実行を認められているノルウェーの規制上の手続きをすべて解決します。
get_company_profile	ノルウェーの organisasjonsnummer（9 桁）を、Brønnøysund Enhetsregisteret の構造化された企業プロフィールに変換します。表示名、組織形態、説明付きの NACE コード、住所、登録日と解散日、active ／ dissolved のステータス列挙型、MVA 登録フラグ、人物の役職コードを取得します。個人識別情報は取得しません。
check_authorization	ノルウェーの組織に対する、呼び出し元のコンシューマーの委任に関する認可スナップショットを返します。status 列挙型（full ／ partial ／ none）、active_scopes、missing_scopes（full の場合は空）、delegated_rights を含みます。
get_company_context	ノルウェーの組織に関する Brønnøysund の基本情報です。正式名称、組織形態、NACE コード、住所、設立日または解散日、signaturrett ／ prokura の役職コードの概要を含みます（個人識別情報は含みません）。
get_company_deadlines	指定した組織について、今後 horizon_months か月間の申告カレンダーを取得します。
get_company_obligations	ノルウェーの組織について Apier Rulebook を評価します。各ルールにつき、rule_id、obligation_name、evaluation_result（applicable、not_applicable、insufficient_data のいずれか）、理由、legal_reference、頻度、必要なデータ階層、bokmål の説明を 1 件ずつ返します。説明はバイト単位でそのまま継承され、再翻訳されません。
get_public_deadlines	キー不要。ノルウェーの共通申告カレンダーです。特定の組織に依存しない、対象カテゴリ（MVA、A-melding、Skattemelding、Årsregnskap）におけるすべてのノルウェー企業の期限を取得します。
validate_action	提案された規制上の手続きを、上流への副作用なし（政府への呼び出しなし）でドライランします。
explain_compliance_error	キー不要。構造化された Apier コンプライアンスエラーコードを、ノルウェー語 bokmål の説明エンベロープに変換します。概要、bokmål による理由、順序付きの fix_steps、任意の文書リンクと legal_basis、さらに人による解決が必要なエラー向けの任意の引き継ぎブロック（担当者／場所／内容／理由）を含みます。
search_companies	ノルウェーの企業名を、9 桁の organisasjonsnummer に変換します。
get_company_verification	ノルウェーの組織のために行動する前に、信頼性をすばやく確認し、実行可否を判断します。
get_company_authority	このノルウェー企業の法的な署名権者と、その署名方法を確認します。
get_company_accounts	OPEN Regnskapsregisteret 階層から、ノルウェー企業の年次会計（årsregnskap）の最新スナップショットを取得します。has_filed_annual_accounts（null は不明を意味し、false を捏造することはありません）、last_accounts_year、その年の最小限の key_figures（通貨、表示基準、合計額は必ず提示されます）を含みます。
get_company_filing_history	企業の Altinn 3 申告履歴を、YOUR コンシューマーが Apier を通じて提出した申告と照合します。各 Altinn インスタンスに、対応する Apier 監査記録（filed_via_apier と apier_record）を関連付けます。
list_changes	Apier がポーリングする上流ソース（Brønnøysund、Altinn schemas、Norges Bank、NAV、Skatteetaten Tier-2）で検出された作成／更新／削除イベントを、Apier の複数ソースにまたがる変更アーカイブから読み取ります。Digdir ポーラーは廃止されているため、digdir は有効ですが、フィルター結果は空です。
get_altinn_migration_guidance	Altinn 2 のサービスコードまたは役割コードに対応する Altinn 3 の代替を確認します。
request_fullmakt	Altinn systembruker を介して、範囲を限定でき、取り消し可能な企業からエージェントへの権限である fullmakt を仲介します。
check_fullmakt	ノルウェー企業に代わって行動する前に、その企業に対する fullmakt の状態を確認します。
revoke_fullmakt	fullmakt を取り消します。ノルウェー企業からエージェントへの委任権限を撤回し、エージェントのプリンシパルを無効化します。
get_pricing	従量課金対象の処理を行う前に呼び出し、呼び出しごとの費用と課金の強制適用が有効かどうかを確認します。
get_credit_balance	従量課金対象の呼び出しをまとめて行う前に呼び出し、呼び出し元のキーのプリペイド残高で費用をまかなえることを確認します。また、402 INSUFFICIENT_CREDITS の発生後に人がチャージした場合は、入金を確認するために呼び出します。
redeem_issuance_token	所有者が発行したキー発行トークンを自身の API キーに変換します。まだ認証情報を持たないエージェント向けの、ヘッドレスなオンボーディング手順です。

キーなしで試す

このプロキシの起動には APIER_API_KEY が必要です（クイックスタートを参照）。プロキシは、指定されたベアラーをそのまま Authorization: Bearer … として転送し、キーの形式を検査することはありません。本物のキーがなくても、合成フィクスチャから配信され、政府の登録情報を参照しないサンドボックスの経路が2つあります。

• apier.no の /api/v1/sandbox/ 配下にあるサンドボックスミラーへの直接 HTTP 接続です。すべての Category B 企業エンドポイントにミラーがあります。認証が完全に不要なわけではなく、自分で作成したサンドボックスベアラー apier_sandbox_test_<suffix>（A-Za-z0-9_- の文字を1〜64文字、任意のサフィックスとして指定）が必要です。サーバーはプレフィックスでこれを認識してフィクスチャを返すため、サインアップは不要で、背後にキーの保存場所もありません。単一のフィクスチャ組織 999999999 用には、/api/v1/sandbox/public/ 配下に認証が本当に不要な別のミラーもあります。
• ホスト型 MCP エンドポイント https://www.apier.no/api/mcp で同じサンドボックスベアラーを使用します。Authorization: Bearer apier_sandbox_test_<suffix> を送信すると、フィクスチャを使う企業ツール（get_company_context、get_company_obligations、get_company_deadlines、get_company_summary、get_company_verification、explain_compliance_error、get_company_authority、get_company_accounts、get_company_filing_history）はサンドボックスミラーに転送され、すべての結果に _meta.is_sandbox: true が付与されます。残りのツールはキーがない場合とまったく同じように応答します。このプロキシはベアラーを変更せずに転送するため、APIER_API_KEY にこの値を設定すれば、stdio クライアントでもフィクスチャを使ってこれらのツールを試せます。

サンドボックスのテストデータ（認証は一切不要）の正規一覧を取得します。

curl -sL https://apier.no/api/v1/sandbox/fixtures

簡略化したレスポンス — … は省略されたフィールドを示します。

{"success":true,"data":{"schema_version":"1.0.0",
  "reserved_test_orgs":[{"org_number":"999000001","name":"Sandbox AS","entity_type":"AS","data_tier":"tier_1", …}],
  "realistic_orgs":[{"org_number":"818000006","name":"Fjellberg Regnskap AS","entity_type":"AS","data_tier":"tier_1_2"}, …],
  "magic_scenarios":[{"org_number":"999660010","state":"konkurs","label":"Bankrupt (konkurs)"}, …], …}}

自分で作成したベアラーを使って、倒産したフィクスチャ企業を確認します。apier_sandbox_test_ の後に A-Za-z0-9_- の文字を1〜64文字、任意に指定できます。ここでは bash の $RANDOM で生成します。（この呼び出しは www ホストに直接送信します。apex から www への 308 リダイレクトでは、curl が Authorization ヘッダーを削除するためです。）

curl -s -H "Authorization: Bearer apier_sandbox_test_$RANDOM" https://www.apier.no/api/v1/sandbox/company/999660010/verify

簡略化したレスポンス — … は省略されたフィールドを示します。

{"success":true,"data":{"org_number":"999660010","name":"Sandbox Konkurs AS",
  "verification_status":"fail",
  "signals":{"is_active":false,"not_bankrupt":false, …},
  "summary":"Selskapet er ikke aktivt registrert i Enhetsregisteret.", …}}

2つのプレフィックスを混同しないでください。本物の API キーは apr_<tier>_…（apr_free_、apr_starter_、apr_pro_ または apr_ent_）で、https://www.apier.no/docs/authentication からサインアップして取得します。一方、apier_sandbox_test_ は自分で生成でき、サインアップは不要です。以前の README には apier_live_ / apier_test_ キーへの言及がありましたが、その形式のキーが発行されたことはありません。GET /api/v1/sandbox/fixtures は、サンドボックスのテストデータを機械可読な形式で一覧できる正規のエンドポイントです。

クイックスタート

ホスト型エンドポイント（ストリーミング可能な HTTP）

最も手早く使える方法です。インストールは不要です。ストリーミング可能な HTTP に対応する MCP クライアントを次の URL に接続します。

https://www.apier.no/api/mcp

検出はキーなしで行えます。initialize、tools/list、リソース、プロンプトはすべて認証情報なしで動作するため、エージェントは認証前にカタログ全体を確認できます。保護されたツールを呼び出す場合にのみ、API キー（Authorization: Bearer apr_<tier>_…）が必要です。キーの取得方法は https://www.apier.no/docs/authentication を参照し、その後 https://www.apier.no/dashboard のダッシュボードで作成してください。

npx stdio プロキシ（@apier-no/mcp）

stdio のみ対応するクライアント向けに、このパッケージは mcp-remote をラップします。環境変数から APIER_API_KEY を読み取り、起動した子プロセスの環境からその値を削除し、stderr からも伏せたうえで、コマンドラインに表示されないようベアラー値を帯域外で渡します。詳しくは SECURITY.md を参照してください。

mcp-remote のリポジトリは geelen/mcp-remote から punkpeye/mcp-remote に移転しました。npm パッケージ名は変更されておらず、0.8.1 は SLSA 来歴証明付きで公開されています。

@apier-no/mcp として公開されています。 @apier スコープを利用できなかったため、このパッケージは @apier-no スコープで提供されています。

Claude Desktop / Cursor（claude_desktop_config.json / ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "apier": {
      "command": "npx",
      "args": ["-y", "@apier-no/mcp"],
      "env": { "APIER_API_KEY": "apr_<tier>_<your_key_here>" }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "apier": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@apier-no/mcp"],
      "env": { "APIER_API_KEY": "apr_<tier>_<your_key_here>" }
    }
  }
}

Zed（settings.json）：

{
  "context_servers": {
    "apier": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@apier-no/mcp"],
      "env": { "APIER_API_KEY": "apr_<tier>_<your_key_here>" }
    }
  }
}

各クライアント用の、そのまま貼り付けて使える設定ファイルは examples/ にあります。

設定

変数	必須	デフォルト
APIER_API_KEY	はい	—
--endpoint <url>	いいえ	https://www.apier.no/api/mcp
MCP_REMOTE_CONFIG_DIR	いいえ	~/.mcp-auth

セキュリティ

• APIER_API_KEY は親プロセスによって読み取られ、起動された子プロセスの環境から削除されます。また、標準エラー出力には、Bearer …、apr_<tier>_… 形式のキー、キー発行トークン apr_issue_…、旧形式の apier_(live|test)_…、ghp_…、および Authorization: という文字列を除去するリダクターが適用されます。
• キーが子プロセスのコマンドラインに表示されることはありません。 --header 引数に含まれるのはプレースホルダー Authorization:${APIER_MCP_AUTH_HEADER} のみです。ベアラー値はこの変数を通じて別途渡され、リクエスト時に mcp-remote によって展開されます。Linux ではコマンドラインは全ユーザーから読み取り可能ですが（/proc/<pid>/cmdline）、プロセス環境は読み取りできません。そのため、ほかのローカルユーザーから読み取られることはなくなりました（#33、1.2.0 で修正）。すでにあなたと同じユーザーとして実行中の攻撃者は、引き続き環境を読み取ることができます。詳しくは SECURITY.md をご覧ください。
• https 以外のエンドポイントは起動前に拒否されます。mcp-remote のバージョンは厳密に固定されており、リリースは GitHub Actions Trusted Publishing（OIDC）を使用した npm provenance 付きで公開されます。
• クライアント設定ファイル（claude_desktop_config.json、.cursor/mcp.json など）は .env ファイルと同様に扱い、実際のキーを含む状態でコミットしないでください。

脅威モデルと脆弱性開示ポリシーの全容については、SECURITY.md をご覧ください。

ドキュメント

• MCP サーバーのドキュメント：https://www.apier.no/docs/mcp
• Apier プラットフォームのドキュメント：https://apier.no/docs

ライセンス

MIT