io.github.simplifier-ag/simplifier-mcp

Simplifier MCP Server

Simplifier is the leading low-code platform in the SAP ecosystem. Build custom apps in a full-stack low-code cloud development environment, reducing your dependency on full-scale coding. Integrate with ERP, CRM and other systems easily using standardised connectors.

Find more information in our community or try Simplifier for free.

This repository contains an MCP server (Model Context Protocol) that enables integration of AI assistants with the Simplifier Low Code Platform. It provides tools and resources for creating and managing Simplifier Connectors and BusinessObjects.

Overview

The Simplifier MCP Server allows to interact with a Simplifier instance to:

• Manage Connectors and Logins: Integration components that connect external systems
• Manage Business Objects: Server-side executed JavaScript functions for business logic
• Manage Data Types: Data structures for interacting with Connectors and internal objects
• Execute Business Object Functions: Run JavaScript functions with parameters and retrieve results
• Execute Connector Calls: Call external systems via Simplifier Connector
• Access platform resources: Browse connectors, business objects, and system information

Supported Connector types

Currently only the following connector types are fully supported:

• REST
• SOAP
• SQL
• SAPRFC
• OData (proxy-only; does not support Connector Calls)

Client compatibility

The Simplifier MCP server exposes its data through two parallel surfaces so that every MCP client can use it in full, regardless of which parts of the MCP protocol that client supports:

• Clients that implement MCP Resources (e.g. Claude Code, Claude Desktop, MCP Inspector) can browse and read Simplifier data through simplifier://… URIs — for example simplifier://businessobjects, simplifier://connector/{name}, or simplifier://documentation/….
• Clients that only implement MCP Tools (e.g. OpenCode, Cursor, Cline, Continue, Windsurf) get equivalent read access through tools named *-list, *-get, documentation-get and connector-wizard-rfc-search.

Both surfaces share the same underlying implementation, so behavior is identical. Where both are available, clients should prefer resources.

Usage

Check out Simplifier Community Docs on how to use and set up the MCP server best.

Authentication

The recommended way to authenticate (from Simplifier Version MC 26-11 or higher) is a personal access token (PAT), provided via SIMPLIFIER_APITOKEN. It is sent to Simplifier as ApiToken header and does not change with every login, so you configure it once and don't have to renew it daily. All examples below use SIMPLIFIER_APITOKEN.

Alternatively you can use one of these environment variables instead:

• SIMPLIFIER_TOKEN: your current SimplifierToken. It changes with every login to Simplifier (see After a new login to Simplifier).
• SIMPLIFIER_CREDENTIALS_FILE: path to a JSON file with user and pass, used to log in to Simplifier on startup.

Only one of SIMPLIFIER_APITOKEN, SIMPLIFIER_TOKEN and SIMPLIFIER_CREDENTIALS_FILE may be set.

Add the MCP to claude code ...

Using node / npx:

claude mcp add simplifier npx @simplifierag/simplifier-mcp@latest --env SIMPLIFIER_APITOKEN=<your personal access token> --env SIMPLIFIER_BASE_URL=https://<yourinstance>-dev.simplifier.cloud

Using Docker:

claude mcp add simplifier-docker docker -- run --rm -i --env SIMPLIFIER_APITOKEN=<your personal access token> --env SIMPLIFIER_BASE_URL=https://<yourinstance>-dev.simplifier.cloud simplifierag/simplifier-mcp:latest

If your Simplifier is hosted on premise, then the SIMPLIFIER_BASE_URL of your DEV instance will be different from the mentioned schema.

After a new login to Simplifier

This only applies if you use SIMPLIFIER_TOKEN instead of a personal access token. With every login to Simplifier your SimplifierToken will change. So you will have to:

• exit your AI agent (in this example claude),
• then remove the configuration of the MCP claude mcp remove simplifier
• and then add the MCP again with --env SIMPLIFIER_TOKEN=<your current simplifier token> instead of SIMPLIFIER_APITOKEN (see upper command) and restart your AI agent

...or use this example configuration for claude code to use the MCP

e.g. in a file named .mcp.json placed in the directory, where claude is started.

Using node / npx:

{
  "mcpServers":  {
    "simplifier-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [ 
        "@simplifierag/simplifier-mcp@latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_APITOKEN": "<your personal access token>"
      }
    }
  }
}

Using Docker:

{
  "mcpServers": {
    "simplifier-docker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "SIMPLIFIER_APITOKEN",
        "--env",
        "SIMPLIFIER_BASE_URL",
        "simplifierag/simplifier-mcp:latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_APITOKEN": "<your personal access token>"
      }
    }
  }
}

Troubleshooting

If the MCP fails to connect to Simplifier on startup, an error page will open in your browser with details on the failure and information on how to fix the problem.