1. ABAP ADT 接 MCP server 时 endpoint 为什么必须改ABAP Development Tool for Visual Studio Code后面简称 ADT for VS Code是 SAP 官方给 ABAP 开发者做的 VS Code 扩展它把远端 ABAP 系统里的类、程序、CDS 视图、行为定义映射成 VS Code 工作区里的虚拟文件让你能在本地编辑器里做语法检查、激活、跑单元测试。MCP server 则是把 ABAP 系统能力包装成 tools 暴露给 coding agent 的一层服务agent 通过 MCP 协议调用这些 tools就能读取 ABAP 对象、改注释、触发激活。问题出在 endpoint 上。ADT for VS Code 默认走的是 SAP 系统直连地址而 MCP server 默认监听本地回环端口比如http://127.0.0.1:3000或http://localhost:8080。当你在 VS Code 里同时开 ADT 扩展和 MCP serveragent 发起的请求会先打到本地端口再由 MCP server 转发到 ABAP 系统。这条链路里只要有一环没配对就会撞上两类高频报错一类是local proxy failed意思是本地代理层连不上目标另一类是401 Unauthorized意思是请求到了服务端但凭证没被认。我试过在 Windows 和 macOS 上各跑一遍发现根因基本集中在三处。第一处是 MCP server 的baseUrl还写着localhost但 VS Code 的 virtual workspace 在远程容器或 WSL 场景下解析不到宿主机的回环地址。第二处是 API Key 没有注入到 MCP server 的启动环境里server 拿着空 token 去请求自然 401。第三处是 ADT 扩展的settings.json里abap.adt.mcp.endpoint这类字段没覆盖扩展仍然按默认地址发请求。把 endpoint 统一改到 TaoToken 的 API 通道本质上是让 MCP server 不再直连 ABAP 系统而是把请求交给一个稳定的 API 网关来转发。这样做的好处是凭证管理集中在一处回环地址问题被绕开401 也能通过统一的 Key 校验快速定位。下面我会给出可复制的settings.json片段以及一次完整的 MCP 调用验证动作帮你确认 ABAP 工具链和 MCP server 到底通没通。需要先明确一个边界TaoToken 在这里扮演的是 API 通道角色不是替代 ADT 扩展也不是替代 ABAP 系统本身。ADT 扩展负责虚拟文件系统映射MCP server 负责 tools 暴露TaoToken 负责请求转发和鉴权。三者各司其职缺一不可。2. 接入前把 TaoToken 的 Base URL、Key、Model ID 三件套备齐在动settings.json之前你得先把三件套拿到手Base URL、API Key、Model ID。这三样是 MCP server 能跑起来的最小集合缺任何一个都会在验证阶段报错。Base URL 用https://taotoken.net/api注意这个地址不带任何查询参数直接作为 MCP server 的baseUrl字段值。API Key 在控制台的 API Keys 页面创建创建后只显示一次复制下来存到环境变量里别硬编码进配置文件。Model ID 根据你实际要调用的模型填比如做代码补全和工具调用时选支持 function calling 的模型。创建 Key 的入口在这里https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。进去之后点新建给 Key 起个能认出来的名字比如abap-adt-mcp权限范围按最小必要原则勾选。创建完立刻复制页面刷新后就看不到了。如果你还没决定用哪个模型可以先到模型对话页面试一下工具调用能力https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。在对话里发一条带工具调用的请求看返回里有没有正确的 tool_calls 结构。这一步能提前排除模型不支持 function calling 的情况省得后面在 MCP server 里反复排查。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面写了 Base URL 的拼接规则和鉴权头格式。重点看两处一是请求头里Authorization: Bearer 你的Key的写法二是Content-Type: application/json不能少。这两处写错MCP server 启动时不会报错但第一次调用就会 401。三件套备齐后建议先在终端里用 curl 做一次裸请求确认 Key 本身有效。命令大概长这样curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: your-model-id, messages: [{role: user, content: ping}] }如果这条命令返回了正常的 JSON 响应说明 Key 和 Base URL 都没问题可以进入下一步配置。如果返回 401先检查 Key 有没有复制完整、有没有多余空格。如果返回 404检查 Base URL 有没有多写或少写路径段。这一步看起来简单但实际排障时能省掉大量时间。很多人一上来就改settings.json结果 401 报错分不清是 Key 问题还是配置问题。先用 curl 把 Key 单独验证一遍后面出问题就能快速定位到配置层。3. 可复制的 settings.json 与 MCP server 配置片段现在进入配置环节。VS Code 的用户级settings.json路径按平台分Windows 在%APPDATA%\Code\User\settings.jsonmacOS 在~/Library/Application Support/Code/User/settings.jsonLinux 在~/.config/Code/User/settings.json。工作区级配置放在项目根目录的.vscode/settings.json优先级更高建议 ABAP 项目用工作区级配置避免污染全局。先给 ADT 扩展的 endpoint 覆盖片段{ abap.adt.mcp.enabled: true, abap.adt.mcp.endpoint: https://taotoken.net/api, abap.adt.mcp.transport: http, abap.adt.mcp.timeout: 30000, abap.adt.mcp.headers: { Authorization: Bearer ${env:TAOTOKEN_API_KEY}, Content-Type: application/json } }这里有几个点要说明。abap.adt.mcp.endpoint填的是 TaoToken 的 Base URL不是本地回环地址。transport选http因为 TaoToken 走的是标准 HTTP 通道。timeout给 30000 毫秒ABAP 对象激活有时比较慢给太短会误报超时。headers里的Authorization用${env:TAOTOKEN_API_KEY}引用环境变量这样 Key 不会明文出现在配置文件里。环境变量怎么设Windows 用系统属性里的环境变量面板或者 PowerShell 里$env:TAOTOKEN_API_KEY你的Key。macOS 和 Linux 在~/.zshrc或~/.bashrc里加export TAOTOKEN_API_KEY你的Key然后source一下。设完重启 VS Code让扩展读到新环境变量。接下来是 MCP server 侧的配置。如果你用的是 Cline 或 Continue 这类支持 MCP 的扩展它们的配置文件格式略有不同。以 Cline 的 MCP settings 为例路径在~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonmacOS内容大概这样{ mcpServers: { abap-adt: { command: npx, args: [-y, your-scope/abap-adt-mcp-server], env: { TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: ${env:TAOTOKEN_API_KEY}, TAOTOKEN_MODEL_ID: your-model-id, ABAP_SYSTEM_URL: https://your-abap-system.example.com, ABAP_CLIENT: 100 } } } }这段配置里TAOTOKEN_BASE_URL指向 TaoToken 的 API 地址TAOTOKEN_API_KEY从环境变量读TAOTOKEN_MODEL_ID填你实际用的模型。ABAP_SYSTEM_URL和ABAP_CLIENT是 MCP server 转发到 ABAP 系统时需要的参数按你实际环境填。如果你用的是 Codex 的auth.json方案配置位置在~/.codex/auth.json格式是{ base_url: https://taotoken.net/api, api_key: 你的Key, model: your-model-id }注意auth.json里的api_key是明文所以这个文件权限要收紧chmod 600 ~/.codex/auth.json。生产环境建议还是走环境变量别把 Key 写进文件。配置改完后VS Code 需要重新加载窗口CtrlShiftP输入Reload Window让扩展重新读取settings.json和环境变量。重载后打开输出面板选 ADT 扩展的日志通道看有没有MCP endpoint resolved to https://taotoken.net/api这类信息。如果有说明 endpoint 覆盖生效了。4. 一次完整的 MCP 调用验证与成功结果判读配置写完不代表通了得做一次端到端验证。验证动作分三步启动 MCP server、在 agent 里触发一次 tool 调用、检查返回结果。第一步启动 MCP server。如果你用的是 Cline打开 Cline 面板它会在启动时自动拉起配置里的 MCP server。看 Cline 的 MCP 状态指示如果显示绿色或connected说明 server 进程起来了。如果显示红色或failed去输出面板看 stderr通常是command not found或env var missing。第二步在 agent 里发一条会触发 ABAP tool 的请求。比如在 Cline 的对话框里输入「读取 ABAP 类 ZCL_TEST_CLASS 的源码把第 10 行的注释改成 // updated by mcp」。agent 会先调用 MCP server 暴露的abap_read_class工具拿到源码再调用abap_update_source工具写回。第三步看返回。成功的标志有三个一是 agent 回复里明确说「已读取并更新」二是 MCP server 日志里出现POST https://taotoken.net/api/v1/chat/completions 200三是回到 ADT for VS Code 里刷新那个类能看到注释确实变了。如果你想更直接地验证可以绕过 agent直接用 curl 打 MCP server 的本地端口。假设 MCP server 监听http://127.0.0.1:3000发一条curl -X POST http://127.0.0.1:3000/mcp \ -H Content-Type: application/json \ -d { jsonrpc: 2.0, method: tools/call, params: { name: abap_read_class, arguments: {className: ZCL_TEST_CLASS} }, id: 1 }如果返回里result.content有 ABAP 源码说明 MCP server 到 TaoToken 再到 ABAP 系统的链路是通的。如果返回error里带401说明 Key 没注入成功。如果返回local proxy failed说明 MCP server 的baseUrl还指向本地地址没改成 TaoToken。成功结果判读有个小技巧看响应头里的x-request-id。TaoToken 每次请求都会返回一个 request id你拿这个 id 去控制台的请求日志里搜能看到这次调用的完整链路包括模型、token 消耗、耗时。这对排查间歇性失败特别有用。验证通过后建议把这次调用的配置和命令存成一个脚本比如verify-mcp.sh下次换环境时直接跑省得重新拼命令。脚本里把 Key 从环境变量读别写死。5. 401、local proxy failed、reading choices 三类报错怎么排排障环节按报错类型分。先看 401这是最高频的。401 的本质是服务端收到了请求但拒绝鉴权。在 ABAP ADT MCP TaoToken 这条链路里401 可能出现在两个位置MCP server 到 TaoToken 的请求以及 TaoToken 到 ABAP 系统的请求。区分方法是看 MCP server 日志里 401 出现在哪一跳。如果是 MCP server 到 TaoToken 这一跳 401检查三处Authorization头有没有拼成Bearer KeyKey 有没有多余空格或换行Key 有没有过期或被禁用。用前面那条 curl 命令单独验证 Key能快速排除。如果是 TaoToken 到 ABAP 系统这一跳 401检查 MCP server 的ABAP_SYSTEM_URL和ABAP_CLIENT有没有填对以及 ABAP 系统那边的通信用户有没有授权。这一跳的 401 通常伴随SAP相关的错误码日志里能看出来。再看local proxy failed。这个报错的字面意思是本地代理层失败根因通常是 MCP server 的baseUrl还写着http://localhost:xxxx或http://127.0.0.1:xxxx但 VS Code 运行在远程容器、WSL 或 SSH 远程场景下容器内的localhost指向容器自己不是宿主机。解决办法就是把baseUrl改成 TaoToken 的https://taotoken.net/api让请求走外部通道绕开回环地址解析问题。如果改了baseUrl还报local proxy failed检查 VS Code 的http.proxy设置有没有配错。有时候系统级代理会拦截请求导致 MCP server 连不出去。在settings.json里加http.proxy: 清空代理或者按实际网络环境填。第三类是reading choices报错。这个通常出现在模型返回结构不符合预期时比如 agent 期望choices[0].message.tool_calls但实际返回里choices是空数组或结构不对。根因可能是 Model ID 填错了用了一个不支持 function calling 的模型。解决办法是换一个明确支持工具调用的模型在模型对话页面先验证一次 tool_calls 返回结构。还有一类是 OAuth 相关报错比如OAuth token expired或invalid_grant。这类报错在 ABAP 系统用 OAuth 鉴权时出现跟 TaoToken 的 Key 无关。检查 ABAP 系统那边的 OAuth 客户端配置以及 token 有效期。如果 token 过期重新走一次授权流程。排障时建议开两个日志窗口一个是 VS Code 输出面板里的 ADT 扩展日志一个是 MCP server 的 stderr。两边对照看能快速定位报错发生在哪一跳。另外TaoToken 控制台的请求日志也能看到每次调用的状态码和耗时配合x-request-id用排查效率会高很多。如果排障过程中需要确认 API Key 状态或重新生成去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和请求头格式参考 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。6. 长期跑 ABAP agent 的通道选择与配置固化验证通过只是开始真正要跑起来还得考虑长期稳定性。ABAP 项目的 agent 调用有几个特点单次调用可能涉及多个 tool 往返token 消耗比普通对话高激活和语法检查有状态依赖不能随便重试开发高峰期并发请求多对通道稳定性要求高。针对这些特点通道选择上建议用 Coding Plan而不是按次计费的 API 调用。Coding Plan 的入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它的优势是额度固定、适合长时间跑 agent 任务不会因为单次调用量大而超预算。对于 ABAP 这种需要反复读源码、改注释、触发激活的场景Coding Plan 的性价比更明显。配置固化方面建议把三件套和 MCP server 配置写进项目的.vscode/settings.json和.vscode/mcp.json跟代码一起版本管理。Key 不要写进文件用环境变量引用。团队协作时在 README 里写清楚需要设哪些环境变量新人拉下代码后照着设一遍就能跑。如果你用的是 Claude Code 做 ABAP agent配置走~/.claude/settings.jsonMCP server 在~/.claude/mcp.json里注册。Claude Code 的接入文档在 https://taotoken.net/doc/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面写了 Base URL 和 Key 的注入方式。Claude Code 的优势是终端里直接跑适合习惯命令行的 ABAP 开发者。最后说一个实际踩过的坑ABAP 对象的激活操作有副作用agent 如果重试逻辑没写好可能重复激活导致锁冲突。建议在 MCP server 侧对写操作加幂等判断或者在 agent 的 prompt 里明确「激活前先检查对象状态」。这个坑跟 endpoint 配置无关但跑长期任务时一定会遇到提前防一下能省不少事。配置固化后每次换机器或换项目只需要设一遍环境变量其余配置跟着仓库走。这样 ABAP 工具链和 MCP server 的连通性就有了可复现的保障不用每次重新排障。