# abap-adt-mcp

abap-adt-mcp — an MCP server that lets an AI agent read, write and test ABAP code on SAP systems. One sentence in chat, and the agent handles the transport, tests and activation for you.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16 repo stars
- Author: williansaez
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/williansaez/abap-adt-mcp
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/abap-adt-mcp

## What it does

The server exposes the same ADT services Eclipse uses: source, transports, tests, ATC checks, the debugger. A chat prompt turns into tool calls — the object gets locked, edited, activated, tests run, a transport number comes back. There are 173 tools in total, but `MCP_TOOLSETS=focused` publishes 114 everyday ones by default so the schemas don't eat context.

What sets it apart is where the guard rails live. The server enforces policies itself, before any SAP call goes out. A destination with a `policy` block refuses writes at server level, regardless of what the host approves. Packages can be restricted by exact name or pattern (`ZFIN`, `Z*`).

You need Node.js 22.12 or newer, the same SAP access as for Eclipse ADT, and a Chromium browser for `authType: sso` login. Systems go into `systems.json` inside `.abap-adt-mcp` in your home directory. The README recommends dev and test systems only; a production destination should carry the `PRD` policy, otherwise a careless prompt can write where it shouldn't.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SAP_SYSTEMS_FILE`, `SAP_SYSTEMS`, `SAP_DEFAULT_DESTINATION`, `SAP_AUTH_TYPE`, `MCP_HTTP_PORT`, `MCP_HTTP_HOST`, `MCP_HTTP_TOKEN`, `MCP_HTTP_MAX_SESSIONS`, `MCP_HTTP_MAX_BODY_BYTES`, `MCP_HTTP_SESSION_TTL_MINUTES` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SAP_SYSTEMS_FILE=<SAP_SYSTEMS_FILE> --env SAP_SYSTEMS=<SAP_SYSTEMS> --env SAP_DEFAULT_DESTINATION=<SAP_DEFAULT_DESTINATION> --env SAP_AUTH_TYPE=<SAP_AUTH_TYPE> --env MCP_HTTP_PORT=<MCP_HTTP_PORT> --transport stdio abap-adt-mcp -- npx -y abap-adt-mcp
```
Replace <…> with your own values. 36 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add abap-adt-mcp --env SAP_SYSTEMS_FILE=<SAP_SYSTEMS_FILE> --env SAP_SYSTEMS=<SAP_SYSTEMS> --env SAP_DEFAULT_DESTINATION=<SAP_DEFAULT_DESTINATION> --env SAP_AUTH_TYPE=<SAP_AUTH_TYPE> --env MCP_HTTP_PORT=<MCP_HTTP_PORT> -- npx -y abap-adt-mcp
```
Replace <…> with your own values. 36 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "abap-adt-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "abap-adt-mcp"
            ],
            "env": {
                "SAP_SYSTEMS_FILE": "<SAP_SYSTEMS_FILE>",
                "SAP_SYSTEMS": "<SAP_SYSTEMS>",
                "SAP_DEFAULT_DESTINATION": "<SAP_DEFAULT_DESTINATION>",
                "SAP_AUTH_TYPE": "<SAP_AUTH_TYPE>",
                "MCP_HTTP_PORT": "<MCP_HTTP_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values. 36 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "abap-adt-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "abap-adt-mcp"
            ],
            "env": {
                "SAP_SYSTEMS_FILE": "<SAP_SYSTEMS_FILE>",
                "SAP_SYSTEMS": "<SAP_SYSTEMS>",
                "SAP_DEFAULT_DESTINATION": "<SAP_DEFAULT_DESTINATION>",
                "SAP_AUTH_TYPE": "<SAP_AUTH_TYPE>",
                "MCP_HTTP_PORT": "<MCP_HTTP_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values. 36 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SAP_SYSTEMS_FILE=<SAP_SYSTEMS_FILE> -e SAP_SYSTEMS=<SAP_SYSTEMS> -e SAP_DEFAULT_DESTINATION=<SAP_DEFAULT_DESTINATION> -e SAP_AUTH_TYPE=<SAP_AUTH_TYPE> -e MCP_HTTP_PORT=<MCP_HTTP_PORT> abap-adt-mcp npx -y abap-adt-mcp
```
Replace <…> with your own values. 36 more environment variables are in the server README

## When to use it
- create and activate an ABAP class from a chat prompt
- run unit tests and get a transport number back
- restrict which packages the agent can write to
- run an ATC check and apply quickfixes
- run an ABAP Cloud readiness check

## Example prompts
- Create a class with a test in the DEV system and show me the transport number.
- Fix the method in class `ZCL_ORDER_SERVICE` and run the unit tests.
- Run an ATC check for package `ZFIN` and suggest fixes.

## Similar
- [mcp-abap-abap-adt-api](https://affpapa.org/en/nevibecode/mcp/mcp-abap-abap-adt-api.md) — MCP server · ★ 215 repo stars
- [mcp-abap-adt-ro](https://affpapa.org/en/nevibecode/mcp/mcp-abap-adt-ro.md) — MCP server · ★ 109 repo stars
- [mcp-abap-adt](https://affpapa.org/en/nevibecode/mcp/mcp-abap-adt.md) — MCP server · ★ 210 repo stars
- [sap-adt-mcp](https://affpapa.org/en/nevibecode/mcp/sap-adt-mcp.md) — MCP server · ★ 22 repo stars
- [SAP ABAP MCP](https://affpapa.org/en/nevibecode/mcp/sap-abap-mcp.md) — MCP server · ★ 8 repo stars
- [sap-abap](https://affpapa.org/en/nevibecode/skills/sap-abap.md) — skill · 1500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
