1. SAP 侧 AI 助手接入的真实卡点SAP 生态里做 AI 助手难点从来不是模型本身而是 ABAP 系统与外部工具之间的通道怎么打通。ABAP 开发者想让 AI 帮忙读源码、查表、跑单测Basis 运维想让 AI 辅助看 Dump、做权限审计但两边用的协议不一样OData 管登录ADT 管开发对象RFC 管函数调用。三条通道各自为政AI 客户端根本不知道该怎么接。MCPModel Context Protocol就是来解决这个问题的。它把 AI 客户端和 SAP 之间的通信抽象成一套标准协议AI 侧只需要一个 settings.json 就能声明「我要连哪个 MCP 服务端」SAP 侧则通过 MCP 服务端把 OData、ADT、RFC 三条通道统一封装。你不需要在 ABAP 里写任何 HTTP 客户端代码也不需要让 Basis 单独开一堆端口。这篇面向两类人一是 ABAP 开发者想用 AI 助手做代码副驾二是 Basis 运维负责审批通道和 Key 的落地。核心交付三样东西可复制的 settings.json 骨架、MCP 服务端参数清单、三步连通性验证动作。实测下来只要 Key 校验、通道握手、ABAP 调用回显这三步走通后面接什么 AI 客户端都是改配置的事。2. TaoToken 在 MCP 通道里的位置TaoToken 在这里扮演的是统一 Key/API 通道的角色。MCP 服务端本身负责协议转换但它调用模型能力时需要一组稳定的 API 凭据。如果每个 AI 客户端各自配一套 KeyBasis 侧审计会疯掉。TaoToken 的做法是把 Key 收敛到一处MCP 服务端通过统一的 API 入口拿模型能力ABAP 侧只认 MCP 通道不直接碰模型 Key。具体来说MCP 服务端的 settings.json 里会有一个 provider 段指向 TaoToken 的 API 地址。模型对话、Coding Plan、API Keys 管理都在同一个控制台里完成。对 ABAP 开发者来说你只需要知道 MCP 服务端启动时会去校验这个 Key对 Basis 来说Key 的轮换和权限收敛在 TaoToken 控制台做不用动 SAP 系统配置。这里有个容易踩的坑MCP 服务端的 Key 校验是启动时做的如果 Key 失效服务端进程会直接退出AI 客户端侧看到的是「MCP server disconnected」而不是「401」。所以排障时先看 MCP 服务端日志别一上来就查 ABAP。3. settings.json 骨架与 MCP 服务端参数清单先给可复制的 settings.json 骨架。这个文件放在 AI 客户端的 MCP 配置目录下不同客户端路径不同但结构一致。{ mcpServers: { sap-abap-mcp: { command: node, args: [ PATH_TO/mcp-sap-multiprotocol/dist/index.js ], env: { TAOTOKEN_API_BASE: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的Key, SAP_MCP_MODE: stdio, SAP_MCP_LOG_LEVEL: info, SAP_MCP_TIMEOUT_MS: 30000 } } } }参数清单逐项说明。command 和 args 指向 MCP 服务端入口Windows 下路径用正斜杠或双反斜杠都行。env 段是重点参数作用建议值TAOTOKEN_API_BASE统一 API 入口https://taotoken.net/apiTAOTOKEN_API_KEY模型调用凭据控制台生成勿硬编码到仓库SAP_MCP_MODE通信模式stdio本地进程通信用这个SAP_MCP_LOG_LEVEL日志级别排障时用 debug日常 infoSAP_MCP_TIMEOUT_MS单次调用超时30000大文件下载可调到 60000注意 Key 不要写进版本控制。生产环境建议用环境变量注入settings.json 里只留占位符。Basis 侧如果要审计让开发者把 Key 的生成记录留在 TaoToken 控制台的 API Keys 页面别用共享 Key。MCP 服务端启动后会在本地起一个 stdio 通道AI 客户端通过标准输入输出和它通信。SAP 侧的 OData 登录信息由 MCP 服务端自己管理加密存在本地凭证库不经过 settings.json。这一点很关键settings.json 只管 AI 客户端到 MCP 服务端的连接不管 SAP 登录。4. 三步连通性验证配置写完别急着开 AI 客户端先做三步验证。这三步分别对应 Key 校验、通道握手、ABAP 调用回显任何一步失败都能定位到具体环节。4.1 Key 校验直接跑 MCP 服务端进程看它能不能拿到模型能力。命令行执行TAOTOKEN_API_KEYsk-你的Key node PATH_TO/mcp-sap-multiprotocol/dist/index.js --healthcheck预期输出里会有provider: ok和model: available。如果报provider: unauthorized说明 Key 无效或过期去 TaoToken 控制台的 API Keys 页面重新生成。如果报provider: timeout检查网络到 https://taotoken.net/api 的连通性别用任何非官方网络工具。这一步过了说明 MCP 服务端到模型通道是通的。4.2 通道握手Key 校验通过后验证 MCP 服务端到 SAP 三条通道的握手。MCP 服务端启动时会依次尝试 OData 登录、ADT 连接、RFC 连接。日志里会看到[odata] connect ok, session established [adt] channel ready [rfc] channel ready如果卡在[odata] connect检查 SAP 登录信息是否配在 MCP 服务端的本地凭证库里而不是 settings.json。如果[adt]或[rfc]失败通常是 SAP 侧的服务没激活让 Basis 确认 ADT REST API 和 RFC 网关是开启状态。4.3 ABAP 调用回显前两步都过了做一次真实的 ABAP 调用回显。在 AI 客户端里发一条最简单的指令比如「列出当前系统里所有 Z 开头的表」。MCP 服务端会走 ADT 通道查 DDIC返回结果里应该能看到具体的表名。如果返回空列表先确认 SAP 系统里确实有 Z 表如果报sanitizeObjectName failed说明对象名过滤规则拦了检查是不是带了非法字符。这一步走通整条链路就活了。5. 本篇常见错排查排障时按链路顺序查别跳步。下面几个是实测中高频出现的。MCP server disconnectedAI 客户端侧看到这个九成是 MCP 服务端进程挂了。先看服务端日志最常见的是 Key 失效导致启动退出。其次是 node 版本不匹配MCP 服务端要求 node 18 以上。odata_connect timeoutSAP 侧 OData 服务没响应。让 Basis 检查 SAP 网关的 OData 服务是否激活以及 MCP 服务端所在机器到 SAP 的网络是否放行。注意这里说的是企业内网连通性不是任何外部网络工具。ADT channel ready 但查不到源码ADT 通道通了但权限不够。MCP 服务端的角色配置里技术角色才能读源码业务角色只有只读清单。检查本地凭证库里的角色设置。RFC 调用返回 function not found函数名拼写或大小写问题。RFC 函数名在 SAP 里通常是大写MCP 服务端会做一次规范化但如果函数本身没激活也会报这个。让 ABAP 侧确认函数是 remote-enabled 状态。Key 校验通过但模型调用 401这种情况少见通常是 Key 的权限范围不对。TaoToken 控制台里每个 Key 可以限定可用模型检查这个 Key 是否绑定了你要用的模型。6. 接入与排障的下一步三步验证走通后日常使用就是改 settings.json 里的事。如果你主要做模型对话验证去模型对话页面直接试如果是长期编码和 Agent 场景Coding Plan 更适合Key 和额度管理都在里面Basis 侧要审计 Key 的生成和轮换在 API Keys 页面操作。接入文档里有完整的参数说明和排障清单遇到MCP server disconnected这类报错先翻文档再查日志。实测下来最容易忽略的是 MCP 服务端的日志级别。日常跑用 info 就行排障时改成 debug能看到每条通道的握手细节。另外 Key 别用共享的每个开发者一个 Key出问题能定位到人。SAP 侧的登录凭证由 MCP 服务端本地加密管理settings.json 里不要出现 SAP 密码这是红线。
