SC4SAP MCP Setup
Guides you through installing and configuring the abap-mcp-adt-powerup MCP server, which provides Claude Code with direct connectivity to your SAP system via ABAP Development Tools (ADT) REST APIs. The server exposes 150+ tools covering CRUD for ABAP objects (class, program, CDS, FM, table, etc.) plus runtime, transport, and data-preview operations.
- Node.js 18+ installed
- Access to a SAP system with ADT service enabled (transaction SICF, service
/sap/bc/adt active)
- SAP user with developer authorizations (S_DEVELOP, S_TRANSPRT)
- Claude Code with MCP support
Configure SAP connection (multi-profile)
Connection settings live in a per-system profile, not in a hand-written file:
~/.sc4sap/profiles/<alias>/sap.env — MCP-server env (SAP_URL, SAP_CLIENT, SAP_AUTH_TYPE, SAP_USERNAME, SAP_LANGUAGE, SAP_SYSTEM_TYPE = s4hana | cloud | ecc, SAP_TIER, blocklist keys). The password is stored in the OS keychain and referenced as SAP_PASSWORD=keychain:sc4sap/<alias>/<user>.<project>/.sc4sap/active-profile.txt — alias of the active profile.
Create a profile with /sc4sap:setup (wizard Step 4) or /sc4sap:sap-option add; edit it with /sc4sap:sap-option. Do not hand-write sap.env. Key reference and validation rules: ../sap-option/SKILL.md → <Managed_Keys> / <Validation>. Blocklist keys (MCP_BLOCKLIST_PROFILE = minimal | standard (default) | strict | off, MCP_BLOCKLIST_EXTEND, MCP_ALLOW_TABLE) are documented in ../sap-option/SKILL.md → <Managed_Keys> (policy: ../../common/data-extraction-policy.md).
The bridge resolves the active profile on startup. Process environment variables take precedence over file values.
Verify the connection
After restarting Claude Code (or reconnecting MCP via /mcp), run:
/sc4sap:sap-doctor
Or manually test by calling GetSession — it should return your SAP system ID, client, and username.
Update the MCP server
To update to the latest version:
node scripts/build-mcp-server.mjs --update
Execution:
- Resolve plugin root (from
CLAUDE_PLUGIN_ROOT env; fallback to cache path ~/.claude/plugins/cache/sc4sap/sc4sap/<version>/).
- Run:
node "<plugin>/scripts/build-mcp-server.mjs" --check
- Read the script's exit code and stdout/stderr.
- Format the result for the user:
| Exit |
Meaning |
User message (follow conversation language) |
0 + pinned to <SHA> ✓ on stdout |
OK — vendor matches expected pin |
✅ abap-mcp-adt vendor verified · pinned to <SHA> (truncate to first 12 chars) |
0 + pin cannot be verified on stderr |
WARN — launcher OK, .git stripped (packaged cache install) |
⚠️ Vendor launcher present, but pin cannot be verified (packaged cache lacks .git). Expected pin: <SHA>. To force a verifiable reinstall: node scripts/build-mcp-server.mjs --update. |
| 1 |
FAIL — vendor missing |
❌ abap-mcp-adt not installed. Run: node scripts/build-mcp-server.mjs (or /sc4sap:setup mcp). |
| 2 |
FAIL — pin drift |
❌ abap-mcp-adt vendor drift detected (current HEAD ≠ pinned SHA). Run: node scripts/build-mcp-server.mjs --update. |
Output format (single block):
MCP Vendor Health Check
=======================
Status: <OK|WARN|FAIL>
Pin: <expected SHA>
Current: <current HEAD or "unverified" or "not installed">
Action: <user message from table above>
STOP after printing — do not fall through to the full installation guide.
Task: {{ARGUMENTS}}
1---2name: sc4sap-mcp-setup3description: Guide to install and configure the abap-mcp-adt-powerup MCP server for SAP ADT connectivity4---56# SC4SAP MCP Setup78Guides you through installing and configuring the `abap-mcp-adt-powerup` MCP server, which provides Claude Code with direct connectivity to your SAP system via ABAP Development Tools (ADT) REST APIs. The server exposes 150+ tools covering CRUD for ABAP objects (class, program, CDS, FM, table, etc.) plus runtime, transport, and data-preview operations.91011<Purpose>12`abap-mcp-adt-powerup` is the bridge between Claude Code and your SAP system. Without it, no SC4SAP skills can read or write ABAP objects. This skill walks you through cloning, configuring, and registering the server so all MCP tools become available.13</Purpose>1415<Response_Prefix>16Every response triggered by this skill MUST begin with `[Model: <main-model> · Dispatched: <sub-summary>]` per [`../../common/model-routing-rule.md`](../../common/model-routing-rule.md) § Response Prefix Convention.17</Response_Prefix>1819<Source>20MCP server repository: https://github.com/babamba2/abap-mcp-adt-powerup.git21Installed at: `${CLAUDE_PLUGIN_ROOT}/vendor/abap-mcp-adt/` (internal directory name kept short for path-length safety on Windows).22</Source>2324<Prerequisites>25- Node.js 18+ installed26- Access to a SAP system with ADT service enabled (transaction SICF, service `/sap/bc/adt` active)27- SAP user with developer authorizations (S_DEVELOP, S_TRANSPRT)28- Claude Code with MCP support29</Prerequisites>3031<Installation_Steps>321. **Automatic installation (recommended)**33 The MCP server is automatically installed into the plugin's `vendor/abap-mcp-adt/` directory during setup:34 ```bash35 /sc4sap:setup # full setup wizard (includes MCP install)36 /sc4sap:setup mcp # MCP install only37 ```38 Or via npm:39 ```bash40 npm run build # runs tsc + installs abap-mcp-adt into vendor/41 ```42 This clones the repo, runs `npm install`, and builds it. The plugin's `.mcp.json` is pre-configured to launch `bridge/mcp-server.cjs`, which delegates to the vendor-installed server.43442. **Configure SAP connection (multi-profile)**45 Connection settings live in a per-system profile, not in a hand-written file:46 - `~/.sc4sap/profiles/<alias>/sap.env` — MCP-server env (`SAP_URL`, `SAP_CLIENT`, `SAP_AUTH_TYPE`, `SAP_USERNAME`, `SAP_LANGUAGE`, `SAP_SYSTEM_TYPE` = `s4hana` | `cloud` | `ecc`, `SAP_TIER`, blocklist keys). The password is stored in the OS keychain and referenced as `SAP_PASSWORD=keychain:sc4sap/<alias>/<user>`.47 - `<project>/.sc4sap/active-profile.txt` — alias of the active profile.4849 Create a profile with `/sc4sap:setup` (wizard Step 4) or `/sc4sap:sap-option add`; edit it with `/sc4sap:sap-option`. Do not hand-write `sap.env`. Key reference and validation rules: `../sap-option/SKILL.md` → `<Managed_Keys>` / `<Validation>`. Blocklist keys (`MCP_BLOCKLIST_PROFILE` = `minimal` | `standard` (default) | `strict` | `off`, `MCP_BLOCKLIST_EXTEND`, `MCP_ALLOW_TABLE`) are documented in `../sap-option/SKILL.md` → `<Managed_Keys>` (policy: `../../common/data-extraction-policy.md`).5051 The bridge resolves the active profile on startup. Process environment variables take precedence over file values.52533. **Verify the connection**54 After restarting Claude Code (or reconnecting MCP via `/mcp`), run:55 ```56 /sc4sap:sap-doctor57 ```58 Or manually test by calling `GetSession` — it should return your SAP system ID, client, and username.59604. **Update the MCP server**61 To update to the latest version:62 ```bash63 node scripts/build-mcp-server.mjs --update64 ```65</Installation_Steps>6667<Troubleshooting>68- **401 Unauthorized**: Check `SAP_USERNAME` / the keychain password of the active profile (`/sc4sap:sap-option`); confirm the user is not locked (SU01).69- **Connection refused**: Verify `SAP_URL` host and ICM HTTPS port; check VPN if required.70- **ADT service not found**: Activate `/sap/bc/adt` in transaction SICF and ensure ICF is running.71- **SSL certificate errors**: Add the SAP system certificate to Node.js trust store (recommended), or temporarily set `TLS_REJECT_UNAUTHORIZED=0` in the profile `sap.env` (dev only — never in prod).72- **No tools visible in Claude Code**: Reconnect the MCP server via `/mcp` after editing `sap.env`. `sap.env` changes are NOT hot-reloaded. Check MCP server stderr logs under `%LOCALAPPDATA%\claude-cli-nodejs\Cache\<cwd-slug>\mcp-logs-plugin-sc4sap-sap\`.73- **Blocklist refusal on a legitimate table**: Run `/sc4sap:sap-option` to adjust `MCP_BLOCKLIST_PROFILE` or add the table to `MCP_ALLOW_TABLE` (audited bypass).74- **`vendor/abap-mcp-adt` not built**: Re-run `node scripts/build-mcp-server.mjs` (or `--update` to refresh).75</Troubleshooting>7677<Security_Notes>78- Never commit a `sap.env` (profile or legacy `.sc4sap/sap.env`) to version control. Profiles live under `~/.sc4sap/profiles/`, outside the repository.79- Use process-level environment variables to override `sap.env` values in CI/CD, so secrets never touch disk.80- Prefer a read-only SAP user for analysis-only workflows.81- `TLS_REJECT_UNAUTHORIZED=0` is **dev-only** — never set in production. Install the SAP system certificate into Node.js trust store instead.82- The MCP server communicates only with the SAP host in `SAP_URL`. No outbound calls to third parties.83- Row-extraction on sensitive tables is gated by the blocklist policy above (`MCP_BLOCKLIST_PROFILE`, `MCP_BLOCKLIST_EXTEND`, `MCP_ALLOW_TABLE`). See `common/data-extraction-policy.md`.84</Security_Notes>8586<Health_Check>87When `ARGUMENTS` is `check` / `verify` / `status` (case-insensitive), run the vendor pin health check inline and report — do not print the full installation guide.8889**Execution**:901. Resolve plugin root (from `CLAUDE_PLUGIN_ROOT` env; fallback to cache path `~/.claude/plugins/cache/sc4sap/sc4sap/<version>/`).912. Run: `node "<plugin>/scripts/build-mcp-server.mjs" --check`923. Read the script's exit code and stdout/stderr.934. Format the result for the user:9495| Exit | Meaning | User message (follow conversation language) |96|---|---|---|97| **0** + `pinned to <SHA> ✓` on stdout | OK — vendor matches expected pin | ✅ abap-mcp-adt vendor verified · pinned to `<SHA>` (truncate to first 12 chars) |98| **0** + `pin cannot be verified` on stderr | WARN — launcher OK, `.git` stripped (packaged cache install) | ⚠️ Vendor launcher present, but pin cannot be verified (packaged cache lacks `.git`). Expected pin: `<SHA>`. To force a verifiable reinstall: `node scripts/build-mcp-server.mjs --update`. |99| **1** | FAIL — vendor missing | ❌ abap-mcp-adt not installed. Run: `node scripts/build-mcp-server.mjs` (or `/sc4sap:setup mcp`). |100| **2** | FAIL — pin drift | ❌ abap-mcp-adt vendor drift detected (current HEAD ≠ pinned SHA). Run: `node scripts/build-mcp-server.mjs --update`. |101102**Output format** (single block):103```104MCP Vendor Health Check105=======================106Status: <OK|WARN|FAIL>107Pin: <expected SHA>108Current: <current HEAD or "unverified" or "not installed">109Action: <user message from table above>110```111112STOP after printing — do not fall through to the full installation guide.113</Health_Check>114115Task: {{ARGUMENTS}}
babamba2