SAP HANA 経由で SAP S/4HANA を Meta Muse に接続（読み取り専用 SQL）

要点： SAP S/4HANA (HANA SQL) コネクタを使うと、Muse は S/4HANA システムを HANA データベースから直接読み取れます。クエリを書く前に、Muse は BUKRS、HSL、VBRK の意味を SAP 自身のデータディクショナリで調べるため、正しいテーブル、正しい通貨項目、正しいクライアントを選べます。セッションは HANA 側で読み取り専用に設定され、結果は最大 1,000 行で、すべてのステートメントにタイムアウトがあります。必要なのは、SAP Basis が用意する HANA データベースユーザーと、HANA の SQL ポートに到達できるセルフホストの AnythingMCP です。

汎用の SQL コネクタでは SAP に不十分な理由

SAP のテーブルと項目は、ドイツ語の短い略語です。ACDOCA はユニバーサルジャーナル、RBUKRS は会社コード、HSL は会社コード通貨の金額、VBRK は請求伝票ヘッダです。列名しか見えないモデルは推測に頼りますが、SAP では推測が通用しません。金額は別の列にある通貨項目とセットで意味を持ち、すべてのテーブルはクライアント（MANDT）ごとに分かれ、日付は YYYYMMDD 形式の文字列で、伝票番号には先行ゼロが付きます。

このコネクタは、SAP 自身のディクショナリをツールとして Muse に提供します。SAP が自らを記述するためのテーブル（DD02L、DD03L、DD04T、DD07T、DD08L と CDS アノテーション）を読み取るため、Muse は各項目の業務上の名称、各金額に対応する通貨項目や数量単位項目、項目のコード値の意味、テーブルの結合方法、そして SAP の CDS ビューのうちどれがリリース済みで分析用かを把握できます。そのうえで初めてクエリを書きます。

Muse がデータを見つける手順

質問できること

3 つの質問を最初から最後まで見ていきます。SQL は sap_guide のレシピに基づいています。クライアント 100、会社コード 1010、日付は自社の値に置き換えてください。Muse は、どの勘定を売上高とみなしたかなど、置いた前提を明示し、確認を求めます。

SELECT POPER, RHCUR AS CURRENCY, -SUM(HSL) AS REVENUE
FROM ACDOCA
WHERE RCLNT = '100' AND RLDNR = '0L' AND RBUKRS = '1010' AND GJAHR = '2025'
  AND RACCT BETWEEN '0040000000' AND '0049999999'  -- 売上高勘定：範囲を確認してください
GROUP BY POPER, RHCUR ORDER BY POPER;

SELECT KUNNR, RHCUR AS CURRENCY,
       SUM(HSL) AS OPEN_AMOUNT,
       SUM(CASE WHEN NETDT >= '20251231' THEN HSL ELSE 0 END) AS NOT_DUE,
       SUM(CASE WHEN NETDT < '20251231' AND NETDT >= '20251101' THEN HSL ELSE 0 END) AS OVERDUE_1_60,
       SUM(CASE WHEN NETDT < '20251101' THEN HSL ELSE 0 END) AS OVERDUE_OVER_60
FROM ACDOCA
WHERE RCLNT = '100' AND RLDNR = '0L' AND RBUKRS = '1010' AND KOART = 'D' AND POPER <> '000'
  AND BUDAT <= '20251231' AND (AUGDT = '00000000' OR AUGDT > '20251231')
GROUP BY KUNNR, RHCUR ORDER BY OVERDUE_OVER_60 DESC LIMIT 20;

SELECT k.KUNAG, c.NAME1, k.WAERK, SUM(p.NETWR) AS NET_SALES
FROM VBRK k JOIN VBRP p ON p.MANDT = k.MANDT AND p.VBELN = k.VBELN
LEFT JOIN KNA1 c ON c.MANDT = k.MANDT AND c.KUNNR = k.KUNAG
WHERE k.MANDT = '100' AND k.FKDAT BETWEEN '20250101' AND '20251231'
  AND k.FKSTO = '' AND k.VBTYP = 'M'
GROUP BY k.KUNAG, c.NAME1, k.WAERK ORDER BY NET_SALES DESC LIMIT 10;

HANA SQL と OData のどちらを使うか

AnythingMCP は 2 つの方法で S/4HANA オンプレミスと Private Cloud に接続します。どちらか一方を選ぶことも、両方を並行して使うこともできます。

必要なもの

• SAP Basis 管理者：ABAP スキーマ（通常は SAPHANADB または SAPABAP1）を持つテナントデータベースに、ユーザーを作成できる人。
• 接続情報：ホスト、テナントの SQL ポート（最初のテナントは 3<instance>15、以降のテナントは 3<instance>41 以上）、テナント名、スキーマ、3 桁の SAP クライアント、テキスト用の SAP 言語（E 英語、D ドイツ語）。
• セルフホストの AnythingMCP：そのポートに到達できること。HANA の SQL ポートは通常、社内ネットワークまたは SAP のプライベートクラウドのランディングゾーン内からしかアクセスできません。
• ライセンスの確認：サードパーティのアプリケーションから ABAP スキーマへ直接 SQL アクセスできるかどうかは、SAP HANA のライセンスによって決まります。S/4HANA に付属するランタイムライセンスでは通常認められず、フルユースライセンスなら認められます。本番システムを接続する前に、SAP の担当営業チームに確認してください。SAP のプライベートクラウドのサービスでは、データベースユーザーとネットワーク経路を SAP に申請します。

