sap-abap-mcp
SAP ABAP MCP Server (ADT and JSON RPC)
AI 에이전트가 ADT(ABAP Development Tools)를 통해 SAP ABAP 시스템에 대한 완전한 읽기/쓰기 권한을 갖게 해주는 MCP 서버입니다. 인증은 SPNEGO/Kerberos 싱글 사인온, XET x.509 클라이언트 인증서 또는 OAuth 2.0 베어러 토큰을 사용하며 — 설정 어디에도 비밀번호가 들어가지 않습니다. 사용자 이름과 비밀번호 방식도 폴백으로 여전히 사용할 수 있지만 권장되지는 않습니다!
이 서버는 abap-adt-api를 감싸고, ADT 자체로는 할 수 없는 한 가지를 추가합니다: RFC 지원 함수 모듈 호출을 SAP Gateway의 JSON-RPC 2.0 서비스를 통해 수행합니다.
128개의 도구 — 객체 CRUD, 소스 편집, 잠금, 콘스포트, 활성화, 축어 검사, 코드 완성, ABAP Unit, ATC, DDIC, abapGit, 리팩토링, 트레이스, 디버거, RFC 호출.
클라이언트가 실제로 보는 도구 수는 두 가지 이유로 더 줄어들니다. 프로파일(ABAP_MCP_PROFILE)은 도구의 수를 줄여 맥락(context)을 얻습니다. core는 9개 도구를, all은 129개 도구를 나열합니다. 즉 도구 스키마를 그때그때(on-demand) 가져올 수 없는 클라이언트에게 매 턴 약 2,700 토큰 대 약 17,800 토큰입니다. 그리고 서버는 무엇이든 나열하기 전에 시스템이 무엇을 지원하는지 시스템이 묻고, 그래서 abapGit 기능이 없는 릴리스에는 400을 반환하게 될 10개 도구가 제공되는 일이 없습니다. DEV에는 그러하여 118개가 남습니다.
이 프로젝트는 mario-andreschak의
mcp-abap-abap-adt-api의 SSO 포크입니다. 주요 차이점: Basic Auth 대신 사 문자열 Kerberos SSO 사용, JSON-RPC/RFC 도구, 도구 정의에서 파생된 루틴, 그리고 문서화된 도구 참조가 포함되어 있습니다.
문서
문서 | 다루는 내용 |
이 저장소에서의 작업하는 방법: 레이아웃, 컨벤션, 테스트 방법. 코드를 변경하기 전에 이것을 많이 읽으세요. | |
하고 싶은 일 → 그것을 해결할 해내는 도구. 실제 사용자의 표현에 맞게 직접 작성되었습니다. 작업은 알지만 어떤 도구가 있는지 모르면 여기부터 시작하세요. | |
모든 128개의 도구를 인수와 함께 계열별로 그룹으로 분류합니다. 도구 정의에서 자동 생성되므로 코드와 헤어지는 일이 없습니다. | |
서버가 어떻게 동작하는지. 프로파일, 골든 패스 워크플로우, ADT URI 및 잠금 의미론, 결습의 응답/오류 모델, 그리고 트라이슈팅 매체. 사람과 서버를 구동하는 폭군용으로 작성되었습니다. | |
20가지 SAP/ABAP 기능과 특성을 어떻게 매핑하는지. | |
기본 제공되는 일반 엔지니어링 스킬 35개. | |
| |
비밀번호 없는 두 로그인 방식: Kerberos SSO와 서비스/기술 사용자의 X.509 인증서. SAP에 필요한 설정과, 왜 이것이 SNC가 아니라 상호 TLS인지. |
Related MCP server: ABAP-ADT-API MCP-Server
기능
비밀번호 없는 두 로그온 방식 — 로그인한 Windows 사용자의 티켓을 이용한 SPNEGO/Kerberos, 또는 Kerberos ID가 없는 서비스/기술 사용자를 위한 X.509 클라이언트 인증서. 어느 쪽이든 SAP 암호는 변수 있거나 전송되지 않습니다, 세션이 만료되면 재인증됩니다.
하나의 컨테이너를 공유하는 팀을 위한 스트리밍 HTTP 전송 —
ABAP_MCP_TRANSPORT=http설정하면 연결되는 각 MCP 클라이언트가 자신의 SAP OAuth 2.0 베어러 토큰으로 인증합니다. 따라서 모든 세션은 하나의 기술 사용자를 공유하지 않고 각각 다른 SAP 로그를 얻습니다. stdio는 지정된 단일 로컬 클라이언트의 기본값입니다. §12와 아래 HTTP로 실행을 참조하십시오.이름으로 모든 객체 읽기 —
readAbapObject는 이름을 소스로 변환해주는 한 번의 호출으로, ADT URL을 찾거나 만들 필요가 없습니다.테이블 설명 —
describeAbapTable은 더블 필드, DDIC 유형, 키 플래그 및 확인 테이블을 반환합니다.객체 관리 — ABAP 객체를 검색, 읽기, 생성, 수정, 삭제 및 활성화합니다.
관련 이름 규칙 조사 —
searchPackages는 패턴(["ZPP_*","Z_PP*"])으로 패키지를 찾고 한 번의 호출으로 각 패키지를 유형별로 그룹화된 객체로 확장합니다.소스 워크플로 — 잠금 → 편집 → 구문 검사 → 활성화 → 잠금 해제, 교통 처리 포함.
코드 인텔리전스 — 코드 완성, 정의, 사용 참조, ABAP Doc, pretty printer, ATC, ABAP Unit, 리팩토링(이름 변경, Extract Method).
RFC 함수 모듈 호출 —
callFunctionViaJsonRpc는 RFC 함수 사양 함수 모듈을 실행하고 시스템에서 읽은 실제 서술에 요청이 맞는지 검증합니다.하나의 LUW에서 RFC 호출 일괄 처리 —
callFunctionsApiJsonRpc는 여러 함수 모듈을 하나의 요청으로 보내, 업데이트 BAPI와 이BAPI_TRANSACTION_COMMIT가 동일한 LUW를 공유할 수 있게 합니다.데이터 접근 —
tableContents및 임시runQuerySELECT.실행 중인 시스템 확인 —
listLoggedOnUsers가TH_USER_LIST에서 “누가 는”를 알려주고(이 데이터는 SM04의 기본 데이터),readProfileParameters는 한 번에 왕복으로 RZ11 파라미터를 읽고,checkLogonConfiguration은 시스템이 실제로 어떤 인증을 받는지 설명합니다.기본 제공 에이전트 스킬 —
skills/디렉토리에 ABAP(Clean ABAP, RAP, CDS, ATC, abapGit…)과 일반 개발(TDD, 코드 리뷰, 버그 를 판)을 위한 54개의 스킬, Ric They provide them and are served as과readSkill로가 제공됩니다.스스로 문서화 — 아래의 관문은 서버 그 자체가 MCP 리소스(
abap-adt://guides/…)와readServerGuide도구를 통해 제공하므로, 에이전트는 세션 밖으로 나가지 않고도 도중에 작업이나 인수를 찾아볼 수 있습니다.
요구 조건
ADT로 접근 가능한 SAP ABAP 시스템이 있어야 함.
/sap/bc/adt가SICF에서 활성해야 합니다. RFC 도구의 경우/sap/gw/jsonrpc도 활성(SOAP_GWFND)이어야 하며, 호출한 함수 그룹에 대한S_RFC권한이 있어야 합니다.비밀번호 없이 로그온 하는 방법 중 하나를 갖추어야 합니다. 하나:
동작하는 Kerberos 로그인 — SAP 시스템이 SPNEGO를 수용하고 유효한 티켓을 지니고 있어야 합니다(
klist). 이것은 기본이며, 배포본으로 그대로 사용할 때는 Windows 필요합니다: 부트스트랩 스크립트가C:\Windows\System32\curl.exe --negotiate를 외부 프로세스로 실행하는데, 이 기능는 curl의 Schannel/SSPI 백엔드가 필요합니다. 다른 OS에서는SSO_CURL_PATH를 GSS-API 지원으로 빌드된 curl로 채워주세요.X.509 클라이언트 인증서 — Kerberos ID가 없는 서비스/기술 사용자를 위한 것입니다. curl도 Windows도 불필요합니다. SAP에서 준비 조건이 있습니다: ICM 포트에서 인증서를 요청해야 하며(
icm/server_port_<n>의VCLIENT;icm/가 HTTPS/verify_client를 덮어씁니다), 발급자에 CA를스트나에서 신뢰하고,CERTRULE이 사용자 계정에 매핑해야 합니다. 해당 설정 확인 방법을 포함한 전체 설정은docs/Authentication.md에 있습니다.OAuth 2.0 클라이언트 — Kerberos 도메인도 이야기할 ICM도 없는 SAP BTP ABAP 환경, 또는
SOAUTH2를 통해 ADT를 공개하는 on-premise 시스템에서 사용합니다. BTP 서비스 키도 이미 그러한 클라이언트입니다. §11을 참고.
Node.js (LTS) 와 npm —
node -v와npm -v로 확인합니다.
설치
git clone --recurse-submodules https://github.com/Ciltress/sap-abap-mcp.git
cd sap-abap-mcp
npm install
npm run build
--documents는 중요합니다. 일반 엔지니어링 스킬이 미세 목록(submodule)에 살고 있어, 그 옵션이 없으면 그 디렉토리는 비어 있게 되고 서버가 제공하는 스킬이 35개 줄어듭니다. 이미 경로클론했나요? 그러면git submodule update --init --recursive를 실행하세요.
npm에 있는
npx mcp-abap-abap-adt-api패키지는 업스트림(upstream) 서버이며 SSO 부스트 랩이나 RFC 도구를 포함하지 않습니다. 대신 이 저장소를 소스에서 빌드하세요.
구성
.env.example을 .env로 복사하고 내 시스템의 값을 아니면 채우세요:
SAP_URL=https://your-sap-server.example.com:44301
SAP_USER=YOUR_SAP_USER
SAP_CLIENT=100
SAP_LANGUAGE=ENSAP_URL와 SAP_USER은 필수이며, SAP_CLIENT와 SAP_LANGUAGE는 선택이지만 권장입니다. 네 가지 로그온 방식 중 세 가지는 SAP_PASSWORD가 전혀 필요없습니다.
.env는 로컬 커밋하지 마세요. 이미 .gitignore에 등록되어 있습니다.
선택적 변수 | 효과 |
| 시스템 id. |
| 내부/알 수 없는 CA의 인증서를 허용한다. 개발 전용. |
| Windows 시스템 기본 curl이 아닌 경우, SPNEGO를 지원하는 curl 바이너리 경로. |
| 노드가 별칭으로 게시된 경우, JSON-RPC ICF 경로를 재정의한다. |
| 이 서버가 나열할 도구 — 그리고 결국 응답할 도구 — 를 결정한다. 아래 참고. |
| 단일 응답의 상한(바이트). |
|
|
| SAP가 이 사용자에게 ADT 노드를 거부해도 RFC 도구를 유지한 채 시작한다. docs/Authentication.md 참고. |
| 폴백 로그온이 사용하는 ICF 노드. 세션 쿠키와 CSRF 토큰만 발급하면 된다. |
|
|
| Streamable HTTP 엔드포인트의 포트. 기본값 |
|
|
|
|
|
|
|
|
클라이언트에 맞춰 서버 크기 조정
세 가지 ABAP_MCP_* 변수는 한 가지 이유로 존재한다. 도구 스키마를 요청 시 가져올 수 없는 클라이언트는 매 턴마다 도구 목록 전체를 비용으로 지불한다. Claude Code는 스키마를 지연 호출하므로 기본값을 그대로 두면 된다. 128k 창을 가진 8B 모델은 대화가 시작되기 전에 컨텍스트의 6분의 1을 소모한다. "같은 프롬프트가 절반의 확률로만 동작한다"는 이야기의 출처가 바로 이것이다.
ABAP_MCP_PROFILE — 설정하지 않으면 all을 의미하므로 기존 구성은 그대로 유지된다.
프로필 |
| 턴당 비용 | 용도 |
| 9 | ~2,737 tokens | 시스템을 읽고 한 번의 편집을 완료하기 위한 용도 |
| 18 | ~3,982 tokens | 읽기 전용: 사전(딕셔너리), 테이블 데이터, RFC 호출 |
| 10 | ~2,900 tokens | RFC 권한은 있지만 |
| 49 | ~8,034 tokens | 편집 주기와 테스트, ATC, 트랜스포트, 리팩터링 |
| 129 | ~17,759 tokens | 기본값; 스키마를 요청 시 가져오는 클라이언트에 적합 |
숫자에는 healthcheck가 포함된다. healthcheck는 "지금 어떤 프로필로 실행 중인가?"를 답하는 도구이므로 모든 프로필 밖에 위치한다.
프로필은 편의 필터가 아니다. 활성 프로필 밖의 도구는 목록에도, 라우팅에도 나타나지 않으므로 호출할 수 없다. 따라서 analyst는 단지 작은 메뉴일 뿐 아니라, 소스 코드를 수정할 수 없음을 보장한다. 프로필 밖의 호출은 "알 수 없는 도구" 대신 그 이유를 명시한 오류를 받으므로, 다시 시도할 필요가 없다. 인식할 수 없는 프로필 이름은 기본값처럼 all로 폴백하지 않고 서버 시작을 중단시킨다. 9개 도구를 요청한 쪽에 129개를 조용히 나열하는 것은 프로필이 원래 막으려던 그 실패이기 때문이다.
core는 작다. 완전한 편집 주기 — 잠금, 쓰기, 활성화, 잠금 해제 — 를 하나의 도구 editAbapSource가 수행하고, 어떤 단계가 실패해도 잠금을 해제하기 때문이다. 개별 단계 네 가지는 dev와 all에 남아 있다.
ABAP_MCP_MAX_RESPONSE_BYTES — 도구 목록은 프로필이 줄일 수 있는 고정 비용이지만, 각 답변 자체는 상한이 없다. core에서 전체 도구 목록은 약 ~11KB인 반면 adtDiscovery 하나가 약 ~42KB이다. 미설정으로 두면 프로필을 따른다(core 24,000 bytes, analyst 32,000, dev 48,000, all 상한 없음). 0으로 지정하면 제한을 없앤다.
예산을 초과한 답변은 보류되고 유효한 JSON으로 대체된다 — status:"truncated", 원래의 bytes, budget, 2,000바이트의 preview, 그리고 nextStep을 포함한다. 절단된 부분으로 대체되지 않으며, 그런 단편은 파싱이 되지 않아 동일한 재시도를 유발할 뿐이다.
ABAP_MCP_GATE — 서버는 목록을 만들기 전에 시스템이 지원하는 것을 묻고, ADT 컬렉션이 없는 도구를 목록에서 제외한다. DEV에서 그런 도구는 abapGit 도구 10개와 서비스 바인딩 도구 3개이며, 이 도구들을 그대로 두면 HTTP 400으로 응답한다. 게이트 검사는 프로세스당 한 번의 디스커버리 왕복 비용이 들고 목록을 줄일 수만 있으며, 어떤 실패가 발생하면 모든 도구 리스트를 그대로 남긴다. ABAP_MCP_GATE=off이면 이 검사를 생략한다.
healthcheck는 세 가지를 모두 보고한다: 활성 프로필, responseBudgetBytes, 그리고 목록에서 제외된 도구들.
Kerberos 대신 인증서
서비스 또는 기술 사용자라면 인증서를 하나 추가하면 그 자체로 모드가 바뀐다:
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>선택적 변수 | 효과 |
|
|
| 개인 키가 |
| TLS 검증을 끄는 대신 SAP 자체 인증서를 검증하는 CA 번들. |
이것은 SNC가 아니라 상호 TLS이다 — ADT는 HTTPS다. RFC/SNC에서 이미 사용 가능한 인증서를 재사용 할 수 있고 그것이 이미 잘 동작하는 경우에는 매핑된 사용자 인증서가 그대로 이 월을 전달한다. 그러나
SNC0ACL은 관련이 없다. ICM 설정에는icm/HTTPS/verify_client를 켜야 한다.docs/Authentication.md에서 차이점,sapgenpse export_p12OpenSSL 3 함정과 거부된 인증서를 읽는 방법을 다룬다.
BTP 그리고 SOAUTH2를 위한 OAuth 2.0 클라이언트
SAP BTP ABAP 환경 또는 온프레미스 시스템이 ADT를 인증 서버 뒤에 서비스하는 경우다. 클라이언트 id를 설정하면 모드가 전환된다:
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'>온프레미스에서는 엔드포인트는 SAP 호스트 위에 위치한다 — https://<host>:<port>/sap/bc/sec/oauth2/token — 그리고 그 클라이언트는 SOAUTH2에 등록된 클라이언트이다.
선택적 변수 | 효과 |
|
|
| 요청할 스코프. 미설정이면 클라이언트의 기본 스코프를 요청하며, 이게 보통 옳다. |
|
|
| 다른 곳에서 발행된 access token으로, 그대로 사용된다. 이건 갱신할 수 없다. |
|
|
The access token logs on once. 이후에는 다른 모드와 똑같이 SAP 세션 쿠키가 모든 요청을 나른다. 따라서 5분 만료의 토큰은 문제되지 않는다. AS ABAP의 OAuth 2.0 클라이언트는
SU01안의 사용자라는 점을 기억하라. 틀린SAP_OAUTH_CLIENT_SECRET은 패스워드처럼login/fails_to_user카운트를 발생시키므로, 거부된 토큰 요청은 재시도되지 않는다. authorization-code flow는 구현되지 않았다. 이는 브라우저를 필요로 하는데, stdio로 시작된 서버에는 브라우저를 열 역량이 없어서다. 그 흐름은 한 번 손으로 완료해 refresh token 값을 넘겨라.docs/Authentication.md§11에 어떤 실패가 latch 되는지 왜 그런지 등 상세 설명이 있다.
다른 방법이 없을 때의 비밀번호
Kerberos도 인증서도 없는 시스템 — sandbox, trial 등 도메인과 무관한 모든 경우 — 를 위해 존재한다:
SAP_USER=CLAUDEAGENT
SAP_PASSWORD=<the password>The last resort, and it is not a substitute for the other two. 티켓 누락이나 인증서 매핑이 안 된 것은 단순히 거부된다. 반면에 wrong password는
login/fails_to_user_lock로 이어져 해당 사용자를, 이 서버뿐 아니라 그 자격 인증서를 가진 모든 다른 소비자에게도 잠글 수 있다. 그래서 구현체는 단 한 번 실패한 로그온을 그대로 latch로 저장하고, 호출된 도구가 몇 개가 되었든 재시도하지 않는다. 어떤 무인테인(attended) 이든, 인증서를 쪽을 더 선호하라. 자세한 내용은docs/Authentication.md§10 참고.
MCP client 등록
빌드된 엔트리 포인트를 절대 경로로 지정해 클라이언트를 연결한다:
{
"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"
}
}
}
}클라이언트의 env 블록은 .env보다 우선한다. 수동으로 서버를 시작하려면 npm run start, MCP 인터를 통해 서버를 구동하려면 npm run dev를 사용한다.
스키마를 매 턴마다 전체 전달하지 못하는 느낌 없는 클라이언트라면, 여기에 프로필 옵션을 추가하기:
"env": { "…": "…", "ABAP_MCP_PROFILE": "core" }Docker에서
기본으로 이 서버는 stdio에서 MCP를 교한므로, 노출할 포트가 없다 — 클라이언트가 컨테이너를 시작하고 stdin/stdout으로 통신한다. 이 섹션은 그 기본 사례를 다룬다. Docker컨테핸터 여러 팀원이 네트워크로 접속하려면 Running over HTTP를 살펴봐라.
GXP8 GXP9
네 가지 로그온 모드 모두 컨테이너에서 작동, 크레덴셸은 컨테이너가 부여받아야 하는 것이다. --env-file은 dotenv가 아니다 — Docker 는 따옴표를 제거하지 않고, export를 읽지 않고, # comment 주석 처리하지 않으므로, dotenv라면 지워먹였을 값이를 있는 그대로 받는다. .env 안의 Windows 경로는 mount된 경로로 바꾸어야 한다. Kerberon 컨테이너에서 가장 많이 요구되는 것이고, OAuth는 가장 적다. access token은 네트워크로 가져오므로, mount해야 할 전혀 아무것도 없다.
Certificate mode — key material을 read-only로 마운트하고, 거기에 SAP 의 인증서에 서명한 CA도 함께 마운트 시킨다:
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 모드 — 이미지에는 GSS-API 및 kinit에 맞게 빌드된 curl이 포함되어 있으므로, 남은 것은 realm과 자격 증명 하나입니다:
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 모드 — 마운트할 것이 없습니다. 자격 증명은 가져옵니다:
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-mcp비밀번호 모드 — 최후의 수단입니다!
docker run -i --rm --env-file .env \
-e SAP_USER=YourUser \
-e SAP_PASSWORD=YourPassword \
abap-adt-mcp이를 사용하기 전에 알아야 할 세 가지가 있습니다.
키탭이지 여러분의 티켓이 아닙니다. 컨테이너는 대화형 로그온처럼 세션의 자격 증명을 빌려쓸 수 없습니다. Linux 호스트에서는 이미 보유한 티켓 캐시를 마운트할 수 있습니다(
-v /tmp/krb5cc_1000:/krb5/ccache:ro -e KRB5CCNAME=FILE:/krb5/ccache). 그러나 그 캐시도 호스트의 것과 함께 만료됩니다. Windows 호스트에서는 둘 다 작동하지 않습니다. TGT는 LSA 캐시에 있으며 파일로 쓸 수 없습니다. 이런 것이 전혀 필요 없는 인증서 모드를 사용하세요. 키탭은 무인 실행이 가능한 유일한 자격 증명이며, 티켓 수명보다 더 오래 지속되는 유일한 자격 증명이기도 합니다.SAP 인증서를 확인하거나, 확인하지 않는다는 사실을 인지하세요. 이미지는 공용 CA 번들만 신뢰하므로, 호스트가 신뢰하는 내부 CA는 여기서 알 수 없고 핸드셰이크는
UNABLE_TO_GET_ISSUER_CERT_LOCALLY오류로 실패합니다. 루트 CA를 마운트하고SAP_CA_FILE이 그것을 가리키게 하세요. 데스크톱의.env를 통째로 가져오는 것은 이 문제를 숨길 뿐입니다.NODE_TLS_REJECT_UNAUTHORIZED=0는 개발용 설정이며, 배포된 이미지에 있을 이유가 없습니다.--recurse-submodules클론에서 빌드하세요.skills/Development는 서브모듈이며, 그것이 없으면 이미지에 스킬 35개가 빠진 채로 포함됩니다.
이미지가 Alpine 대신 Debian인 이유는 단 하나입니다. Alpine의 curl은 GSS-API 없이 빌드되며, 그런 curl은 실패하지 않습니다. 다만 토큰을 아예 보내지 않을 뿐이고, SAP은 만료된 티켓 때와 같은 401로 응답합니다. 무엇이 없는지는 세션을 시도하기 전에 시작 시 stderr로 명시됩니다. 컨테이너가 어떤 자격 증명을 최종적으로 사용했는지 묻고 싶으면, 서버 대신 명령을 주세요:
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/, AGENTS.md는 의도적으로 이미지에 복사됩니다. 서버는 런타임에 readServerGuide, readSkill, abap-adt:// 리소스를 제공하기 위해 이 파일들을 읽습니다. docs/Authentication.md §7에 모드별 전체 컨테이너 설정이 있습니다.
HTTP로 실행
위의 모든 것은 stdio를 통해 하나의 클라이언트를 위한 하나의 서버를 시작합니다. 대신 ABAP_MCP_TRANSPORT=http로 설정하면 /mcp에서 SDK의 Streamable HTTP 전송을 사용하는 네트워크를 통해 팀 전체가 연결하는 장기 실행 컨테이너를 실행하게 됩니다.
HTTP 모드는 누가 로그인하는지만 바꿉니다. 로그인 이후 세션이 무엇을 할 수 있는지는 바꾸지 않습니다. SAP_AUTH_MODE, SAP_CERT_FILE, SAP_OAUTH_CLIENT_ID, SAP_PASSWORD 등 이전의 네 가지 모드는 여기에 적용되지 않습니다. 구성할 단일 공용 로그인이 없기 때문입니다. 대신 모든 MCP 클라이언트는 각자 자신의 SAP OAuth 2.0 구성 토큰으로 인증합니다: initialize에서 Authorization: Bearer <token>을 보내며, 그 토큰은 그 세션 자체의 SAP identity — 즉 그 자체의 ADT 로그온, 자신 만의 잠금, 자신의 감사 추적—가 됩니다. 동시에 접속하는 팀원 두 명은 독립된 두 세션을 가지며, 절대 공유 기술 사용자가 되지 않습니다.
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는 여전히 필요합니다(모든 비비밀번호 모드는 ADT 클라이언트를 만들기 위해 자리 표시자 사용자 이름이 필요합니다). 그러나 이 값은 전송되지 않으며 특정 세션이 실제로 누구인지와는 아무런 관계가 없습니다. SAP가 각 세션의 자체 토큰에서 이를 결정하며, §11에서와 동일합니다.
변수 | 효과 |
| stdio에서 Streamable HTTP로 전환합니다. |
| 수신 입었을 포트입니다. 기본값 |
| 바인딩할 주소입니다. 기본값 |
|
|
| 응답할 |
| 세션당 분당 요청 수입니다. |
클라이언트는 다른 원격 Streamable HTTP MCP 서버와 동일한 방식으로 /mcp를 가리키고 해당 사용자의 SAP OAuth 토큰을 제공하여 등록합니다:
{
"mcpServers": {
"sap-abap-dev-100": {
"url": "http://your-host:3000/mcp",
"headers": { "Authorization": "Bearer <your SAP OAuth access token>" }
}
}
}자격 증명이 없는 요청은 어떤 SAP 트래픽도 없이 401로 거부됩니다. SAP 자체가 거부하는 토큰도 SAP의 자체 메시지와 함께 401입니다. 전송 자체에 대해 구성할 별도의 공유 비밀은 없습니다. SAP 토큰이 곧 접근 제어입니다.
클라이언트가 액세스 토큰이 만료될 때마다 연결이 끊기는 것을 원하지 않으면, 대신 X-SAP-Refresh-Token으로 자체 갱신 토큰을 보낼 수 있으며 세션은 refresh_token 부여로 스스로 갱신합니다. 이를 위해서는 컨테이너에 SAP_OAUTH_TOKEN_URL와 SAP_OAUTH_CLIENT_ID이 필요합니다. — 갱신 토큰이 상환되는 클라이언트 등록은 배포가 소유하지만, 갱신 토큰은 —— 따라서 SAP identity도 —— 호출자의 것입니다.
브라우저 오리진은 ABAP_MCP_HTTP_ALLOWED_ORIGINS에 이름이 explicitly 있는 경우에만 허용됩니다. 여기가 MCP 스펙이 서버 스스로 적용하도록 요구하는 DNS-리바인딩 보호입니다. 리바인딩 요청은 앞의 프록시를 전혀 통과하지 않기 때문이다. 허용 목록의 오리진에는 그에 해당하는 CORS 헤더가 제공됩니다. Origin을 보내지 않는 클라이언트 — 즉 웹 페이지가 아닌 모든 MCP 클라이언트 — 는 영향받지 않습니다.
ABAP_MCP_TRANSPORT=http가 설정되면 컨테이너의 docker-entrypoint.sh는 Kerberos 설정을 자동으로 건너뜁니다. 모든 세션이 자기 토큰으로 로그인되면 resolveAuthMode()의 선택은 아무것도 실제로 설명하지 않기 때문입니다. TLS 종료는 컨테이너 앞의 무엇(리버스 프록시 또는 인그레스)이든 그 처리에 맡겨지며, 다른 내부 HTTP 서비스와 동일합니다. 이 과정이 귀결되는 OAuth 부여 메커니즘을 포함한 자세한 내용은 docs/Authentication.md §12에 있습니다.
하나 이상의 시스템
server은 수명 전체에 걸쳐 하나의 시스템과 하나의 클라이언트에 바인딩됩니다. — 둘 다 런타임에 전환할 수 없습니다. 따라서 시스템/클라이언트마다 하나의 항목을 등록하고 각각에 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", "…": "…" } }그러면 각 서버는 연결 시간에 반환하는 MCP instructions에 자신을 이렇게 선언합니다:
이 서버는 SAP 시스템 DEV, 클라이언트 100(https://…:44301)에 바인딩되어 있습니다. 런타임에는 시스템이나 클라이언트를 전환할 수 없습니다. — 두 가지 모두 시작된 환경에 고정되어 있습니다. 다른 시스템 또는 클라이언트를 지정하는 요청이 있으면 그에 맞게 구성된 MCP 서버를 사용하세요. 등록된 것이 없으면 이 서버는 여기에서 아무 작업도 하지 않습니다.
이 덕분에 에이전트는 "DEV 클라이언트 200에서 이것을 확인해 주세요"라는 요청을 어떤 도구 호출 없이 옳은 서버로 라우팅할 수 있고, 연결이 필요하면 바로 그 서버의 healthcheck가 같은 식별 정보를 보고합니다.
선언은 확인됩니다. SAP는 로그인 시 설정하는 세션 쿠키(SAP_SESSIONID_DEV_100)에 시스템과 클라이언트를 명시합니다. 따라서 서버는 실제로 어디에 연결되어 있는지 알 수 있습니다. 그 값이 SAP_SYSTEM_ID와 어긋나면 — 예를 들어 잘못된 호스트를 가리키는 복사-붙여넣기 항목 — healthcheck에 WARNING이 표시되고 시작 시 로그에 분명하게 남습니다. 짚어둘 만한 이유는 모든 도구가 계속 완벽하게 동작하기 때문입니다. 그냥 전혀 다른 시스템에서 동작하고 있다는 사실만 다를 뿐입니다.
빠른 둘러보기
이름으로 객체를 읽으세요 — URL을 찾을 필요가 없습니다:
{"tool":"readAbapObject","args":{"objectName":"ZCL_MY_CLASS"}}
{"tool":"describeAbapTable","args":{"tableName":"T000"}}명명 규칙 전체를 살펴보세요. — 패턴이 정규화되어 zpp_lab이 ZPP_LAB*가 됩니다:
{ "tool": "searchPackages", "args": { "patterns": ["ZPP_*", "Z_PP*"] } }
// -> each package with its objects grouped by type, sub-packages, and a `truncated` flag함수 모듈을 호출하세요. — 시그니처가 먼저 읽히고 그에 맞춰 요청이 검증됩니다:
{"tool":"readAbapFunctionModule","args":{"functionModuleName":"STFC_CONNECTION"}}
{"tool":"callFunctionViaJsonRpc","args":{"functionModuleName":"STFC_CONNECTION",
"inputParameters":{"REQUTEXT":"hello"}}}BAPI와 그 커밋은 하나의 배치에서 함께 이동해야 합니다. 그렇지 않으면 커밋이 자체 LUW에 빠지고 BAPI의 변경 내용이 손실됩니다.
{
"tool": "callFunctionsViaJsonRpc",
"args": {
"calls": [
{
"functionModuleName": "BAPI_USER_LOCK",
"inputParameters": { "USERNAME": "DEVUSER" },
},
{
"functionModuleName": "BAPI_TRANSACTION_COMMIT",
"inputParameters": { "WAIT": "X" },
},
],
},
}전체 쓰기 주기(lock → modify → check → activate → unlock), 디버거, ATC 및 기타 모든 작업 흐름은 docs/MCP-Tools.md §4에 있습니다.
ABAP 객체 작업
대부분의 필요한 일은 세 가지 도구가 처리하며, 각 도구는 ADT URL이 아니라 이름을 사용합니다:
원하는 것 | 도구 |
클래스, 프로그램, 인클루드, 함수 그룹 또는 함수 모듈의 소스 |
|
테이블, 구조 또는 뷰가 어떻게 생겼는지 |
|
명명 규칙 뒤의 모든 것 |
|
{"tool":"readAbapObject", "args":{"objectName":"ZCL_MY_CLASS"}}
{"tool":"describeAbapTable","args":{"tableName":"T000"}}
{"tool":"searchPackages", "args":{"patterns":["ZPP_*","Z_PP*"]}}readAbapObject는 메타데이터와 소스를 한 번의 호출로 반환합니다. 이름이 여러개 객체에 속할 때 — ZPP_EXT_LABEL_DATA은 함수 그룹이자 함수 모듈입니다 — 더 구체적인 것을 선택하고 ambiguous:true와 alternatives를 통해 알려줍니다. objectType을 전달하며 선택을 강제화할 수 있습니다. 소스가 없는 객체는 hasSource:false와 함께 정확한 도구를 안내하는 포인터를 반환합니다.
describeAbapTable은 필드 이름, DDIC 타입, 길이, 키 플래그, 데이터 요소, 도메인 및 체크 테이블을 제공합니다. — 체크 테이블은 외래 키 대상을 말하며, 두 테이블이 어떻게 조인하는 되는지 확인하는 가장 빠른 방법입니다. objectStructure는 테이블에 대해 어떤 필드도 반환하지 않고, tableContents는 정의가 아니라 행을 반환하므로, 두 자신(二者) 모두 "이 테이블은 어떻게 생겼나"라는 질문에는 답하지 못합니다.
클라이언트의 시스템 프롬프트에 넣어둘 가치가 있는 규칙
이름 기반 도구를 우선하세요. 중간 결과가 필요할 때만
searchObject→objectStructure→getObjectSource로 대체하세요./sap/bc/adt/...경로를 직접 만드는 일은 절대로 하지 마시세요.효율적으로 조회하세요. SAP 테이블은 큽니다. 항상
SELECT를WHERE절로 제한하고, 키 필드가 모두 알려졌을 경우SELECT SINGLE, 그 외에는UP TO n ROWS를 사용하세요.
SELECT vgbel FROM vbrp WHERE vbeln = @lv_vbeln INTO @DATA(lv_vgbel) UP TO 1 ROWS.
EXIT.
ENDSELECT.SAP은 파일 시스템과 분리되어 있습니다. 소스를 읽으면, 오직 도구 결과로만 반환되고, 로컬 파일을 쓴 이 SAP에는 아무것도 변경되지 않습니다. 로컬 복사본은 diff 외에는 쓸모가 없습니다.
이전 README에는
GetTable,GetStructure,GetTypeInfo가 나와 있었습니다. 그것들은 별도의mcp-abap-adt프로젝트에 속하며 이 서버의 위 항목 아닙니다.
개발
npm run build # tsc -> dist/
npm test # vitest: parser, tool catalogue, JSON-RPC handler (no SAP system needed)
npx tsc --noEmit # type check only테스트는 src/__tests__에 있고 완전히 오프라인으로 실행됩니다. — JSON-RPC 스위트는 가짜인 가짜인 SAP Gateway 노드를 상대로 핸들러를 끝까지(end-to-end) 실행합니다.
실제 시스템(크르바로스 티켓 필요)을 상대로 하는 종단 간 확인은 다음과 같습니다:
npm run build
node scripts/live-jsonrpc-check.mjs # add NODE_TLS_REJECT_UNAUTHORIZED=0 for an internal CA이것은 실제 클라이언트가 하는 것처럼 MCP stdio로 빌드된 서버를 구동하며 읽기 전용 함수 모듈만 호출합니다.
도구를 추가하는 것은 파일 하나만 수정하면 됩니다. — docs/MCP-Tools.md §10을 참조하세요.
문제 해결
증상 | 원인 / 해결 방법 |
모든 호출에서 | Kerberos 모드: 유효한 티켓이 없거나 시스템이 SPNEGO를 수락하지 않음 — |
| SSO 부트스트랩이 curl을 찾지 못함 — |
|
|
| 내부 CA. |
RFC 도구가 |
|
함수 모듈에서 | 함수 모듈이 존재하지 않거나 RFC가 활성화되지 않았거나 |
클라이언트에 도구가 표시되지 않음 |
|
자세한 내용은 docs/MCP-Tools.md §8을 참조하세요.
기여
저장소를 포크합니다.
git checkout -b feature/your-feature-name변경 사항을 적용하고
npm test와npx tsc --noEmit을 통과 상태로 유지합니다.git commit -m "Add some feature"및git push origin feature/your-feature-name을 실행합니다.Pull request를 열어 주세요.
라이선스
MIT. 업스트림 프로젝트 및 원저자: 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
Maintenance
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