nordic-data

Nordic Data MCP Server

AI エージェント（Claude、Cursor、Claude Code、ChatGPT、Copilot など）に、15 か国の欧州全域における公式企業データへの直接アクセスを提供する、Model Context Protocol サーバーです。

企業を検索し、VAT 番号を検証し、KYB レポートを実行し、制裁リストと照合し、住所を自動補完し、LEI の所有関係を解決できます。すべて AI アシスタント内から利用できます。

DK · NO · SE · FI · IE · UK · FR · DE · CZ · PL · LV · EE · NL · BE · LU

NL と DE の利用には Starter+ サブスクリプションが必要です（無料プランの API キーでは HTTP 402 upgrade_required が返されます）。有料プランでは、NL の呼び出しはクォータ単位を 5 倍、DE の呼び出しは 3 倍消費します。それ以外の国は 1 倍です。

---

クイックスタート

1. API キーを取得する

addonnordic.com でサインアップし、NORDIC_API_KEY を取得します。無料プランも利用できます。

2. Claude Desktop に追加する

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%/Claude/claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "nordic-data": {
      "command": "npx",
      "args": ["-y", "nordic-data-mcp"],
      "env": {
        "NORDIC_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

Claude Desktop を再起動します。ツールメニューに「nordic-data」が表示されます。

3. Cursor に追加する

Cursor の設定 → MCP → サーバーを追加を選ぶか、~/.cursor/mcp.json を編集します。

{
  "mcpServers": {
    "nordic-data": {
      "command": "npx",
      "args": ["-y", "nordic-data-mcp"],
      "env": {
        "NORDIC_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

4. Claude Code に追加する

claude mcp add nordic-data --env NORDIC_API_KEY=YOUR_KEY_HERE -- npx -y nordic-data-mcp

5. ChatGPT に追加する（Pro、Business、または Enterprise）

ChatGPT はリモート MCP サーバーをカスタムコネクターとしてサポートしています。API キーを用意する必要はありません。ホストされたサーバーが上流の認証を処理します。

1. ChatGPT → 設定 → コネクター → カスタムコネクターを追加
2. URL：https://nordic-data-mcp-production.up.railway.app/mcp
3. 完了 — 11 個のツールがすぐに利用できます。

カスタムコネクターを利用するには、ChatGPT Pro、Business、Team、または Enterprise プランが必要です。

6. Claude.ai に追加する（ウェブ）

同じホスト型エンドポイントを使用するため、ローカルへのインストールは不要です。

1. Claude.ai → 設定 → コネクター → カスタムコネクターを追加
2. URL：https://nordic-data-mcp-production.up.railway.app/mcp
3. 完了。

---

利用可能なツール

ツール	機能
lookup_company	公式登記機関（CVR、Brønnøysund、Bolagsverket、Companies House、INSEE など）の基本的な企業データを取得します
validate_vat	VIES を照会し、EU 加盟 27 か国の VAT 番号を検証します
screen_sanctions	国連／EU／英国／OFAC／PEP リストと最大 1000 件の名前を一括照合します（英国は FCDO UK Sanctions List、登録件数 745K 件以上）
kyb_full	企業の本人確認レポート。企業情報、関係者、財務情報、LEI、VAT、制裁、ネガティブ報道、リスクスコアを網羅します
autocomplete_address	DK（DAWA）、NO（Kartverket）、FR（BAN）、SE、FI（OpenStreetMap Nominatim）の住所を座標付きで自動補完します
lookup_lei	GLEIF の法人識別子（LEI）を検索します。前方検索、逆引き、親子関係に対応しています
company_enriched	1 回の呼び出しで、企業登記データと国内の産業統計を取得します（DK、NO、SE、FI）
fr_history	INSEE Sirene の双時点データから、フランス企業の沿革（名称、事業活動、ステータス、法的形態の変更）を時系列で取得します
list_endpoints	エンドポイントの一覧表示：基盤 API にあるすべての読み取り専用データエンドポイント（230 以上）を、任意のキーワードで絞り込んで表示します
get_endpoint_schema	エンドポイントのスキーマ表示：呼び出し前に、指定したエンドポイントのパラメーターとレスポンスのスキーマ全体を取得します
call_endpoint	エンドポイントを実行します：検出した任意のエンドポイントに対して、読み取り専用リクエスト（GET／HEAD、および許可リストに登録された 3 種類の POST スクリーニングクエリ）を実行します

エージェントプロンプトの例

「デンマークのCVR 61056416を調べてください」 → lookup_company { country: "dk", id: "61056416" } を呼び出します → Carlsberg A/S

「Equinor（NO 923609016）の完全なKYBレポートを実行してください」 → kyb_full { country: "no", id: "923609016" } を呼び出します

「LU26375245は有効なVAT番号ですか？」 → validate_vat { country: "LU", vat_number: "26375245" } を呼び出します

「次の名前を制裁対象リストと照合してください：Vladimir Putin、Acme Corp、John Smith」 → screen_sanctions { names: [...] } を呼び出します

「Tesco UK（00445790）のLEIを検索し、親会社と子会社も含めてください」 → lookup_lei { mode: "reverse", country: "uk", id: "00445790" } を呼び出します

---

国／ID形式のリファレンス

国	IDの種類	形式
DK	CVR	8桁
NO	Organisasjonsnummer	9桁
SE	Organisationsnummer	10桁（ハイフンあり、またはなし）
FI	Y-tunnus	NNNNNNN-D（7桁＋チェックディジット）
IE	CRO number	1～7桁
UK	Companies House	8文字（数字、またはSC、NI、OCなどの接頭辞）
FR	SIREN	9桁
DE	LEIまたはHRB	LEI＝英数字20文字、HRB＝接頭辞＋数字
CZ	IČO	8桁
PL	NIP／REGON／KRS	NIP＝10桁、REGON＝9桁／14桁、KRS＝10桁
LV	Reģistrācijas nr.	11桁
EE	Registrikood	8桁
NL	KvK-nummer	8桁
BE	BCE/KBO	10桁
LU	RCSL	B＋数字

上記の表は、lookup_company、kyb_full、およびlookup_lei（reverseモード）に適用されます。company_enrichedはDK、NO、SE、FIに対応し、autocomplete_addressはDK、NO、SE、FI、FRに対応します。

validate_vatでは、27のEU加盟国に対するVIESの国コードを大文字で指定してください。ギリシャにはGRではなくELを使用します。英国とノルウェーには対応していません。

---

設定

設定が必要な環境変数は次の1つだけです。

変数	必須	説明
NORDIC_API_KEY	はい	addonnordic.comで取得したAPIキー

以上です。MCP サーバーがホストされたNordic Data APIに接続します。

---

セルフホスティング（リモートHTTPトランスポート）

リモートMCPホスティング（Anthropic Connectors、Smithery、ウェブベースのクライアントなど）では、同梱されているStreamable HTTPトランスポートをデプロイします。

npm install
npm run build
NORDIC_API_KEY=sk_... npm run start:http   # listens on :$PORT (default 3000)

エンドポイント：

• GET /healthz — ヘルスチェック（バージョン＋ステータスを返します）
• ALL /mcp — 公開MCPエンドポイント。キーは不要です。上流への呼び出しはすべてサーバー独自のNORDIC_API_KEYに課金されます（フリーミアム／ディスカバリー）。IPごとにレート制限されます。
• ALL /mcp/auth — 認証付きMCPエンドポイント。すべてのリクエストにAuthorization: Bearer ndk_...が必要です。各呼び出しは、その顧客自身のキーと利用枠に課金されます。

どちらもMcp-Session-Idヘッダーを使ったセッションベースです。

リモートクライアントへの接続

このサーバーはOAuthではなく、静的APIキー認証を使用します。接続方法はクライアントによって異なります。

• ヘッダーに対応するクライアント（Claude Code、Cursor、Smithery、Claude.ai／ChatGPTのカスタムコネクター）：…/mcp/authを指定し、Authorization: Bearer ndk_...としてキーを渡します。各リクエストは独自のテナントと利用枠に課金されます。
• 「URL＋OAuth」のみを扱う汎用／自動検出クライアント：公開されている…/mcp（キー不要）を指定します。そうしない場合、こうしたクライアントはOAuth Dynamic Client Registration（POST /register）を試みて失敗します。このサーバーには設計上OAuthエンドポイントがなく、サインインフローではなく、明確なJSON形式のoauth_not_supportedエラーを返します。
• ローカルクライアント：stdioパッケージを使用してください。NORDIC_API_KEYを設定したうえで、npx -y nordic-data-mcpを実行します（上記のクイックスタートを参照）。

OAuth 2.1に完全対応し、任意の外部クライアントが独自のキーでセルフオンボーディングできるようにする機能は、Phase 2で予定されており、まだ実装されていません。

Railwayへのワンクリックデプロイ用に、railway.tomlが含まれています。

1. New Project → Deploy from GitHub repo → Mnymann/nordic-data-mcpを選択
2. Root Directoryをnordic-data-mcpに設定
3. 環境変数NORDIC_API_KEYを追加
4. Railwayが設定を自動検出してビルドし、公開HTTPS URLを提供します

---

設計上の注意

• 薄いアダプター。 ビジネスロジック、キャッシュ、変換処理はありません。各ツールは Nordic Data API のエンドポイントに 1 対 1 で対応します。
• ログに個人情報を含めません。 リクエスト本文とレスポンス本文はログに記録されません。
• API キーが必要です。 NORDIC_API_KEY が設定されていない場合、プロセスは起動を拒否します。
• レート制限。 バックエンドはキーごとのクォータを適用します。さらに、HTTP トランスポートは多層防御として、公開 /mcp エンドポイントに IP ごとの制限を適用します（PUBLIC_RATE_LIMIT / PUBLIC_RATE_WINDOW_MS で調整可能）。キャッシュは上流で処理されます。
• HTTP 呼び出しの前に、zod で入力を検証します。

---

コントリビューション

github.com/Mnymann/nordic-data-mcp への Issue と PR を歓迎します。

バグ報告には、API キー、リクエスト本文、レスポンスペイロードを含めないでください。

---

免責事項

Nordic Data は、公式情報源および公開情報源から集約した情報提供を目的とする意思決定支援を提供します。これは法律、コンプライアンス、金融、その他の専門的なアドバイスではなく、確定的な判断でもありません。KYB レポート、制裁対象者／PEP との一致、ネガティブメディアのヒット、リスクスコアは、判定ではなく、確認を要するシグナルです。独自に検証し、行動する前にご自身の専門的判断を適用してください。本サービスの利用には、AddonNordic の利用規約が適用されます。

---

ライセンス

MIT © AddonNordic ApS