セットアップ

ステップ 1：読み取り専用のデータベースユーザーを作成する

ABAP スキーマを持つテナントで次を実行します：

CREATE USER AMCP_READER PASSWORD "<strong password>" NO FORCE_FIRST_PASSWORD_CHANGE;
ALTER USER AMCP_READER DISABLE PASSWORD LIFETIME;

-- ディクショナリ用ツール
GRANT SELECT ON SAPHANADB.DD02L TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DD02T TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DD03L TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DD03T TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DD03ND TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DD04T TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DD07T TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DD08L TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DD05S TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DDHEADANNO TO AMCP_READER;
GRANT SELECT ON SAPHANADB.DDFIELDANNO TO AMCP_READER;
GRANT SELECT ON SAPHANADB.ARS_W_API_STATE TO AMCP_READER;
-- 組織構造
GRANT SELECT ON SAPHANADB.T001 TO AMCP_READER;
GRANT SELECT ON SAPHANADB.T001K TO AMCP_READER;
GRANT SELECT ON SAPHANADB.T001W TO AMCP_READER;
GRANT SELECT ON SAPHANADB.TKA01 TO AMCP_READER;
GRANT SELECT ON SAPHANADB.TVKO TO AMCP_READER;
GRANT SELECT ON SAPHANADB.TVKOT TO AMCP_READER;
GRANT SELECT ON SAPHANADB.T024E TO AMCP_READER;
-- 続いて、用途に必要な業務テーブルと CDS ビュー（例）
GRANT SELECT ON SAPHANADB.ACDOCA TO AMCP_READER;

幅広い分析には GRANT SELECT ON SCHEMA SAPHANADB のほうが簡単ですが、その場合は人事データを含め、スキーマ内のすべてが読み取り可能になります。SQL では SAP のアプリケーション権限（会社コード、販売組織、人事のチェック）は適用されません。データベースユーザーが読めるものは、Muse も読めます。

必要に応じて、このユーザーのステートメントをサーバー側でも制限できます：

CREATE WORKLOAD CLASS "AMCP_READER_WC" SET 'STATEMENT TIMEOUT' = '60', 'STATEMENT MEMORY LIMIT' = '20';
CREATE WORKLOAD MAPPING "AMCP_READER_WM" WORKLOAD CLASS "AMCP_READER_WC" SET 'USER NAME' = 'AMCP_READER';

ステップ 2：ネットワーク内で AnythingMCP を動かす

HANA の SQL ポートに到達できるホストで次を実行します：

mkdir anythingmcp && cd anythingmcp
curl -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d   # → http://localhost:3000

.env の SSRF_ALLOWED_HOSTS に HANA ホストを追加してください。AnythingMCP は既定でプライベートアドレスへの接続を拒否します。

ステップ 3：コネクタをインストールする

Connectors → Marketplace を開き、S/4HANA で検索して SAP S/4HANA (HANA SQL) をインストールします：

anythingmcp.internal/connectors/store

続いて変数を入力します。接続先アドレスを構成する変数は、コネクタを作成する前に入力が必須です：

anythingmcp.internal/connectors/store

インストール時にテスト呼び出し（sap_org_structure）を 1 回行い、認証情報と権限付与が機能するかどうかを知らせます。パスワードは暗号化して保存され、Muse に示されることはありません。

anythingmcp.internal/connectors

ステップ 4：MCP サーバーを Muse に追加する

Muse で Settings → Connectors を開き、Add custom connector を選んで MCP サーバーの URL（AnythingMCP の MCP Servers に表示されます）を貼り付け、Muse に求められたら AnythingMCP にサインインします。Muse は Meta のクラウドから接続するため、URL は公開された HTTPS である必要があります。公開するのは MCP エンドポイントだけで、HANA のポートを公開することはありません。

ステップ 5：質問する

まずはデータの範囲を絞る質問から始めましょう。たとえば「このシステムにはどの会社コードがあり、通貨は何ですか？」です。コネクタは Muse に最初に sap_guide を読むよう指示し、その後は Muse が自らディクショナリ用ツールを使って進めます。

利用可能なツール

anythingmcp.internal/connectors

コネクタが強制すること

SAP のネイティブドライバを使う

