mcp-abap-adt: Your Gateway to ABAP Development Tools (ADT)

This project provides a server that allows you to interact with SAP ABAP systems using the Model Context Protocol (MCP). Think of it as a bridge that lets tools like FLUJO, Claude or Cline (a VS Code extension) talk to your ABAP system and retrieve information like source code, table structures, and more. It's like having a remote control for your ABAP development environment!

The server is published on npm as mcp-abap-adt and listed in the MCP Registry as io.github.mario-andreschak/mcp-abap-adt, so most MCP clients can install it with a single command.

This guide is designed for beginners, so we'll walk through everything step-by-step. We'll cover:

1. Prerequisites: What you need before you start.
2. Installation and Setup: Getting everything up and running.
3. Running the Server: Starting the server in different modes.
4. Integrating with FLUJO: The easiest way — one-click install from the Spotlight/Marketplace.
5. Integrating with Cline: Connecting this server to the Cline VS Code extension.
6. Integrating with Claude Desktop: Adding the server to the Claude Desktop app.
7. Integrating with Claude Code: Adding the server via .mcp.json or the CLI.
8. Troubleshooting: Common problems and solutions.
9. Available Tools: A list of the commands you can use.

1. Prerequisites

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 transaction SICF. 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).

  • Download Node.js. Choose the LTS (Long Term Support) version. This is the most stable version. Follow the installation instructions for your operating system. Make sure to include npm in the installation (it's usually included by default).
  • Verify Installation: After installing Node.js, open a new terminal (command prompt on Windows, Terminal on macOS/Linux) and type:
    bash

    Copy

    node -v
    npm -v
    

    You should see version numbers for both Node.js and npm. If you see an error, Node.js might not be installed correctly, or it might not be in your system's PATH. (See Troubleshooting below).

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

  • Git: The command-line tool. Download Git. Choose the version for your operating system (Windows, macOS, Linux). Follow the installation instructions.
  • GitHub Desktop: A graphical user interface for Git. Easier for beginners! Download GitHub Desktop. Follow the installation instructions.

2. Installation and Setup

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

Install with FLUJO (recommended)

See Integrating with FLUJO

Install from npm

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

npx -y mcp-abap-adt

You'll typically configure this inside your MCP client rather than run it by hand — point the client at the command npx with args ["-y", "mcp-abap-adt"] and supply your SAP credentials as environment variables (SAP_URL, SAP_USERNAME, SAP_PASSWORD, SAP_CLIENT; optionally SAP_LANGUAGE, TLS_REJECT_UNAUTHORIZED). See the integration sections below for and Cline.

To install it globally instead:

npm install -g mcp-abap-adt

Manual Installation (from source)

1. Clone the Repository:

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

        Copy

        cd Desktop
        

     3. Clone the repository:
        bash

        Copy

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

     4. Change into the project directory:
        bash

        Copy

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

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

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

   Terminal

   Copy

   npm install
   

   This might take a few minutes.

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

   Terminal

   Copy

   npm run build
   

4. Create a .env file: This file stores sensitive information like your SAP credentials. It's very important to keep this file secure.

   1. In the root directory, create a new file named .env (no extension).
   2. Open the .env file in a text editor (like Notepad, VS Code, etc.).
   3. 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!
      Code

      Copy

      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
      

      Important: Never share your .env file with anyone, and never commit it to a Git repository!

3. Running the Server

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 you can manually 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.

3.1 Standalone Mode

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

npm run start

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)

This mode is useful for debugging.

1. Start the server in debug mode:
   Terminal

   Copy

   npm run dev
   

   This will start the server and output a message like: 🔍 MCP Inspector is up and running at http://localhost:5173 🚀. This is the URL you'll use to open the MCP inspector in your Browser.

4. Integrating with FLUJO

FLUJO is the easiest way to use this server — no cloning, building, or editing JSON config. mcp-abap-adt is a curated Spotlight server, so it installs with a single click:

1. In FLUJO, navigate to MCP.
2. Click Add Server.
3. On the Spotlight tab, click mcp-abap-adt (or switch to the Marketplace tab and find it there).
4. FLUJO fetches the package automatically and opens the Local Server tab. Enter your SAP URL, Username, and Password (and client), then click Save.

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

Streamable HTTP transport (via FLUJO)

mcp-abap-adt runs over stdio. If you need to reach it over streamable 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 at http://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.

5. Integrating with Cline

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

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