MCP 経由で SAP S/4HANA (OData) を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → SAP S/4HANA (OData) をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

SAP S/4HANA OData + Gemini

AI に SAP S/4HANA（オンプレミスまたは Private Cloud）を OData サービス経由で読み取らせます。SAP Gateway のカタログからサービスを探し、各項目を SAP の名称付きで読み、仕訳明細、請求伝票、受注、取引先、在庫、製品を照会できます。読み取り専用で、SAP の技術ユーザーを使います。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

SAP_ODATA_BASE_URL, SAP_CLIENT, SAP_LANGUAGE, SAP_ODATA_USER, SAP_ODATA_PASSWORD

ステップ 1 — 認証情報を取得

1. トランザクション SU01 で、AI に読ませるクライアントにタイプ System（Dialog ではなく）の技術ユーザーを作成し、本番用パスワードを設定します。
2. そのユーザーに、AI が使ってよい OData サービスの S_SERVICE と表示のみの業務権限（アクティビティ 03）を含むロール（PFCG）を付与します。AI にカタログを参照させるには、V2 のカタログサービス /IWFND/CATALOGSERVICE と V4 のサービスカタログも許可します。
3. サービスが有効になっているか確認します。V2 は /IWFND/MAINT_SERVICE、V4 は /IWFND/V4_ADMIN です。既製ツールは SAP のリリース済み API API_JOURNALENTRYITEMBASIC_SRV、API_BILLING_DOCUMENT_SRV、API_SALES_ORDER_SRV、API_BUSINESS_PARTNER、API_MATERIAL_STOCK_SRV、API_PRODUCT_SRV を使います。
4. SAP_ODATA_BASE_URL に Gateway のホストを HTTPS ポート付き、パスなしで設定します（例: https://s4.example.com:44300）。SAP_CLIENT には 3 桁のクライアント（例: 100）、SAP_LANGUAGE にはログオン言語（例: JA。項目の名称はこの言語で返ります）、SAP_ODATA_USER と SAP_ODATA_PASSWORD には技術ユーザーの名前とパスワードを入れます。
5. コネクタをインストールします。Authorize with Provider の手順はありません。コネクタは技術ユーザーとして Basic 認証でサインインし、呼び出しのたびにクライアントと言語を送ります。
6. まず s4_guide を呼び出し（費用はかからず、SAP にはアクセスしません）、次に billing のような業務用語で s4_list_services を呼び出して、ユーザーがカタログに届くか確認します。

ネットワーク: Gateway の HTTPS ポートは、通常は社内ネットワークからしか届きません。AnythingMCP をそのネットワーク内でセルフホストするか VPN 経由で接続し、Gateway のホストを SSRF_ALLOWED_HOSTS に追加してください。追加しないと AnythingMCP はプライベートアドレスを拒否します。AnythingMCP Cloud は、Gateway にインターネットから到達できる場合にのみ使えます。

AI がデータを見つける流れ: s4_list_services は SAP のカタログ（V2 と V4）を業務用語で検索し、s4_describe_service はサービスのエンティティセットを一覧にして分析用とパラメータ付きのものに印を付けます。s4_describe_entity は各項目を SAP の名称、各金額の通貨または単位の項目、セットが必須とする絞り込みとともに返し、s4_query と s4_get_entity が行を読み取ります。項目名は呼び出しの前にサービスの $metadata と照合されます。よくある用途には、s4_journal_entry_items、s4_billing_documents、s4_sales_orders、s4_business_partners、s4_material_stock、s4_products がリリース済み API を filter、select、orderby、top、skip 付きで直接呼び出します。カタログ用のツールは SAP Gateway を備えた ECC や BW でも使えますが、既製ツールには S/4HANA が必要です。

権限と読み取り専用の構成: 12 個のツールはすべて読み取りのみです。SAP は呼び出しのたびに技術ユーザーの権限をチェックするので、これが本当の境界になります。ロールには表示権限だけを、AI に見せてよい会社コード、販売組織、プラントに限って付与してください。さらに絞り込むには、コネクタの OData 設定の Allowed services に AI が呼び出してよいサービスパスを列挙します（* はワイルドカード）。それ以外のサービスは拒否されます。個々のツールはコネクタのページで無効にできます。

SAP の API ポリシー: SAP は、サードパーティの統合に公開 API（SAP Business Accelerator Hub 上の API_* サービス）か自社で構築したサービスを使うことを求めています。Fiori アプリの裏にある内部サービスよりもこれらを優先し、Allowed services もそれに合わせて設定してください。

Basic 認証または OAuth: コネクタは Basic 認証でインストールされます。Gateway が OAuth 2.0 に対応するよう設定されていれば、コネクタのページで認証を OAuth 2.0 に切り替えられます。

制限: 1 回の照会で返るのは最大 1,000 行で、既製ツールの既定値は 100 行（top）です。合計を出すときは、すべてをページ送りで読むのではなく、AI が分析用サービスで集計するか、会社コード、販売組織またはプラントと、日付または会計期間で絞り込みます。金額は通貨と、数量は単位とともに返り、小数は正確さを保つため文字列で返ります。

よくあるエラー: 401 はユーザー名かパスワードの誤り、またはそのクライアントでユーザーがロックされていることを示します。サービスに対する 403 Forbidden は技術ユーザーにその権限（S_SERVICE または業務ロール）がないこと、404 はそのサービスがこのシステムで有効になっていないことを意味します。プライベートアドレスが拒否される場合は、ホストが SSRF_ALLOWED_HOSTS にありません。行がデモデータのように見える場合は、SAP_CLIENT が別のクライアントを指しています。

HANA SQL を選ぶ場合: SAP のアプリケーション権限ではなく読み取り専用のデータベースユーザーで、S/4HANA のテーブルと CDS ビューを SQL で直接読ませたいなら、SAP S/4HANA (HANA SQL) コネクタを使ってください。その他の OData V2 や V4 のサービスには、OData コネクタタイプを参照してください。

このコネクタは SAP に書き込みません。転記は行わず、受注、伝票、マスタデータの作成や変更もしません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が SAP S/4HANA OData のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「当社の SAP カタログで請求伝票を扱う OData サービスはどれで、そのうちリリース済み API はどれですか。」
• 「請求伝票から、先月の販売組織ごとの正味請求売上を、取消済みの伝票を除いて通貨付きで見せてください。」
• 「プラント 1000 にある品目 FG-100 の在庫は、保管場所ごとにどれだけありますか。」
• 「先月、会社コード 1000 で転記された仕訳明細のうち金額の大きい 20 件を、G/L 勘定、金額、通貨とともに一覧にしてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続