AnythingMCP には、SAP の純 JavaScript 製 HANA ドライバ hdb（Apache-2.0）が同梱されています。ユーザーとパスワード、TLS、マルチテナントシステムなど、コネクタが行うすべてに対応します。SAP のネイティブドライバ @sap/hana-client を使うと、Kerberos、セキュアユーザーストア（hdbuserstore）、コネクションプーリングも利用できます。これは SAP Developer License で公開されており、当社による再配布が認められていないため、イメージには一切含まれません。イメージを拡張するか、ボリュームとしてマウントして自分のデプロイ環境にインストールし、接続文字列の driver=hana-client、またはすべての HANA コネクタに適用する HANA_DRIVER=hana-client で選択します。本番環境での使用が SAP との契約でカバーされているか確認してください。arm64 ホストでは、同梱の hdb ドライバを使い続けるか、Debian ベースのイメージを自分でビルドしてください。詳しい手順：AnythingMCP ドキュメントの SAP HANA。

プロンプト例

• 「2025 年の会社コード 1010 の転記期間別売上高を表示してください。」
• 「30 日を超えて未決済の売掛金がある得意先はどこで、得意先ごとの金額はいくらですか？」
• 「今年の純売上高上位 10 社の得意先を、請求伝票から出してください。」
• 「仕訳を扱うリリース済みの分析用 CDS ビューはどれですか？ 最初のビューのメジャーを説明してください。」
• 「請求伝票カテゴリ項目の値は、それぞれ何を意味しますか？」
• 「先月のプラント 1010 における移動タイプ別の在庫移動。」

トラブルシューティング

• CDS ビューが行を返さない。 SAP_CLIENT が未設定か誤っています。コネクタは CDS_CLIENT を設定するためにこの値を必要とします。
• 接続が拒否される、または不明なホストにリダイレクトされる。 システムデータベースのポートではなく、テナント自身の SQL ポートを使ってください。システムデータベースのポートは、コネクタが名前解決できない内部ホスト名にリダイレクトすることがあります。
• 「Insufficient privilege」。 そのテーブルがデータベースユーザーに付与されていません。権限を付与するか、読み取り可能なテーブルまたは CDS ビューを使うよう Muse に依頼してください。
• 証明書エラー。 自己署名証明書の場合は SAP_HANA_TLS=no-verify を使うか、CA をインストールしてください。
• クエリがタイムアウトする。 会社コード、期間、プラントで絞り込み、SQL で集計するよう Muse に依頼してください。statementTimeout を引き上げるのは、クエリが本当に大きい場合だけにしてください。

FAQ

このコネクタを通じて Muse が SAP のデータを変更することはできますか？ いいえ。HANA のセッションは読み取り専用で、実行されるのは SELECT 1 文だけです。書き込みとロックを伴う読み取りは拒否されます。データベースユーザーには SELECT 権限だけを付与し、HANA 側でも同じルールが適用されるようにしてください。

SAP の権限は尊重されますか？ いいえ。SQL は SAP のアプリケーション権限を経由しないため、Muse が読めるものはデータベースの権限付与で決まります。SAP の権限チェックが必要な場合は、代わりに OData ルートを使うか、読まれても問題のないテーブルとビューだけを付与してください。

S/4HANA への直接 SQL アクセスは SAP のライセンスで認められていますか？ HANA のライセンスによります。S/4HANA に付属するランタイムライセンスでは、サードパーティによる ABAP スキーマへの SQL アクセスは通常認められず、フルユースライセンスなら認められます。本番環境を接続する前に契約を確認してください。

S/4HANA Private Cloud（RISE）でも使えますか？ はい。SAP がデータベースユーザーと HANA の SQL ポートへのネットワーク経路を用意し、そのポートに到達できる場所で AnythingMCP を動かせば使えます。どちらも SAP に申請してください。

セルフホストの代わりに AnythingMCP Cloud を使えますか？ HANA の SQL ポートにインターネットから到達できる場合に限ります。そうした構成はまれで、推奨されることもほとんどありません。AnythingMCP は SAP のそばでセルフホストしてください。

ChatGPT や Copilot でも使えますか？ はい。同じ MCP サーバーが ChatGPT（開発者モード、有料プラン）、GitHub Copilot、Cursor、Claude、Claude Code で、同じツールと同じ読み取り専用の制限のまま動作します。

SAP BTP や SAP Joule は必要ですか？ いいえ。コネクタは HANA データベースと直接通信するため、BTP も Joule も SAP Gateway も必要ありません。両方を使う場合は、Joule と並行して動かすこともできます。

自分で運用できる SAP HANA MCP サーバーですか？ はい。AnythingMCP はオープンソース（AGPL-3.0）で、SAP のそばで Docker Compose により動作します。sap-hana-mcp-server リポジトリはこのコネクタを単体でパッケージしたもので、SAP HANA MCP サーバーでは開発者向けに解説しています。

Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。

Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。

次のステップ

• SAP HANA MCP サーバー：同じコネクタを開発者の視点で解説
• OData を MCP に：SAP の権限チェック付きで S/4HANA オンプレミスに接続する、もう 1 つの方法
• SAP を Meta Muse に接続：すべての SAP コネクタの一覧
• データベースを MCP に：SQL Server、PostgreSQL、Oracle と並ぶ、通常のデータベースコネクタとしての SAP HANA
• GitHub の SAP HANA ドキュメント：接続文字列のオプションとネイティブドライバ
• 接続: Claude
• 接続: Cursor
• 接続: Gemini