Home

sap-dev: an SAP ABAP MCP server

Welcome to the sap-dev-release wiki!

This project delivers a specialized MCP server designed to bridge the gap between AI and SAP. We provide your coding agents with the ABAP tools they’ve been waiting for!

The ABAP Challenge

While AI-driven development is a revolutionary paradigm shift, LLMs face the same hurdles as human developers: writing code in a vacuum is prone to error. Just as you wouldn't expect a hand-written sketch to compile perfectly, an LLM cannot succeed without a feedback loop.

Because of context window limitations, AI agents require precise, high-quality tools even more than humans do.

And then there is the "SAP Factor." Much like Isla de Muerta from Pirates of the Caribbean, you can only find your way there if you already know where it is.

Available MCP Tools

• Code Editing
• Explorative Tools
• Processing ATC Findings
• Diagnostics
• Debugging
• Permissions
• Dashboard Diagnostics
• Upgrade Assistant
• Non-SAP

Extensibility & Customization

• Extensibility
  • Plugin Development
  • Hook Development

A typical sap-dev workflow

Every tool in the sap-dev toolset requires the absolute path to your active project folder passed via the workspace_dir parameter. This allows the backend daemon (sap-bridge) to dynamically resolve credentials, vault encryption keys, and local SQLite states for your workspace without requiring global initialization.

Step-by-Step Workflow

1. Start the sap-bridge Server FIRST:
   Always start the sap-bridge background server before launching your AI IDE (VS Code, Cursor, Antigravity, etc.). Use the provided helper scripts:

   • Windows: references/start-server.cmd
   • macOS / Linux: references/start-server.sh
     Starting the server first ensures the persistent HTTP/SSE daemon (http://127.0.0.1:58454/mcp) is active when your IDE's mcp-remote adapter connects at startup.

2. Open Your AI IDE & Project Workspace:
   Launch your IDE with your project directory open. The IDE connects automatically to the running sap-bridge server via MCP.

3. Access the Web Dashboard via Workspace Links:
   When your agent initiates a workspace session, sap-bridge automatically generates convenient URL shortcut links directly in your project root directory (e.g. open-dashboard.url on Windows or open-dashboard.desktop on Linux). Double-clicking this link opens the Web Dashboard in your browser with your project's ?workspace_id=... pre-populated. Alternatively, ask your AI agent for the Dashboard link - this will also create the shortcut.

4. Unlock the Credentials Vault:
   Open the Web Dashboard link and enter the master password created during Setup to unlock your workspace vault.

Once the workspace is unlocked, the AI agent has access to your configured SAP systems and can execute tools.

Note

When unlocking the workspace on the login screen, verify that the workspace directory displayed matches your active project folder.