ABAP Development Tools (ADT)

This guide is designed for beginners, so we'll walk through everything step-by-step. We'll cover:
- Prerequisites:What you need before you start.
- Installation and Setup:Getting everything up and running.
- Running the Server:Starting the server in different modes.
- Integrating with FLUJO:The easiest way — one-click install from the Spotlight/Marketplace.
- Integrating with Cline:Connecting this server to the Cline VS Code extension.
- Integrating with Claude Desktop:Adding the server to the Claude Desktop app.
- Integrating with Claude Code:Adding the server via.mcp.jsonor the CLI.
- Troubleshooting:Common problems and solutions.
- Available Tools:A list of the commands you can use.

Before you begin, you'll need a few things:

-

An SAP ABAP System:This server connects to an existing ABAP system. You'll need:

- The system's URL (e.g.,https://my-sap-system.com:8000)
- A valid username and password for that system.
- The SAP client number (e.g.,100).
- Ensure that your SAP system allows connections via ADT (ABAP Development Tools). This usually involves making sure the necessary services are activated in transactionSICF. Your basis administrator can help with this. Specifically, you will need the following services to be active:

- /sap/bc/adt

Node.js and npm:Node.js is a JavaScript runtime that lets you run JavaScript code outside of a web browser. npm (Node Package Manager) is included with Node.js and is used to install packages (libraries of code).

node -v npm -v

Git (or GitHub Desktop) (optional in most cases):We'll use Git to download the project code. You have two options:

Now, let's get the project code and set it up:

The server is published on npm, so you don't need to clone or build anything. Most MCP clients can run it directly withnpx:

- Using Git (command line):
- Open a terminal (command prompt or Terminal).
- Navigate to the directory where you want to store the project. For example, to put it on your Desktop:

cd Desktop

git clone https://github.com/mario-andreschak/mcp-abap-adt

cd mcp-abap-adt # Or whatever the folder name is

- Open GitHub Desktop.
- Click "File" -> "Clone Repository...".
- In the "URL" tab, paste the repository URL.
- Choose a local path (where you want to save the project on your computer).
- Click "Clone".

Install Dependencies:This downloads all the necessary libraries the project needs. In the terminal, inside the root directory, run:

Build the Project:This compiles the code into an executable format.

Create a.envfile:This file stores sensitive information like your SAP credentials. It'sveryimportant to keep this file secure.
- In the root directory, create a new file named.env(no extension).
- Open the.envfile in a text editor (like Notepad, VS Code, etc.).
- Add the following lines, replacing the placeholders with your actual SAP system information: Important: If your password contains a "#" character, make sure to enclose your password in quotes!

SAP_URL=https://your-sap-system.com:8000 # Your SAP system URL SAP_USERNAME=your_username # Your SAP username SAP_PASSWORD=your_password # Your SAP password SAP_CLIENT=100 # Your SAP client

To be fair, you usually dont usually "run" this server on it's own. It is supposed to be integrated into an MCP Client like Claude, FLUJO, Cline, etc. But youcanmanually run the server in two main ways:

- Standalone Mode:This runs the server directly, and it will output messages to the terminal. The server will start and wait for client connections, so potentially rendering it useless except to see if it starts.
- Development/Debug Mode:This runs the server with the MCP Inspector. You can open the URL that it outputs in your browser and start playing around.

To run the server in standalone mode, use the following command in the terminal (from the root directory):

You should see messages in the terminal indicating that the server is running. It will listen for connections from MCP clients. The server will keep running until you stop it (usually with Ctrl+C).

3.2 Development/Debug Mode (with Inspector)

npm run dev

That's it — FLUJO downloads and runs the npm package for you.

mcp-abap-adtruns over stdio. If you need to reach it overstreamable HTTP— for example from another app on your machine or a client that only speaks HTTP — let FLUJO re-host it: install the server in FLUJO as above, then toggle"Expose to external apps"on the server. FLUJO's built-in mcp-proxy then serves it over HTTP athttp://localhost:4200/mcp-proxy/mcp-abap-adt, and any HTTP-capable MCP client can connect with a config like:

{ "mcpServers": { "mcp-abap-adt": { "type": "http", "url": "http://localhost:4200/mcp-proxy/mcp-abap-adt" } } }

FLUJO keeps your SAP credentials with the installed server, so the HTTP config itself carries none.

Cline is a VS Code extension that uses MCP servers to provide language support. Here's how to connect this ABAP server to Cline:
-

Install Cline:If you haven't already, install the "Cline" extension in VS Code.

- Open the VS Code settings (File -> Preferences -> Settings, or Ctrl+,).
- Search for "Cline MCP Settings".
- Click "Edit in settings.json". This will open thecline_mcp_settings.jsonfile. The full path is usually something like:C:\Users\username\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json(replaceusernamewith your Windows username).

Add the Server Configuration:You'll need to add an entry to themcpServersobject in thecline_mcp_settings.jsonfile. The recommended way is to run the published npm package vianpxand pass your SAP credentials as environment variables — no local build required:

Open Claude Desktop →Settings→Developer→Edit Config. This opensclaude_desktop_config.json. The file lives at:

- Windows:%APPDATA%\Claude\claude_desktop_config.json
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json

Add anmcp-abap-adtentry undermcpServers, filling in your SAP credentials:

Option A —.mcp.jsonin your project root: