sap-abap-mcp
SAP ABAP MCP Server (ADT und JSON RPC)
Ein MCP-Server, der einer KI-Agenten vollständigen Lese-/Schreibzugriff auf ein SAP-ABAP-System über ADT (ABAP Development Tools) gibt, authentifiziert mit SPNEGO/Kerberos-Single Single-Sign-On, einem X.509-Clientzertifikat oder einem OAuth-2.0-Bearer-Token – ohne Passwort in der Konfiguration. Benutzer und Passwort sind weiterhin als Fallback verfügbar, aber nicht empfohlen!
Er kapselt abap-adt-api und fügt eine Sache hinzu,
die ADT selbst nicht kann: RFC-fähige Funktionsbausteine aufrufen, über den SAP-Gateway-JSON-RPC-2.0-Dienst.
128 Tools – Objekt-CRUD, Quelltextbearbeitung, Sperren, Transporte, Aktivierung, Syntaxprüfung, Code- Vervollständigung, ABAP-Unit, ATC, DDIC, abapGit, Refactoring, Traces, der Debugger und RFC-Aufrufe.
Wie viele ein Client tatsächlich sieht, sind aus zwei Gründen weniger. Pofile (ABAP_MCP_PROFILE)
tauschen Oberfläche gegen Kontext: core listet 9 Tools, all listet 129, das sind ~2.700 Tokens
gegenüber ~17.800 in jeder Runde für einen Client, der Tool-Schemas nicht on demand abrufen kann.
Außerdem fragt der Server das System, was es unterstützt, bevor er irgendetwas auflistet – so wird
einer Version ohne das abapGit-Plugin nie die 10 Tools angeboten, die mit 400 antworten würden. Auf DEV
bleiben damit 116 übrig.
Dies ist der SSO-Fork von
mcp-abap-abap-adt-apivon mario-andreschak. Die wichtigsten Unterschiede: Kerberos-SSO statt Basic Auth, die JSON-RPC/RFC-Tools, ein aus den Tool-Definitionen abgeleiteter Router und eine dokumentierte Tool-Referenz.
Dokumentation
Dokument | Behandelt es |
Die Arbeit an diesem Repository: Aufbau, Konventionen, wie man testet. Lesen Sie dies, bevor Sie den Code ändern. | |
Was Sie tun möchten → das Tool, das es erledigt. Handgeschrieben, in den Worten, die Menschen verwenden. Starten Sie hier, wenn Sie die Aufgabe, aber nicht das Tool kennen. | |
Alle 128 Tools mit ihren Argumenten, gruppiert nach Familie. Aus den Tool-Definitionen generiert und kann daher nicht vom Code abweichen. | |
Wie sich der Server verhält. Die Profile, geschriebene, Goldene Pfad, ADT-URI-Semantik und Lesediagramm-Semantik, die Antwort-/Fehler-Semantik sowie eine Fehlerbehebungsmatrix. Geschrieben für Menschen und für Agenten, die den Server steuern. | |
The 20 SAP/ABAP-Skills und wie sie auf diesen Tools abbilden. | |
The 35 integrierten allgemeinen Softwareentwicklungs-Skills. | |
Design- und Protokohanzeigen für die JSON-RPC/RFC-Tools, gelesen aus dem ABAP-Quellcode von | |
Die beiden passwortlosen Anmeldemodi: Kerberos-SSO und X.509-Zertifikate für Service- und technische Benutzer. Was SAP konfiguriert werden muss und warum dies gegenseitiges TLS ist und kein SNC. |
Related MCP server: ABAP-ADT-API MCP-Server
Funktionen
Zwei passwortlose Anmeldemodi – SPNEGO/Kerberos mit dem Ticket des angemeldeten Windows-Benutzers or ein X.509-Client-Zertifikat für einen Service- oder technischen Benutzer ohne Kerberos-Identität. In beiden Fällen wird kein SAP-Passwort gespeichert oder gesendet, und beide heilen selbst. wenn die Sitzung abläuft.
Streamable-HTTP-Transport, für ein Team, das einen Container teilt – setzen
ABAP_MCP_TRANSPORT=httpund jeder sich verbindende MCP-Client authentifiziert sich mit seinem eigenen SAP OAuth-2.0-Bearer-Token, damit jede Sitzung eine eigene SAP-Anmeldung erhält statt dass alle einen technischen Benutzer teilen. stdio bleibt die Standard aufgabe für einen einzelnen, lokal gestarteten Client. Siehe §12 und Betrieb über HTTP unten.Jedes Objekt per Name lesen –
readAbapObjectführt einen Namen in einem Aufruf zu seiner Quelle auf; keine ADT-URL muss entdeckt oder manuell erstellt werden.Eine Tabelle beschreiben –
describeAbapTablegibt Felder, DDIC-Typen, Schlüsselflags und Checktabellen zurück.Objektverwaltung – ABAP-Objekte suchen, lesen, erstellen, ändern, löschen und aktivieren.
Eine Benennungskonvention erfassen –
searchPackagesfindet Pakete per Muster (["ZPP_*","Z_PP*"]) und expandiert jedes in einem Aufruf in seine nach Typ gruppierten Objekte.Quellcode-Workflow – Sperren → Bearbeiten → Syntaxprüfung → Aktivieren → Entsperren, mit Transportstandard.
Code-Intelligenz – Textvollständig, Definitionen, Nutzung der Referenzen, ABAP Doc, Pretty-Printer, ATC, ABAP-Unit, Refactoring (Umbenennen, Methode extrahieren).
RFC-Funktionsbausteine aufrufen –
callFunctionViaJsonRpcführt einen RFC-fähigen Funktionsbaustein aus und validiert die Anfrage gegen seine tatsächliche Signatur, die aus dem System gelesen wird.Batch-RFC-Aufrufe in einem einzigen LUW –
callFunctionsViaJsonRpcsendet mehrere Funktionsbausteine in einer einzelnen Anfrage; das ist es, was es einem Update-BAPI und seinemBAPI_TRANSACTION_COMMITerhält, eine LUW teilen.Datenzugriff –
tableContentsund Ad-hoc-runQuery-SELECTs.Das laufende System ansehen –
listLoggedOnUsersbeantwortet „Wer ist gerade angemeldet“ ausTH_USER_LIST(die Daten hinterSM04);readProfileParametersliest RZ11-Werte in einem einzigen Round Trip; undcheckLogonConfigurationsagt, welche Authentifizierung das System tatsächlich akzeptiert.Enthaltene Agenten-Skills – 54 Skills unter
skills/, für ABAP (Clean ABAP, RAP, CDS, ATC, abapGit…) und allgemeine Softwareentwicklung (TDD, Code-Review, Diagnose von Bugs), bereit als Ressouren und überreadSkill.Selbst-dokumentierend – die untenstehenden Notizen werden vom Server selbst als MCP-Ressourcen (
abap-adt://guides/…) und über das ToolreadServerGuide-Readserverbereitgestellt, sodass ein Agent sich während einer Aufgabe eine Anleitung oder ein Argument ansehen kann, ohne die Session verlassen muss.
Voraussetzungen
Ein SAP-ABAP-System, das über ADT erreichbar ist.
/sap/bc/adtmuss inSICFaktiv sein. Für die RFC-Tools muss auch/sap/gw/jsonrpcaktiv sein (SAP_GWFND), und Ihr Benutzer benötigtS_RFCfür die Funktionsgruppe, die Sie aufrufen.Eine Möglichkeit, sich ohne Passwort anzumelden, eine der folgenden:
Eine funktionierende Kerberos-Anmeldung – Das SAP-System muss SPNEGO akzeptieren und Sie müssen ein gültiges Ticket besitzen (
klist). Das ist die Standardeinstellung und benötigt Windows wie ausgeliefert: Der Bootstrap führtC:\Windows\System32\curl.exe --negotiateaus, das den Schannel/SSPI-Backend von curl benötigt. Auf anderen Plattformen zeigen SieSSO_CURL_PATHauf ein curl, das mit GSS-API-Unterstützung gebaut wurde.Ein X.509-Client-Zertifikat – für einen Service- oder technischen Benutzer ohne Kerberos-Identität. Benötigt weder curl noch Windows. SAP-Passwortlose Anmeldung muss eingerichtet sein: Der ICM-Port muss ein Zertifikat anfordern (
VCLIENTinicm/server_port_<n>, dasicm/HTTPS/verify_clientüberschreibt), die ausstellende CA inSTRUSTals vertrauenswürdig eingetragen sein und eineCERTRULE-Zuordnung zum Benutzer. Vollständige Einrichtung – einschließlich der Prüfung vom Server – indocs/Authentication.md.Ein OAuth-2.0-Client – für eine SAP-BTP-ABAB-Umgebung, wo es kein Kerberos-Realm und keinen ICM zu konfigurieren gibt, oder für ein lokal installiertes System, das ADT über
SOAUTH2veröffentlicht. Ein BTP-Dienstschlüssel ist bereits einer dieser. Siehe §11^.
Node.js (LTS) und npm – Überprüfen Sie mit
node -vundnpm -v.
Installation
git clone --recurse-submodules https://github.com/Ciltress/sap-abap-mcp.git
cd sap-abap-mcp
npm install
npm run build
--recurse-submodulesist wichtig: Die allgemeinen Engineering-Skills liegen in einem Untermodul; ohne dies ist dieses Verzeichnis leer und der Server bietet 35 weniger Skills an. Schon geklont? Dann führen Siegit submodule update --init --recursive.
Das
npx mcp-abab-abap-adt-api-Paket auf npm ist der Vorläufer-Server und enthält nicht die SSO-Bootstrap-Datei oder die RFC-Tools. Bauen Sie dieses Repository stattdessen von Quellen.
Konfiguration
Kopieren Sie .env.example zu .env und füllen Sie Ihr System aus:
SAP_URL=https://your-sap-server.example.com:44301
SAP_USER=YOUR_SAP_USER
SAP_CLIENT=100
SAP_LANGUAGE=ENSAP_URL und SAP_USER sind erforderlich; SAP_CLIENT und SAP_LANGUAGE sind optional, aber
empfohlen. Drei der vier Anmeldemodi benötigen kein SAP_PASSORT überhaupt.
Committen Sie nie .env; es ist bereits in .gitignore.
Optionale Variable | Auswirkung |
| Die System-ID, wie in |
| Akzeptiert ein Zertifikat einer internen/unbekannten Zertifizierungsstelle. Nur für die Entwicklung. |
| Pfad zu einer curl-Binärdatei mit SPNEGO-Unterstützung, falls nicht die Windows-System-Curl. |
| Überschreibt den JSON-RPC-ICF-Pfad, wenn der Knoten unter einem Alias veröffentlicht wird. |
| Welche Tools dieser Server listet – und welche er daher beantwortet. Siehe weiter unten. |
| Obergrenze für eine einzelne Antwort in Bytes. |
|
|
| Startet auch, wenn SAP diesem Benutzer den ADT-Knoten verweigert, und behält die RFC-Tools. Siehe docs/Authentication.md. |
| An welchen ICF-Knoten sich das Fallback anmeldet. Es muss von ihm nur ein Sitzungs-Cookie und ein CSRF-Token ausgestellt werden. |
|
|
| Port für den Streamable-HTTP-Endpunkt. Standard |
| Adresse, an die im |
| Browser-Ursprünge, die Aufrufe zu |
|
|
| Anfragen pro Minute je MCP-Sitzung im |
Dimensionierung des Servers für seinen Client
Die drei Variablen ABAP_MCP_* gibt es aus einem einzigen Grund: Ein Client, der Tool-Schemas nicht bei Bedarf abrufen kann, bezahlt das komplette Paket der Tool-Liste bei jedem einzelnen Turn. Claude Code ruft Schemas erst bei Bedarf ab und sollte default bleiben; ein 8B-Modell mit 128k-Fenster investiert ein Sechstel seines Kontexts, bevor das Gespräch beginnt, and genau dort entsteht der Eindruck, dass „derselbe Prompt nur die Hälfte klappt“.
ABAP_MCP_PROFILE – nicht gesetzt bedeutet all, eine bestehende Einrichtung wird also nicht verändert.
Profil |
| Kosten pro Turn | Zweck |
| 9 | ~2,737 Tokens | Ein System lesen und eine Änderung abschließen |
| 18 | ~3,982 Tokens | schreibelesend: Dictionary, Tabellendaten, RFC-Aufrufe |
| 10 | ~2,900 Tokens | ein Ben liegt, ein Benutzer mit RFC-Rechten aber ohne |
| 49 | ~8,034 Tokens | der Änderungszyklus plus Tests, ATC, Transporte, Refactoring |
| 129 | ~17,759 Tokens | die Standard – richtig für Clients, die Schemas bei Bedarf abrufen |
Die Zählungen enthalten einen healthcheck, der in jedem Profil außerhalb eines Profils steht, weil es das Tool ist, das die Frage „„Welches Profil läuft gerade?“ beantwortet.
Ein Profil ist kein Bequemlichkeitsfilter. Ein Tool außerhalb des aktiven Profils nicht gelistet und nicht geroutet, kann also nicht aufgerufen werden – gerade das macht analyst zur Garantie dafür, dass nichts Quellcode verändert und nicht nur zu einem kleineren Menü. Aufrufe außerhalb des Profils erhalten für nicht beschreibt eine Fehlermeldung und statt „unbekanntes Werkzeug“ ein Hinweis und "unknown tool" steht Fehler, es gibt also keinen Grund für eine Wiederholung. Ein unbekannter Profilname stoppt den Server beim Start, stets So nicht auf all zurückgefallen, als all zugunsten von 129 Tools als Antwort auf 9 erbeten wird – genau einen Fehler verhindert die Existenz von Profilen verhindern.
core ist klein, weil ein einziges Tool, editAbapSource, den Schreibzyklus darstellt: sperren, schreiben, aktivieren, entsperren und den Sperre auch bei einem Teilschrittfehler freigeben. Die vier getrennten Schritte stehen findig; nur in dev und all.
ABAP_MCP_MAX_RESPONSE_BYTES – die Tool-Liste ist ein fester Kosten je eines Profils zu senken; eine Antwort kann unbegrenzt hoch. Bei core ist die Tool-Liste etwa ~11 KB und ein einzelnes adtDiscovery hat ~42 KB. Ohne Angabe gilt das Profil (core 24.000 Bytes, analyst 32.000, dev 48.000, all keine Obergrenze); 0 entfernt es.
Antwort over Budget wird kommt unterdrückt und durch gültiges JSON ersetzt – status:"truncated", die ursprünglichen bytes, das budget, eine ~2.000-Byte Vorschau und einen nextStep wird aber nie durch ein abgeschnittenes Fragment, das nicht geparst werden könnte und würde die identischen Wiederholungsversuch invite.
ABAP_MCP_GATE – bevor er etwas auflistet, fragt er das System nach seinem Können hinterfragt und behält die Tools zurück, deren ADT-Sammlungen fehlen. Auf DEV sind das die 10 abapGit-Tools und die 3 Service-Binding-Tools, die sonst eine HTTP-400-Antwort liefern. Es kostet eine Discovery-Round-Entry-Pro-Prozess, kann die Liste nur kürzen, und jede Fehlfunktion sieht listet sämtliche Tools. Mit ABAP_MCP_GATE=off wird der Schritt übersprungen.
healthcheck meldet alle drei: das aktive Profil, responseBudgetBytes und alles Zurückgehaltene.
Zertifikat statt Kerberos
Für einen Service- oder technischen Benutzer ist ein Zertifikat mit hinzufügen – das allein genügt, um den Modus umstellen:
SAP_USER=CLAUDEAGENT # the user CERTRULE maps the certificate to
SAP_CERT_FILE=C:\Users\svc_agent\SNC\sec\claudeagent.p12
SAP_CERT_PASSPHRASE=<PKCS#12 password / PSE PIN>Optionale Variable | Auswirkung |
|
|
| Der private Schlüssel, wenn er nicht in |
| CA-Zertifikatspaket zur Überprüfung des eigenen SAP-Zertifikats, statt TLS-Verifizierung zu deaktivieren. |
Das ist wechselseitiges TLS, kein SNC – ADT ist HTTPS. Ein Zertifikat, das bereits für RFC/SNC funktioniert, kann übernommen werden und seine
CERTRULE-Zuordnung trifft, übernommen, bei der Zuordnung übernommen werden; dieSNC0-ACL spielt aber keine Rolle und das ICM verlangticm/HTTPS/verify_client.docs/Authentication.mdbehandelt die Unterschiede, die Falle aussapgenpse export_p12/ OpenSSL 3 sowie das Lesen eines abgelehnten Zertifikats.
Einen OAuth-2.0-Client, für BTP und für SOAUTH2
Für eine SAP-BYP-ABAP-Umgebung oder eine behafteten, anderen Endpunkt von ADT hinter einem Auth-Server zu veröffentlicht, ADT anbietet. Das Setzen einer Client-ID wechselt den Modus:
SAP_OAUTH_TOKEN_URL=https://your-tenant.authentication.eu10.hana.ondemand.com/oauth/token
SAP_OAUTH_CLIENT_ID=sb-abap-agent!t1234 # 'clientid' in a BTP service key
SAP_OAUTH_CLIENT_SECRET=<'clientsecret'>Auf On-Premise’ liegt der Endpunkt auf dem eigentlichen SAP-Host – https://<host>:<port>/sap/bc/sec/oauth2/token – und der Client ist der in SOAUTH2 registrierte.
Optionale Variable | Effekt |
|
|
| Die anzufordernden Scopes. Unset fragt die Standard-Scopes des Clients ab (Standard Fall). |
| Für den Grant |
| Ein Token, das woanders erstellt und so verwendet wird. Kann nicht erneuert werden. |
|
|
Das Token meldet sich einmal an. Danach trägt das SAP-Sitzungs-Cookie jede Anfrage, wie in den anderen Modi. Ein Token in fünf Minuten abläuft, stellt also kein Problem dar. Beachten Sie: Ein OAuth-2.0-Client auf AS ABAP ist Benutzer in
SU01: Ein falschesSAP_OAUTH_CLIENT_SECRETwird wie ein Passwort mitfalschen Login/fails_login/fails_to_user_lockverwiesen wird, so dass eine abgelehnte Token-Anfrage nicht erneut versucht wird. Der Autorisierungscode-Flow ist nicht implementiert – dafür wird ein Browser, der Breached werden dokumentiert; ein Server, der über stdio gestartet wurde, keine Möglichkeit dazu. Fordern Sie ihn einmal von händische aus auf und übergeben Sie dazu das Refresh-Token.docs/Authentication.md§11 bringt Details, einschließlich welche Fehler dauerhaft gemerkt werden und warum.
Ein Passwort, wenn nichts anderes übrig ist
Für ein System ohne Kerberos und ohne Zertifikat – eine Sandbox, eine Test-oder Test-Instal, alles abseits der Domäne:
SAP_USER=CLAUDEAGENT
SAP_PASSWORD=<the password>Der letzte Ausweg, der ist mit den anderen beiden nicht eins gegen eins austauschbar. Ein fehlendes Ticket oder ein ungemapptes Zertifikat wird einfach abgelehnt; ein falsches Passwort zum Fehlversuch verwendet wird; Passwort führt zu
login/fails_to_user_lockund sperrt diesen Benutzer für jeden Wiederverender, auch für alle, die ihn nutzen nicht nur für diesen Server. Der ImplementierungCode weigert sich, deshalb ein zurückgewiesenes Passwort erneut zu testen – nur einen einziger Log-Anmeldefehler, dauerhaft gesperrt, unabhängig davon, wie viele Tools bzw. Stunden ins Spiel kommen. Bevorzugen Sie für unbeaufsichtigten Betrieb ein Zertifikat.docs/Authentication.md§10 beschreibt die Einzelheiten.
Si e bei einem MCP-Client anmelden
Sie stellen den Client mit absoluten Pfaden auf den gebauten Einstiegspunkt um:
{
"mcpServers": {
"sap-abap-dev-100": {
"command": "node",
"args": ["C:/path/to/sap-abap-mcp/dist/index.js"],
"env": {
"SAP_URL": "https://your-sap-server.example.com:44301",
"SAP_USER": "YOUR_SAP_USER",
"SAP_SYSTEM_ID": "DEV",
"SAP_CLIENT": "100",
"SAP_LANGUAGE": "EN"
}
}
}
}Der env-Block des Clients überschreibt .env. Mit npm run start starten Sie den Server von Hand, oder lassen Sie ihn mit npm run dev durch den MCP-Inspector betreiben.
Bei einem Client, der bei jedem Turn alle Tool-Schemas mitführt, fügen Sie diesem Block ein Profil hinzu:
"env": { "…": "…", "ABAP_MCP_PROFILE": "core" }In Docker
In der Standardeinstellung kommuniziert der Server über stdio per MCP, gibt den keinen Port zu veröffentlichen: – Der Client startet den Container und spricht über stdin/stdout mit ihm. Dieses Vorgehen behandelt diesen Standard; für einen Container, mit dem verbinden sich mehrere Team-Mitglieder über das Netzwerk verbinden, siegt Ausführung über HTTP.
docker build -t abap-adt-mcp .{
"mcpServers": {
"sap-abap-dev-100": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--env-file",
"C:/path/to/.env",
"abap-adt-mcp"
]
}
}
}Alle vier Logon-Modi funktionieren hier. Aber eine Zugangsdaten muss dem Container gegeben werden, und --env-file ist nicht dotenv: Docker entfernt keine Anführungszeichen, er liest export nicht und er liest keinen #-Verbrecher am Ende — das bedeutet, ein Wert, den dotenv bereinigt hätte, landet unverändert im Original. Windows-Pfade in .env müssen durch gemountete Pfade ersetzt werden. Kerberos anspruchsvollste Modus im Container-Modus, dagegen ist OAuth am einfachsten: Ein Token wird über das Netzwerk geholt, Sie brauchen also nichts zu mountieren.
Zertifikatsmodus – Sie mounten das Schlüsselmaterial schreibgeschützt und die Zertifizierungsstelle, die das SAP-Zertifikat signiert:
docker run -i --rm --env-file .env \
-v /host/certs:/certs:ro \
-e SAP_CERT_FILE=/certs/agent.p12 \
-e SAP_CA_FILE=/certs/corporate-root.pem \
abap-adt-mcpKerberos-Modus — das Image enthält ein curl, das gegen GSS-API gebaut wurde, und kinit, es bleibt also nur noch ein Realm und ein Credential:
docker run -i --rm --env-file .env \
-v /etc/krb5.conf:/etc/krb5.conf:ro \
-v /host/agent.keytab:/krb5/agent.keytab:ro \
-e SAP_KRB_KEYTAB=/krb5/agent.keytab \
-e SAP_KRB_PRINCIPAL=SVC_AGENT@CORP.EXAMPLE.COM \
abap-adt-mcpOAuth-2.0-Modus — nichts einzubinden, das Credential wird geholt:
docker run -i --rm --env-file .env \
-e SAP_OAUTH_TOKEN_URL=https://your-tenant.authentication.eu10.hana.ondemand.com/oauth/token \
-e SAP_OAUTH_CLIENT_ID='sb-abap-agent!t1234' \
-e SAP_OAUTH_CLIENT_SECRET=<clientsecret> \
abap-adt-mcpPasswort-Modus — letzte Möglichkeit!
docker run -i --rm --env-file .env \
-e SAP_USER=YourUser \
-e SAP_PASSWORD=YourPassword \
abap-adt-mcpDrei Dinge, die Sie wissen sollten, bevor Sie darauf zurückgreifen:
Ein Keytab, nicht Ihr eigenes Ticket. Ein Container kann die Anmeldedaten der Sitzung nicht so ausleihen wie eine interaktive Anmeldung. Auf einem Linux-Host können Sie den Ticket-Cache, den Sie bereits haben, einhängen (
-v /tmp/krb5cc_1000:/krb5/ccache:ro -e KRB5CCNAME=FILE:/krb5/ccache), aber er läuft mit dem des Hosts ab. Von einem Windows-Host aus funktioniert keines von beidem: Der TGT lebt im LSA-Cache und kann nicht in eine Datei geschrieben werden — verwenden Sie den Zertifikatsmodus, der nichts davon benötigt. Der Keytab ist das einzige Credential, das unbeaufsichtigt funktioniert, und das einzige, das länger lebt als die Ticketsok.
Überprüfen Sie SAPs Zertifikat – oder wissen Sie, dass Sie es nicht tun. Das Image vertraun nur dem öffentlichen CA-Bundle, daher ist eine interne CA, der der Host vertraunt, hier unbekannt, und der Handschlag schlägt mit
UNABLE_TO_GET_ISSUER_CERT_LOCALLYfehl. Hängen Sie die Root-CA ein und zeigen SieSAP_CA_FILEdarauf. Eine Desktop-.envin Bausch und Bogen zu übernehmen verschleiert das nur:NODE_TLS_REJECT_UNAUTHORIZED=0ist eine Entwicklungseinstellung und hat in einem ausgelieferten Image nichts verloren.Aus einem
--recurse-submodules-Clone bauen.skills/Developmentist ein Submodul; ohne es enthält das Image 35 weniger Skills.
Das Image ist aus einem einzigen Grund Debian statt Alpine: Alpines curl ist ohne GSS-API gebaut, und ein solches curl scheitert nicht — es sendet einfach nie ein Token, und SAP antwortet mit demselben 401, das auch ein abgelaufenes Ticket erzeugt. Was fehlt, wird beim Start auf stderr benannt, bevor eine Sitzung versucht wird. Um den Container zu fragen, mit welchem Credential er am Ende arbeitet, geben Sie ihm einen Befehl statt des Servers:
docker run --rm --env-file .env -v /host/agent.keytab:/krb5/agent.keytab:ro \
-e SAP_KRB_KEYTAB=/krb5/agent.keytab abap-adt-mcp klistdocs/, skills/ und AGENTS.md werden absichtlich ins Image kopiert — der Server liest sie zur Laufzeit, um readServerGuide, readSkill und die abap-adt://-Ressourcen zu bedienen. docs/Authentication.md §7 enthält die vollständige Container-Einrichtung, Modus für Modus.
Über HTTP betreiben
Alles oben startet einen Server für einen Client über stdio. Setzen Sie stattdessen ABAP_MCP_TRANSPORT=http, um einen langlebigen Container zu betreiben, mit dem sich ein ganzes Team über das Netzwerk verbindet, und verwenden Sie den Streamable-HTTP-Transport des SDK unter /mcp.
Der HTTP-Modus ändert, wer sich anmeldet, nicht, was eine Sitzung nach der Anmeldung tun kann: Keiner der vier oben genannten Modi — SAP_AUTH_MODE, SAP_CERT_FILE, SAP_OAUTH_CLIENT_ID, SAP_PASSWORD — gilt hier, weil es keine einzige gemeinsame Anmeldung zu konfigurieren gibt. Stattdessen authentifiziert sich jeder MCP-Client mit seinem eigenen SAP-OAuth-2.0-Bearer-Token: er sendet Authorization: Bearer <token> bei initialize, und dieses Token wird die SAP-Identität der jeweiligen Sitzung — ihr eigener ADT-Logon, ihre eigenen Sperren, ihr eigener Audit-Trail. Wenn sich zwei Teammitglieder gleichzeitig verbinden, erhalten sie zwei unabhängige Sitzungen, nie einen gemeinsamen technischen Benutzer.
docker build -t abap-adt-mcp .
docker run --rm -p 3000:3000 \
-e SAP_URL=https://your-sap-server.example.com:44301 \
-e SAP_USER=CLAUDEAGENT \
-e SAP_CLIENT=100 \
-e ABAP_MCP_TRANSPORT=http \
abap-adt-mcpSAP_USER ist weiterhin erforderlich (jeder Nicht-Passwort-Modus benötigt einen Platzhalter-Benutzernamen für den Aufbau des ADT-Clients), wird aber niemals übertragen und hat keinen Einfluss darauf, wer eine gegebene Sitzung tatsächlich ist — SAP ents Ehrendes von jedem eigenen Token der Sitzung, wie in §11.
Variable | Effekt |
| Wechselt von stdio zu Streamable-HTTP transport. |
| Port, auf den gelauscht wird. Standard |
| Adresse, an die gebunden wird. Standard |
| Browser-Origins, die |
|
|
| Anfragen pro Minute und Sitzung. |
Registrieren Sie einen Client wie jeden entfernten Streamable-HTTP-MCP-Server, zeigen Sie ihn auf /deployment. und geben Sie das eigene SAP-OAuth-Token dieses Benutzers an:
{
"mcpServers": {
"sap-abap-dev-100": {
"url": "http://your-host:3000/mcp",
"headers": { "Authorization": "Bearer <your SAP OAuth access token>" }
}
}
}Eine Anfrage ohne Credential wird vor dem gesamten SAP-Verkehr mit 401 abgelehnt; ein Token, das SAP selbst ablehnt, ebenfalls mit 401, einschließlich SAPs eigener Meldung. Für den Transport selbst gibt es kein zusätzliches gemeinsam Geheimnis zu konfigurieren — das SAP-Token ist die Zugriffskontrolle.
Ein Client, der nicht jedes Mal getrennt werden möchte, wenn sein Access-Token abläuft, kann stattdessen sein eigenes Refresh-Token als X-SAP-Refresh-Token senden, und die Sitzung erneuert sich selbst über den refresh_token-Grant. Dafür müssen SAP_OAUTH_TOKEN_URL und SAP_OAUTH_CLIENT_ID auf dem Container vorhanden sein — die Client-Registrierung, gegen die ein Refresh-Token eingelöst wird, gehört zum Deployment, während das Refresh-Token und damit die SAP-Identität beim Aufrufer bleibt.
Browser-Origins werden abgelehnt, sofern sie nicht in ABAP_MCP_HTTP_ALLOWED_ORIGINS auftauchen: Das ist der DNS-Rebinding-Schutz, den die MCP-Spezifikation den Server selbst anzuwenden bittet, da eine Rebinding-Anfrage nie durch den davor liegenden Proxy geht. Freigesehene Origins erhalten die passenden CORS-Header. Clients, die keine Origin senden — also alle MCP-Clients, die keine Webseite sind — bleiben unberührt.
Das docker-entrypoint.sh des Containers überspringt sein Kerberos-Setup automatisch, wenn ABAP_MCP_TRANSPORT=http gesetzt ist, da die Auswahl von resolveAuthMode() nichts ECHtes beschreibt, sobald sich jede Sitzung mit einem eigenen Token anmeldet. Die TLS-Terminierung bleibt dem überlassen, was vor dem Container sitzt (Reverse-Proxy oder Ingress), genauso wie für jedem anderen internen HTTP-Dienst. Weitere Details, einschließlich der OAuth-Grant-Mechanik, auf die das hinausläuft, finden sich in docs/Authentication.md §12.
Mehr als ein System
Ein Server ist für seine gesamte Lebensdauer an ein System und einen Client gebunden — keins davon zur Laufzeit umschaltbar. Registrieren Sie also einen Eintrag pro System/Client, und geben Sie jedem ein eigenes SAP_SYSTEM_ID:
"sap-abap-dev-100": { "env": { "SAP_SYSTEM_ID": "DEV", "SAP_CLIENT": "100", "…": "…" } },
"sap-abap-dev-200": { "env": { "SAP_SYSTEM_ID": "DEV", "SAP_CLIENT": "200", "…": "…" } },
"sap-abap-q01-100": { "env": { "SAP_SYSTEM_ID": "Q01", "SAP_CLIENT": "100", "…": "…" } }Jeder Server kündigt sich dann in den MCP-instructions an, die er bei der Verbindung zurückgibt:
Dieser Server ist an SAP-System DEV, Client 100 gebunden (https://…:44301). Er kann System oder Client zur Laufzeit nicht wechseln — beide sind durch die Umgebung festgelegt, mit der er gestartet wurde. Wenn eine Anfrage ein anderes System oder einen anderen Client benennt, verwenden Sie den MCP-Server, der für das konfiguriert ist; wenn keiner registriert ist, handeln Sie nicht von hier aus.
Das ermöglicht einem Agenten, „bitte das in DEV, Client 200 prüfen" an den richtigen Server zu leiten, ohne etwas aufzurufen. healthcheck meldet dieselbe Identität für einen Server, den man direkt fragen muss.
Die Angabe wird geprüft. SAP benennt System und Client in dem Session-Cookie, das er bei der Anmeldung setzt (SAP_SESSIONID_DEV_100), der Server weiß also, mit welchem System er tatsächlich verbunden ist. Wenn das mittig SAP_SYSTEM_ID nicht übereinstimmt — etwa ein kopierter Eintrag, der auf den falschen Host zeigt, — enthält healthcheck eine WARNING und wird beim Start laut geloggt. Das sollte man im Blick haben, denn jedes Werkzeug funktioniert weiterhin einwandfrei; uses gerade auf dem falschen System.
Kurzer Rundgang
Lesen Sie jedes Objekt per Name — URL-Discovery ist nicht nötig:
{"tool":"readAbapObject","args":{"objectName":"ZCL_MY_CLASS"}}
{"tool":"describeAbapTable","args":{"tableName":"T000"}}Erfassen einer eine ganze Namenskonvention — Muster werden für Sie normalisiert, so wird zpp_lab zu ZPP_LAB*:
{ "tool": "searchPackages", "args": { "patterns": ["ZPP_*", "Z_PP*"] } }
// -> each package with its objects grouped by type, sub-packages, and a `truncated` flagRufen Sie einen Funktionsbaustein auf — die Signatur wird zuerst gelesen und die Anfrage dagegen validiert:
{"tool":"readAbapFunctionModule","args":{"functionModuleName":"STFC_CONNECTION"}}
{"tool":"callFunctionViaJsonRpc","args":{"functionModuleName":"STFC_CONNECTION",
"inputParameters":{"REQUTEXT":"hello"}}}Ein BAPI und sein Commit müssen in einem Batch reisen, sonst landet der Commit in einer eigenen LUW und die Änderungen des BAPI gehen verloren:
{
"tool": "callFunctionsViaJsonRpc",
"args": {
"calls": [
{
"functionModuleName": "BAPI_USER_LOCK",
"inputParameters": { "USERNAME": "DEVUSER" },
},
{
"functionModuleName": "BAPI_TRANSACTION_COMMIT",
"inputParameters": { "WAIT": "X" },
},
],
},
}Der vollständige Schreibzyklus (Sperren → Ändern → Prüfen → Aktivieren → Freigeben), der Debugger, ATC und alle weiteren Workflows stehen in docs/MCP-Tools.md §4.
Mit ABAP-Arbeiten
Drei Werkzeuge decken den Großteil Ihrer Bedürfnisse ab, und jedes nimmt einen Name anstatt eine ADT-URL:
Gewünscht | Werkzeug |
Den Quelltext einer Klasse, Programms, zinklusive Funktionsgruppe oder Modul |
|
Wie eine Tabelle, Struktur oder Sicht sieht |
|
Alles hintereiner Namenskonvention |
|
{"tool":"readAbapObject", "args":{"objectName":"ZCL_MY_CLASS"}}
{"tool":"describeAbapTable","args":{"tableName":"T000"}}
{"tool":"searchPackages", "args":{"patterns":["ZPP_*","Z_PP*"]}}readAbapObject liefert die Metadaten und den Quelltext in einem Aufruf. Wenn ein Name zu mehreren Objekten gehört — ZPP_EXT_LABEL_DATA ist sowohl eine Funktionsgruppe als auch ein Funktionsmodul — wählt es die spezifischere Variante und teilt das über die Fälle ambigu:true und alternatives mit; Übergeben Sie dagegen objectWithType, die die Auswahl erzwingen. Objekte ohne Quelltext kommen mit hasSource:false und einem Hinweis auf das richtige Werkzeug zurück.
describeAbapTable liefert Feldnamen, DDIC-Typen, Längen, Schlüsselflags, Datenelemente, Domänen und Check-Tabellen — die Check-Tabelle ist das Ziel des Fremdschlüssels und damit der schnellste Weg zu sehen, wie zwei Tabellen zusammen verbunden werden. objectStructure liefert für eine Tabelle keine Felder, und tableContents liefert Zeilen statt einer Definition, also beantwortet keines die Frage, wie eine Tabelle aussieht.
Regeln, die Sie in das System-Prompt Ihres Clients aufnehmen sollten
Bevorzugen Sie die By-Name-Werkzeug zeigen Sie auf Sie zuzugreifen. Fallen Sie nur bei Bedarf auf
searchObject→objectStructure→getObjectSourcezurück, wenn Sie die Zwischenergebnisse benötigen. Verwenden Sie niemals in/sap/bc/adt/...-Pfadkette.Selektieren Sie effizient. SAP-Tabellen sind groß. Wenn Sie
SELECTs aufWHEREeingeschränken, und verwenden SieSELECT SINGLE(alle Schlüsselfelder bekannt) oderUP TO n ROWS.
SELECT vgbel FROM vbrp WHERE vbeln = @lv_vbeln INTO @DATA(lv_vgbel) UP TO 1 ROWS.
EXIT.
ENDSELECT.SAP ist vom Dateisystem entkoppelt: Das Lesen von Quelltext liefert es nur als Werkzeugereignis und das Schreiben einer lokalen Datei ändert nichts in SAP. Lokale Kopien sind nur für Unterschiede (diffing) brauchbar, mehr nicht.
Frühere READMEs listeten
GetTable,GetStructureundGetTypeInfo. Diese gehören zum separaten Zweigmcp-abap-adt, nicht zu diesem Server.
Entwicklung
npm run build # tsc -> dist/
npm test # vitest: parser, tool catalogue, JSON-RPC handler (no SAP system needed)
npx tsc --noEmit # type check onlyTests liegen in src/__tests__ und laufen komplett offline — die JSON-RPC-Suite testet den Handler end-to-end gegen einen simulierten SAP Gateway-Knoten.
Gegen ein echtes System (benötigt ein Kerberos-Ticket), lautet der End-to-End-Check:
npm run build
node scripts/live-jsonrpc-check.mjs # add NODE_TLS_REJECT_UNAUTHORIZED=0 for an internal CADieser treibt den gebauten Server über MCP-Stdio genau wie ein Client und ruft nur gelesene Funktionen auf.
Ein Tool hinzuzufügen ist eine Änderung in einer Datei — siehe docs/MCP-Tools.md §10.
TroubleshootingKerberos-Modus — das Image enthält ein curl, das gegen GSS-API gebaut wurde, und kinit, es bleibt also nur noch ein Realm und ein Credential:
docker run -i --rm --env-file .env \
-v /etc/krb5.conf:/etc/krb5.conf:ro \
-v /host/agent.keytab:/krb5/agent.keytab:ro \
-e SAP_KRB_KEYTAB=/krb5/agent.keytab \
-e SAP_KRB_PRINCIPAL=SVC_AGENT@CORP.EXAMPLE.COM \
abap-adt-mcpOAuth-2.0-Modus — nichts einzubinden; das Credential wird geholt:
docker run -i --rm --env-file .env \
-e SAP_OAUTH_TOKEN_URL=https://your-tenant.authentication.eu10.hana.ondemand.com/oauth/token \
-e SAP_OAUTH_CLIENT_ID='sb-abap-agent!t1234' \
-e SAP_OAUTH_CLIENT_SECRET=<clientsecret> \
abap-adt-mcpPasswort-Modus — letzte Möglichkeit!
docker run -i --rm --env-file .env \
-e SAP_USER=YourUser \
-e SAP_PASSWORD=YourPassword \
abap-adt-mcpDrei Dinge, die Sie wissen sollten, bevor Sie darauf zurückgreifen:
Ein Keytab, nicht Ihr eigenes Ticket. Ein Container kann die Anmeldedaten der Sitzung nicht so übernehmen wie eine interaktive Anmeldung. Auf einem Linux-Host können Sie den bereits vorhandenen Ticket-Cache einhängen (
-v /tmp/krb5cc_1000:/krb5/ccache:ro -e KRB5CCNAME=FILE:/krb5/ccache), aber er läuft mit dem Host ab. Von einem Windows-Host funktioniert keines von beidem: das TGT befindet sich im LSA-Cache und kann nicht in eine Datei geschrieben werden — verwenden Sie den Zertifikatsmodus, der nichts davon benötigt. Der Keytab ist das einzige Credential, das unbeaufsichtigt läuft, und das einzige, das die Ticket-Lebensdauer überdauert.Überprüfen Sie SAPs Zertifikat – oder wissen Sie, dass Sie es nicht tun. Das Image vertraunt nur dem öffentlichen CA-Bundle, daher ist eine interne CA, der der Host vertraut, hier unbekannt und der Handschlag schlägt mit
UNABLE_TO_GET_ISSUER_CERT_LOCALLYfehl. Hängen Sie die Root-CA ein und richten SieSAP_CA_FILEdarauf. Eine Desktop-.enveinfach komplett zu übernehmen, verschleiert das stattdessen:NODE_TLS_REJECT_UNAUTHORIZED=0ist eine Entwicklungseinstellung und hat in einem deployten Image nichts zu suchen.Aus einem Recurse-Submodules-Klon bauen.
skills/Developmentist ein Submodul; ohne es enthält das Image 35 Skills weniger.
Das Image ist aus einem Grund Debian statt Alpine: Alpines curl ist ohne GSS-API gebaut und ein solches curl scheitert nicht – es sendet einfach gared nie ein Token, und SAP wieder die gleiche 401 wie bei einem abgelaufenen Ticket. Was fehlt, wird beim Start auf stderr benannt, bevor eine Sitzung versucht wird. Um den Container zu fragen, mit welchem Credential er am Ende arbeitet, geben Sie ihm einen Befehl statt des Servers:
docker run --rm --env-file .env -v /host/agent.keytab:/krb5/agent.keytab:ro \
-e SAP_KRB_KEYTAB=/krb5/agent.keytab abap-adt-mcp klistdocs/, skills/ und AGENTS.md werden absichtlich in das Image kopiert – der Server liest sie zur Laufzeit, um readServerGuide, readSkill und die abap-adt://-Ressourcen zu bedienen. docs/Authentication.md §7 verfügt die vollständige Container-Einrichtung, Modus für Modus.
HTTP-Betrieb
Alles oben startet einen Server für einen Client über stdio. Setzen Sie stattdessen ABAP_MCP_TRANSPORT=http, um einen langlebigen Servercontainer für ein ganzes Clientteam über Streamable HTTP am /mcp zu laufen.
Der HTTP-Modus ändert, wer sich anmeldet, nicht, was eine Sitzung nach dem Logon tun kann: Keiner der oben genannten vier Modi – SAP_AP_MODE, SAP_CERT_FILE, SAP_OAUTH_CLIENT_ID, SAP_PASSWORD – gilt hier nicht, weil es keinen einzugeben logon gibt. Stattdessen authentifiziert jeder MCP-Client sich mit eigenem SAP-OAuth-2.0-Bearer-Token: Er sendet Authorization: Bearer <token> bei initialize, und dieses Token wird zur identität eines SAP-Logons – eine eigene ADT-Logon, eigen Sperren, eigene Audit-Trail. Zwei Teammitglieder, die sich verbinden, erhalten zwei unabhängige Sitzungen, nie einen gemeinsamen technischen Benutzer geteilt.
docker build -t abap-adt-mcp .
docker run --rm -p 3000:3000 \
-e SAP_URL=https://your-sap-server.example.com:44301 \
-e SAP_USER=CLAUDEAGENT \
-e SAP_CLIENT=100 \
-e ABAP_MCP_TRANSPORT=http \
abap-adt-mcpSAP_USER wird weiterhin benötigt (jeder Nicht-Passwort braucht einen Platzhalter-Benutzernamen für den ADT-Client), wird aber nie übertragen und hat keinen Einfluss darauf, welche Sitzung tatsächlich wird – SAP entscheidet aus jedem Sitzung über das eigenen Token, wie in §11.
| Variable | Effekt |
| ---- | – |
| ABAP_MCP_TRANSPORT=http | Schaltet von stdio auf HTTP um. |
| ABAP_MCP_HTTP_PORT | Port, auf dem lauscht. Standard 3000 |
| ABAP_MCP_HTTP_HOST | Adresse, an die gebunden wird. Standard 0.0.0.0 |
| ABAP_MCP_HTTP_ALLOWED_ORIGINS | Browser-Origins, die /mcp aufrufen dürfen, getrennt (,); * erlaubt alle. Leer (Standard) leer |
| ABAP_MCP_HTTP_ALLOWED_HOSTS | Host-Werte, die zugelassen werden, durch Komma getrennt. Leer = alle. |
| ABAP_MCP_HTTP_RATE_LIMIT | Anfragen pro Minute pro Sitzung. 0 (Standard) Aus. |
Registrieren Sie einen Client wie jeden anderen Streamable-HTTP-MCP-Server, und zeigen Sie auf /mcp/ und das SAP-OAuth-Token des Benutzers:
{
"mcpServers": {
"sap-abap-dev-100": {
"url": "http://your-host:3000/mcp",
"headers": { "Authorization": "Bearer <your SAP OAuth access token>" }
}
}
}Eine Anfrage ohne Credential wird mit 401 abgewiesen (fehler Vor SAP-Verkehr; ein Token, das SAP verweigert, ebenfalls 401 mit SAP-eigener Meldung. Es gibt keinen zusätzlichen geheimen Schlüssel für den Transport – das SAP-Token ist die Zugriffskontrolle.
Ein Client, der bei jedem Ablauf nicht getrennt werden möchte, kann eigenes Refresh-Token als X-SAP-Refresh-Token senden und die Sitzung verlängert sich über den refresh_token-Grant. Dafür ist SAP_OAUTH_TOKEN_URL`` und SAP_OAUTH_CLIENT_ID` am Container nötig – die Client-Registrierung, gegen die der Refresh-Token eingelöst wird, gehört Deployment, während das Refresh-Token und damit SAP-Identität beim Aufrufer bleibt.
Browser-Origins werden nicht angenommen, wenn sie nicht ABAP_MCP_HTTP_ALLOWED_ORIGINS genannt werden: Das ist der DNS-Rebind-Schutz, denn die MCP-Spezifikation verlangt, dass der Server selbst die Rebinding-Anfragen nicht durch den Proxy durchläuft. Erlaubte Origins erhalten die passenden CORS-Header. Clients ohne Origin – also jedem MCP-Client ohne Webseite – werden nicht betroffen.
Das docker-entrypoint.sh des Containers überspringt das Kerberos-Setup automatisch, wenn ABAP_MCP_TRANSPORT=http gesetzt ist, denn der Auswahl von resolveAuthrn() beschreibt in diesem Modus nichts Reales pro Session. TLS-Terminierung überlädt dem vor dem Container liegenden Prozess (Reverse-Proxy/Ingress), wie bei jedem inneren HTTP-Dienst. Details und die OAuth-Grant-Mechanik in docs/Authentication.md §12.
Mehr als ein System
Ein Server ist an ein System und eine Client-Cl und für seine gesamte Lebenszeit gebunden – keine zur Laufzeit umschaltbar. Also registrieren Sie Eintrag pro System und Client, und geben Sie jedem eine eigene SAP_SYSTEM_ID:
"sap-abap-dev-100": { "env": { "SAP_SYSTEM_ID": "DEV", "SAP_CLIENT": "100", "…": "…" } },
"sap-abap-dev-200": { "env": { "SAP_SYSTEM_ID": "DEV", "SAP_CLIENT": "200", "…": "…" } },
"sap-abap-q01-100": { "env": { "SAP_SYSTEM_ID": "Q01", "SAP_CLIENT": "100", "…": "…" } }Noch Server kennzeichnet sich in den MCP-instructions, das bei Connect zurückgibt:
Dieser Server ist an SAP-System DEV, Client 100 gebunden (https://, 44301). Es kann nicht System/Client zur Laufzeit wechseln — beide sind durch die Umgebung festgelegt. Wenn eine Anfrage ein anderes System oder Client nennt, verwenden Sie den MCP-Server dafür; wenn keiner registriert ist, handeln Sie nicht hier.
Das ist es, warum ein Agent „bitte das in DEV/Client 200“ zum richtigen Server ohne Aufruf routen kann. healthcheck meldet dieselbe Identität für direkte Fragen.
Die Angabe wird geprüft. SAP benennt das System und den Client im Session-Cookie bei Logon (SAP_SESSIONID_DEV_100), damit der Server weiß, was wirklich verbunden ist. Falls das von ABAP_MCP_TRANSPORT ... widerspricht (z.B. falscher Host), setzt healthcheck eine WARNING und es wird beim Start laut geloggt. Beobachtenswert wenn Werkzeuge einwandfrei funktionieren, doch auf falschem System.
Quick tour
Objekt per Name lesen — kein URL-Discovery:
{"tool":"readAbapObject","args":{"objectName":"ZCL_MY_CLASS"}}
{"tool":"describeAbapTable","args":{"tableName":"T000"}}Zoll Namenskonvention erfassen – Muster normalisiert, zpp_lab wird ZPP_LAB*:
{ "tool": "searchPackages", "args": { "patterns": ["ZPP_*", "Z_PP*"] } }
// -> each package with its objects grouped by type, sub-packages, and a `truncated` flagFunktion Modul aufrufen – Signatur zuerst laufen um zu validieren:
{"tool":"readAbapFunctionModule","args":{"functionModuleName":"STFC_CONNECTION"}}
{"tool":"callFunctionViaJsonRpc","args":{"functionModuleName":"STFC_CONNECTION",
"inputParameters":{"REQUTEXT":"hello"}}}Ein BAPI und sein Commit müssen in einem Laufwerk sein, sonst commit in eigener LUW und Änderung gehen verloren:
{
"tool": "callFunctionsViaJsonRpc",
"args": {
"calls": [
{
"functionModuleName": "BAPI_USER_LOCK",
"inputParameters": { "USERNAME": "DEVUSER" },
},
{
"functionModuleName": "BAPI_TRANSACTION_COMMIT",
"inputParameters": { "WAIT": "X" },
},
],
},
}Der vollständige Schreibzyklus (Lock → Modl → Check → Activate → Unlock), Debugger, ATC und jede andere Workflow liegen in docs/MCP-Tools.md §4.
Im Umgang mit ABAP-Objekten
Drei Tools decken die meistens ab, jedes nimmt einen Namen und keine ADT-URL:
Was | Tool |
Quelle einer Klasse, Programm, Include, Funktionsgruppe oder Moduls |
|
Um rechnung einer Tabelle/Struktur/Ansicht |
|
Alles hinter einer Namenskonvention |
|
{"tool":"readAbapObject", "args":{"objectName":"ZCL_MY_CLASS"}}
{"tool":"describeAbapTable","args":{"tableName":"T000"}}
{"tool":"searchPackages", "args":{"patterns":["ZPP_*","Z_PP*"]}}readAbapObject gibt Metadaten sowie Quelltext. Wenn ein Name mehrere Objekte hat — ZPP_EXT_LABEL_DATA ist Funktionsgruppe und Modul —, wählt spezifisch und meldet ambiguous:true mit alternatives; geben Sie objectType zur Auswahl. Keine Quelle Objekte kommen mit hasSource:false und Hinweis für Richti.
describeAbapTable liefert Feldernamen, DDIC-Typen, Längen, Key-Flags, Datenelemente, Domänen und Check-Tabellen — die Check-Tabelle ist das Foreign-Key-Ziel, so zwei Tabellen schnell zu verknüpfen. objectStructure liefert dafür keine Felder, und tableContents gibt Zeilen (keine Def), daher beantwortet keines „wie sieht die Tabelle aus?
Regeln in den Systemprompt des Kunden
Bevorzugt die By-Name-Tools; Nur
searchObject→Object→getObjectSource, wenn Sie Zwischenergebnisse benötigen. Handschriftliche/sap/bc/adt/...Pfade benutzen nicht.Effizient abfragen – SAP-Tabellen sind groß.
SELECTs mitWHEREeinschränken,SELECT SINGLE() oderUP TO ROWS.
SELECT vgbel FROM vbrp WHERE vbeln = @lv_vbeln INTO @DATA(lv_vgbel) UP TO 1 ROWS.
EXIT.
ENDSELECT.SAP ist nicht Ihr Dateisystem: Quelltext nur als Tool, lokale Datei bewirkt nichts. Lokale Kopie nur zum Differenzen.
Frühere README listeten
GetTable,GetStructure,GetTypeInfo. Diese gehören zum separatenmcp-abap-adt, nicht hier.
Entwicklung
npm run build # tsc -> dist/
npm test # vitest: parser, tool catalogue, JSON-RPC handler (no SAP system needed)
npx tsc --noEmit # type check onlyTests in src/__tests__, laufen offline– JSON-RPC-Suite testet den Handler E2E gegen Fakes SAP Gateway Mocknode.
Gegenechtes System (Kerberosticket) ist der Ende-zu-Ende-Check:
npm run build
node scripts/live-jsonrpc-check.mjs # add NODE_TLS_REJECT_UNAUTHORIZED=0 for an internal CADer den gebauten Server über MCP-Stio treibt, wie ein Client, und ruft nur read-only funktion.
Ein Tool hinzufügen: Siehe docs/MCP-Tools.md §10.
Troubleshooting
Symptom | Ursache / Lösung |
| Kerberos-Modus: kein gültiges Ticket, oder das System akzeptiert SPNEGO nicht — prüfen Sie |
| Das SSO-Bootstrap konnte curl nicht finden — setzen Sie |
| Die |
| Interne CA. Setzen Sie |
RFC-Tools liefern | Führen Sie |
| Er existiert nicht, ist nicht RFC-fähig, oder |
Client zeigt keine Tools an | Prüfen Sie den absoluten Pfad zu |
Mehr dazu in docs/MCP-Tools.md §8.
Mitwirken
Forken Sie das Repository.
git checkout -b feature/your-feature-nameNehmen Sie Ihre Änderungen vor und halten Sie
npm testundnpx tsc --noEmitgrün.git commit -m "Add some feature"undgit push origin feature/your-feature-nameEröffnen Sie einen Pull Request.
Lizenz
MIT. Upstream-Projekt und ursprünglicher Autor: mario-andreschak.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Related MCP Connectors
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Single-connection MCP gateway discovering and executing 490+ verified MCP & A2A tools.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
2,000+ MCP servers read at source level. Know what one does before you connect. Free, no key.
Related MCP Servers
- AlicenseCqualityNot gradedmaintenanceAn MCP server that facilitates seamless interaction with SAP ABAP systems to manage development objects, transport requests, and source code. It provides a comprehensive suite of tools for performing syntax checks, object searches, and code modifications via the ADT API.100-
- AlicenseCqualityDmaintenanceAn MCP server that enables seamless communication between ABAP systems and MCP clients using the ABAP Development Tools (ADT) API. It provides tools for managing ABAP objects, handling transport requests, and performing code analysis directly through MCP-compatible interfaces.100MIT
- AlicenseNot gradedqualityDmaintenanceA standalone MCP server for SAP ABAP development and customizing that connects directly to your SAP system via ADT REST API, enabling AI assistants to search, read, write, activate, transport, debug, and run quality checks on ABAP code, as well as manage customizing/IMG configurations with governed transport recording.MIT
- AlicenseBqualityDmaintenanceMCP server for SAP ABAP development that enables AI assistants and code editors to interact with SAP systems via ABAP Developer Toolkit (ADT) APIs, supporting read, create, update, and delete of ABAP objects.100MIT