NDB OpenData Hub自然言語アクセスガイド

自然言語アクセスガイド（5つの接続方法）

NDB OpenData Hub には claude.ai・Claude Desktop・Claude Code・ChatGPT Actions・ChatGPT Apps の 5 つの接続方法があります。 どの方法でも同じ読み取り専用データベースへアクセスできます。簡単な順に並べていますので、用途や環境に合わせて選んでください。

Option 1

最も簡単

claude.ai（Connectors）

claude.ai の Connectors 機能を使えば、ブラウザだけで NDB OpenData Hub に接続できます。インストール不要、設定ファイル編集不要の最短ルートです。

セットアップ手順

  1. claude.ai にログインし、右下のプロフィールアイコンから Settings を開く。
  2. Connectors タブを選択し、Add Connector をクリック。
  3. URL に以下を入力して保存。
https://ndbopendata-hub.com/api/mcp

使い方

  1. 新しいチャットを開き、自然文で質問（例：「宮城県でBMIが高い年代は？」）。
  2. claude.ai が NDB OpenData Hub のツールを自動で呼び出し、データを取得して回答します。
  3. 追加の質問や深掘りもそのまま会話を続けるだけ。

Option 2

Claude Desktop（Connectors）

Claude Desktop は Streamable HTTP に対応しており、ブリッジなしで直接接続できます。Settings の Connectors UI から URL を登録するだけで完了です。

セットアップ手順

  1. Claude Desktop を最新版にアップデート。
  2. メニューから Settings > Connectors を開く。
  3. Add Connector をクリックし、以下の URL を入力して保存。
  4. アプリを再起動し、ツール一覧に NDB 関連ツールが表示されることを確認。
https://ndbopendata-hub.com/api/mcp

JSON 設定ファイルで登録する場合

Connectors UI を使わず設定ファイルを直接編集する場合は以下を追記してください。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ndb-opendata-hub": {
      "url": "https://ndbopendata-hub.com/api/mcp"
    }
  }
}

保存後、Claude Desktop を完全終了→再起動してください。

Option 3

Claude Code（CLI）

ターミナルから Claude Code CLI を使って MCP サーバーを追加する方法です。開発者やコマンドライン操作に慣れた方向けです。

セットアップ手順

  1. Claude Code がインストール済みであることを確認。
  2. ターミナルで以下のコマンドを実行。
  3. Claude Code を再起動すると NDB 関連ツールが利用可能になります。
claude mcp add ndb --transport http https://ndbopendata-hub.com/api/mcp

使い方

Claude Code のチャットで自然文の質問をすると、NDB OpenData Hub のツールを自動で呼び出してデータを取得します。

登録済みの MCP サーバーを確認:

claude mcp list

Option 4

ChatGPT Actions（OpenAPI）

ChatGPT 上で OpenAPI スキーマを用いた Actions として利用できます。最短手順は共有 GPT を使う方法、細かくカスタマイズする場合は OpenAPI URL を直接登録してください。

最短で試す（共有GPT）

  1. NDB OpenData Hub GPT を開き、「使用する」をクリック。
  2. チャット内で「空腹時血糖が高い地域を教えて」など自然文で質問。
  3. 実行ログで OpenAPI 呼び出しが成功しているか確認（失敗時はパラメータ説明を参照）。

手動で Actions を登録する

  1. ChatGPT サイドバーの Actions 設定を開き、「新しいスキーマを追加」。
  2. スキーマ URL に https://ndbopendata-hub.com/mcp/openapi を入力し保存。
  3. 必要に応じてパラメータ補足や利用例をカスタムプロンプトに追記。

マニフェスト最小例

{
  "schema_url": "https://ndbopendata-hub.com/mcp/openapi"
}

OpenAPI の仕様詳細と最新スキーマは /mcp/openapi でいつでも参照できます。Actions 側でパラメータの扱いに迷った場合は、スキーマ内の説明と meta.hint をご確認ください。

Option 5

ChatGPT Apps（MCP）

