要件

Node.js: 20.0.0 以上
Claude Code: CLI インストール済 (Max・Pro サブスクリプションまたは API キー)
SAP システム: ECC 6.0 · S/4HANA On-Premise · S/4HANA Cloud (Public・Private)、ADT 有効

MCP サーバー abap-mcp-adt-powerup は /sc4sap:setup の途中で自動的にインストール・設定されます。事前準備は不要です

インストール

sc4sap はまだ公式 Claude Code プラグインマーケットプレイスに登録されていません。当面はリポジトリをカスタムマーケットプレイスとして追加してから導入してください

推奨

カスタムマーケットプレイスとして追加

Claude Code セッション内で 2 行を順に実行します

/plugin marketplace add https://github.com/babamba2/superclaude-for-sap.git
/plugin install sc4sap

更新するとき

/plugin marketplace update babamba2/superclaude-for-sap
/plugin install sc4sap

代替

ソースからインストール

クローンしてビルドし、Claude Code で /plugin marketplace add <ローカルパス> によりそのディレクトリを指定します

git clone https://github.com/babamba2/superclaude-for-sap.git
cd superclaude-for-sap
npm install && npm run build

セットアップウィザード

ウィザードは 1 問ずつ尋ねます。既存の値があれば表示され、Enter でそのまま維持できます

/sc4sap:setup

01

システムと業種

S4 または ECC を選び、ABAP リリースを入力し、15 業種のメニューから選択します。この値が SPRO テーブル・BAPI・TCode と ABAP 構文ゲーティングを決めます

02

MCP サーバーのインストール

abap-mcp-adt-powerup を <PLUGIN_ROOT>/vendor/abap-mcp-adt/ にクローン・ビルドします。既にあればスキップします

03

プロファイル作成と接続

alias (KR-DEV 形式を推奨) と tier (DEV・QA・PRD) を決めたうえで、URL・クライアント・認証方式・アカウント・言語を 1 つずつ入力します。RFC バックエンドは soap · native · gateway · odata · zrfc から選択します

04

接続の検証

/mcp で再接続し、GetSession の往復、システム情報の確認、GetInactiveObjects による ADT 権限チェックまで行います。Claude Code の再起動は不要です

05

ABAP ユーティリティオブジェクトの作成

DEV プロファイルのみ。ZMCP_ADT_UTILS 関数グループと ZIF_S4SAP_CM・ZCL_S4SAP_CM_* ALV ハンドラを作成します。QA・PRD では拒否し、CTS 移送のガイドを出力します

06

権限フックのインストール required

この手順なしにセットアップは完了しません。block-forbidden-tables.mjs (行抽出ガード) と tier-readonly-guard.mjs (tier 変更ガード) を .claude/settings.json に登録し、双方のスモークテストを実行します

任意の手順

SPRO 設定の抽出。トークン消費は大きいものの、キャッシュが以降のトークン使用量を大幅に削減します
カスタマイズインベントリ。Z*・Y* の拡張とアペンド構造をスキャンします
HUD ステータス行。再起動後にアクティブプロファイルと tier、トークン使用量を表示します

サブコマンド

/sc4sap:setup                # 전체 위저드
/sc4sap:setup doctor         # 상태 점검으로 라우팅
/sc4sap:setup mcp            # MCP 설정으로 라우팅
/sc4sap:setup spro           # SPRO 설정 추출만
/sc4sap:setup customizations # Z*/Y* 인벤토리만

マルチプロファイル

~/.sc4sap · <project>/.sc4sap

~/.sc4sap/                      저장소 간 공유
└── profiles/
    ├── KR-DEV/  sap.env · config.json
    ├── KR-QA/   sap.env · config.json
    └── KR-PRD/  sap.env · config.json

<project>/.sc4sap/              프로젝트 범위
├── active-profile.txt        "KR-DEV"
└── work/
    ├── KR-DEV/  program · cbo · ...
    └── KR-PRD/  ...

1 つの Claude Code セッションで複数の SAP 接続を扱えます。接続 1 つがプロファイル 1 つで、プロジェクト側にはどれがアクティブかだけが記録されます

tier が読み取り専用の強制基準です QA・PRD プロファイルでは Create*・Update*・Delete* がフックと MCP サーバーの 2 層で遮断されます
tier は変更できません 変えるにはプロファイルを削除して作り直します
パスワードは OS キーチェーンに保存されます Windows 資格情報マネージャー・macOS キーチェーン・Linux libsecret。キーチェーンが使えない環境ではプロファイル env への平文にフォールバックし、警告を表示します

3 層防御

本番につなぐ前に最初に確認される部分です。文書ではなくコードで強制されます

L1a

行抽出ガード

Claude Code の PreToolUse フック。プロファイルの blocklistProfile を基準に、機微テーブルへの GetTableContents・GetSqlQuery を拒否します

L1b

tier 変更ガード

Claude Code の PreToolUse フック。呼び出しごとにアクティブプロファイルの SAP_TIER を読み直し、QA・PRD での変更を拒否します。状態を保持しません

L2

MCP サーバー内蔵ガード

迂回できない層です。フックが欠けていても設定が誤っていても、abap-mcp-adt-powerup 内部のガードは常に動作します

L1 フックは IO・パースエラー時にオープンで通し、L2 ガードは常時有効です。推奨の既定値は L1a が strict、MCP サーバーのブロックリストが standard です

セットアップ後

アクティブシステムの切替: /sc4sap:sap-option switch <alias>
会社や tier の追加: /sc4sap:sap-option add
プロファイル一覧: /sc4sap:sap-option list
ヘルスチェック: /sc4sap:sap-doctor
SPRO の再抽出: /sc4sap:setup spro

インストールガイド

要件