SAP S/4HANA ODataとMicrosoft CopilotをMCP接続

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

SAP S/4HANA OData + Microsoft Copilot

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 — Microsoft Copilot にコネクタを追加

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

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。SAP S/4HANA OData のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

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

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

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