ChatGPT の Apps 機能を使って MCP サーバーとして直接接続する方法です。ブラウザ版 ChatGPT で利用でき、Developer Mode やワークスペース管理者の許可が前提となります。

ChatGPT Apps（MCP）は変更が多い機能です。安定した運用が必要な場合は、同じ API を利用できる ChatGPT Actions（OpenAPI） を優先してください。

セットアップ手順

  1. ChatGPT 右上のアイコン > Settings > Developer を開き、Developer Mode を有効化（Plus / Pro）。ワークスペース利用の場合は管理者に Apps の許可を依頼。
  2. Developer settings > Apps に移動し、New App を選択。MCP タイプを選び URL を登録。
  3. 作成したアプリを有効化し、新しいチャットで「NDB OpenData Hub を使って」と話しかける。

設定スニペット

Apps の設定画面で表示される JSON を編集する場合の参考値です。

{
  "name": "NDB OpenData Hub",
  "description": "厚生労働省NDB特定健診データ（読み取り専用）",
  "type": "mcp",
  "server_url": "https://ndbopendata-hub.com/api/mcp"
}

Apps でも Actions と同じ MCP ツール群を利用します。利用時に API から戻るエラーがある場合は、パラメータの URL エンコードを確認し、必要に応じて複数指定（&value_range=...）を活用してください。

自然言語問い合わせのコツ

どのクライアントでも、まずは /api/mcp/inspection-range-labels や /api/mcp/questionnaire-answer-values で利用可能なラベルを取得し、続けて対象データを絞ると安定して結果が得られます。 特定の値が 0 件になる場合は、まず広めの条件で分布を確認してから該当ラベルを探すとエラーを回避できます。

問い合わせテンプレート例

  • 「特定健診BMIで、青森県・男性・40-44歳の 40.0 以上の件数を確認して。」
  • 「宮城県で 18.5 以上 20.0 未満の BMI が多い年代を比較したい。」
  • 「HbA1c の高値人数トップ5の都道府県を出して。」

結果が出ないときは

  • まず範囲ラベル一覧を取得し、存在する表記か確認。
  • 複数ラベルを指定する場合は &value_range=正常&value_range=要注意 のように繰り返し形式を使う。
  • HTTP 400/500 エラー時はレスポンス本文のメッセージをクライアントに表示し、再質問時に修正。

Support

お問い合わせ・フィードバック

公開リポジトリとメール窓口の 2 経路を用意しています。小規模な実験運用のため即時対応や実装のお約束はできませんが、寄せられたご意見は優先度を検討しながら改善計画に反映します。GitHub アカウントをお持ちの場合は Issue 作成をご利用ください。スパム対策のため自動公開は行わず、内容を確認したうえで順次対応します。

技術的な質問・不具合報告

  • GitHub Issue を作成してください。
  • テンプレートに沿って 再現手順 / 期待する結果 / 取得したレスポンス を記載ください。
  • 送信後はメンテナチームが内容を確認し、公開可否を判断してから返信します。対応可否は状況を見ながら検討します。

お問い合わせメール

GitHub を利用できない場合は、以下のアドレス宛にご連絡ください。

toms_pjt-ndbopendata@yahoo.co.jp

件名に [NDB Hub] を含めていただけると仕分けがスムーズです。頂いた内容は改善候補として整理し、対応状況に応じて個別にご連絡します。

オープンな議論が必要な場合は GitHub Discussions の開設も検討中です。短期的には Issue / メールでいただいた内容を整理し、対応可否を明示したうえで FAQ として本ページに反映していきます。

トラブルシュート

  • ツールが表示されない: クライアントを再起動。Claude の場合は Connectors 設定の URL を確認。
  • 接続エラー: プロキシやファイアウォールで https://ndbopendata-hub.com が許可されているか確認。
  • Actions で 0 件になる: value_range の繰り返し指定、URL エンコード(126%E4%BB%A5%E4%B8%8A) を確認。
  • 最新スキーマを再取得: /mcp/openapi を再読み込みし、必要なら ChatGPT でスキーマ更新を実行。