1. 为什么要在 IntelliJ IDEA 里折腾 skill 和 MCP如果你平时写 Java、Kotlin 或者做 Android 开发大概率主力编辑器就是 IntelliJ IDEA。这两年 AI 编程工具换了一茬又一茬从最早的补全插件到后来的对话式助手再到能自己读文件、跑命令的 Agent能力是越来越强但有个问题一直很烦AI 工具和 IDEA 之间是割裂的。你在 AI 工具里说「帮我跑一下这个 Spring Boot 项目」它只能给你一段mvn spring-boot:run的命令让你自己复制到 IDEA 的终端里执行。它看不到 IDEA 里的运行配置也不知道当前项目结构更没法直接触发 IDEA 的构建、调试、运行按钮。这就是所谓的「AI 编程工具缺少项目级操作能力」。MCPModel Context Protocol就是来解决这个问题的。简单说它是一套让 AI 工具调用外部能力的协议。IDEA 从 2025.2 版本开始内置了 MCP Server等于把 IDEA 自己的运行、调试、构建、文件操作这些能力暴露成一个标准接口AI 工具通过这个接口就能直接操作你的项目。而 skill 则是另一层东西。你可以把它理解成「给 AI 的操作说明书」——告诉 AI 在什么场景下该调用哪个 MCP 工具、参数怎么填、顺序怎么走。没有 skillAI 面对一堆 MCP 工具可能不知道先用哪个有了 skill它就能按你预设的流程干活。这篇要讲的就是在 IntelliJ IDEA 里开启 MCP Server把 skill 描述文件配好然后让 AI 编程工具统一走 TaoToken 的 Key/API 通道去调用这些能力最后用一个真实的重构任务验证整条链路是否跑通。适合谁适合已经在用 AI 编程工具、但觉得它「只会聊天不会干活」的 IDEA 用户。下面每一步我都会给可复制的配置你跟着做就行。2. TaoToken 前置准备统一 Key 与 API 通道在动手配 MCP 之前先把「通道」这件事理清楚。AI 编程工具要调用模型就得有 API Key 和 Base URL。如果你同时用 Codex、Claude Code、Cline 好几个工具每个都单独配 Key、单独记地址管理起来很乱额度也分散。TaoToken 的作用就是把这些统一到一个入口一个 Key、一个 Base URL所有工具都走这条通道。官网入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。注意 API 地址后面不加任何参数直接用它作为 Base URL 就行。具体要准备三样东西我把它叫做「三件套」项目值说明Base URLhttps://taotoken.net/api所有工具统一填这个API Key在控制台生成形如sk-xxxx只显示一次记得存好Model ID按需选择比如claude-sonnet-4-5、gpt-4o等生成 Key 的路径是进控制台找到 API Keys 页面新建一个。这里有个坑要提醒Key 生成后只完整显示一次关掉页面就看不到了所以一定要先复制到安全的地方。如果你不确定该用哪个 Model ID可以先去模型对话页面试一下确认模型能正常响应再填到工具配置里。为什么强调「统一」因为 MCP 这条链路里AI 工具本身要调模型走 TaoTokenMCP Server 是 IDEA 本地起的走 localhost两者是分开的。很多人配 MCP 配到一半发现 AI 不响应其实是模型通道的 Key 没配对跟 MCP 本身没关系。所以先把 TaoToken 这层打通后面排障会轻松很多。另外如果你打算长期用 AI 做编码和 Agent 任务可以考虑 Coding Plan额度更划算适合天天跑重构、跑测试的场景。短期的验证用按量就行不用一上来就上套餐。准备好三件套之后我们进入正题在 IDEA 里开启 MCP Server。3. 可复制配置IDEA MCP Server skill 描述文件这一节是全文的核心配置片段都可以直接复制。先确认你的 IDEA 版本在 2025.2 以上低版本没有内置 MCP Server 这个选项。第一步打开 IDEA进Settings搜索框输入mcp server。你会看到 MCP Server 的设置页。这里有两种情况如果你用的是 Codex 或 Claude Code它们通常能自动识别并配置点Auto-Configure就行。如果你用的是其他 AI 工具比如 Trae CN、Cline 等就用Manual Client Configuration下面的配置。点Copy HTTP Stream Config会复制出一段 JSON长这样{ type: streamable-http, url: http://127.0.0.1:64342/stream, headers: { IJ_MCP_SERVER_PROJECT_PATH: /Users/xxxx/Documents/xxxx } }这里要划重点你实际只需要其中的url。headers里的IJ_MCP_SERVER_PROJECT_PATH是用来指定项目路径的可以不填——IDEA 会默认用当前打开的项目。端口64342是 IDEA 随机分配的每次重启可能不一样所以配置要以你当下复制到的为准。接下来打开你的 AI 工具的 MCP 设置。以 Trae CN 为例在 MCP 配置里填入{ mcpServers: { idea-debugger: { url: http://127.0.0.1:64342/stream } } }idea-debugger是 MCP 服务的名字你可以随便改只要自己记得住。保存之后AI 工具这边就接上了 IDEA 的 MCP Server。然后是 skill。IDEA 里自带了一些 skill 文件你可以直接复制出来用。复制到 Trae CN 的全局 skills 文件夹/Users/你的用户名/.trae-cn/skills或者放到项目根目录的.trae/skills下这样只对当前项目生效。也可以通过 Trae CN 的设置页直接上传skill.md文件。一个 skill 描述文件的模板大概长这样你可以按自己的项目改--- name: idea-project-runner description: 通过 IDEA MCP 运行和调试当前项目 --- ## 何时使用 当用户要求运行、启动、调试当前项目时使用本 skill。 ## 操作步骤 1. 调用 idea-debugger 的 run 工具传入当前项目路径 2. 等待 IDEA 返回运行状态 3. 如果启动失败读取 IDEA 的 console 输出并反馈给用户 ## 参数说明 - projectPath: 项目根目录绝对路径 - configurationName: IDEA 运行配置名称可选这个模板的关键是description和「何时使用」——AI 靠这两块判断该不该触发这个 skill。写得太模糊AI 就不会调用写得具体命中率就高。配置到这里链路是AI 工具 → TaoToken模型通道→ 识别 skill → 调用 IDEA MCP Server → 操作项目。下一节我们用一个真实任务验证它。4. 验证请求用一次真实重构任务跑通调用链配置完不验证等于没配。我建议用一个「小而完整」的重构任务来测既能看出 MCP 有没有真的操作项目又不会因为任务太大而难以判断哪一步出错。任务设定把项目里一个工具类的方法名从getUserInfo改成fetchUserProfile并同步更新所有调用点。这个任务需要 AI 读文件、改文件、可能还要跑编译验证正好覆盖 MCP 的多个能力。第一步在 AI 工具对话框里输入使用 idea-debugger mcp 运行当前项目的前后端如果 MCP 配好了你会看到 IDEA 里项目真的启动了控制台开始输出日志。这一步验证的是「AI 能不能触发 IDEA 的运行能力」。第二步测试文件操作。输入用 idea-debugger 找到 UserService.java 里 getUserInfo 方法的所有调用点AI 会通过 MCP 读取项目文件列出调用位置。这一步验证的是「AI 能不能读项目结构」。第三步执行重构。输入把 getUserInfo 重命名为 fetchUserProfile更新所有调用点然后编译验证观察 IDEA 里的变化文件被修改、编译任务被触发、结果返回给 AI。如果这三步都跑通了说明整条调用链是通的。这里有个细节AI 工具调模型走的是 TaoToken 的通道你可以在工具的模型设置里确认 Base URL 填的是https://taotoken.net/apiKey 是你在控制台生成的那个。如果 AI 能正常对话但 MCP 工具不触发问题多半在 skill 描述或者 MCP 连接上不在模型通道。实测下来最容易出问题的是端口变化。IDEA 重启后 MCP Server 端口可能变AI 工具里还留着旧端口就会连不上。所以每次重启 IDEA 后如果 MCP 不响应先去 Settings 里重新复制一下 url。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth配 MCP 这条链路报错基本集中在几个地方。我把真实遇到过的整理出来对照着查。401 Unauthorized这个几乎都是 TaoToken 的 Key 问题。要么 Key 没填、填错要么 Key 被删了。去控制台 API Keys 页面确认 Key 还在然后检查工具配置里的 Base URL 是不是https://taotoken.net/api注意不要多加斜杠或者路径。还有一种情况是 Key 复制时带了空格肉眼看不出来重新复制一遍。local proxy failed / connection refused这个报错指向 MCP 连接不是模型通道。原因通常是 IDEA 的 MCP Server 没开或者端口对不上。先去 IDEA Settings 里确认 MCP Server 是开启状态然后重新Copy HTTP Stream Config把新的 url 更新到 AI 工具的 MCP 配置里。如果 IDEA 根本没开AI 工具连127.0.0.1:64342当然会被拒绝。reading choices / 读取响应失败这个多半是 MCP 返回的数据格式和 AI 工具预期不一致。常见于 skill 描述里参数写错比如projectPath传了相对路径。改成绝对路径试试。另外确认 AI 工具的 MCP 配置里type是streamable-http填成别的类型会解析失败。OAuth 相关报错有些 AI 工具在连 MCP 时会尝试走 OAuth 流程但 IDEA 的本地 MCP Server 不走这套。如果你看到 OAuth 报错检查工具配置里有没有多余的认证字段把headers里除必要项外的都删掉只留url最稳。排查顺序建议是先确认模型通道TaoToken能对话再确认 MCP 端口能连通最后看 skill 有没有被触发。三层分开查比一锅乱炖快得多。如果你在配置 Codex 的auth.json或者 Cline 的 MCP 设置记住三件套要写全Base URL 填https://taotoken.net/apiKey 填控制台生成的Model ID 填你验证过的模型。少任何一个链路都跑不起来。6. 把通道固定下来让 AI 真正干活配好之后日常使用其实就顺了。我的习惯是IDEA 常开MCP Server 保持开启AI 工具里 MCP 配置和 TaoToken 的 Key 都固定好不轻易动。这样每次打开项目AI 就能直接读结构、跑任务、改代码不用再手动复制命令。有几个实用技巧可以让你少踩坑。第一skill 文件按项目放不同项目的运行方式不一样全局 skill 容易串。第二IDEA 重启后先测一句「用 idea-debugger 列出当前项目结构」能返回就说明链路正常。第三TaoToken 的 Key 如果要在多个工具间共用记得在控制台留意额度别一个工具跑飞了把额度耗光。如果你还没生成 Key现在就可以去控制台建一个然后按第 3 节的配置把 MCP 接上。验证模型能不能正常响应可以去模型对话页面发一句话试试。长期做编码和 Agent 任务的话Coding Plan 会比按量更省心。整条链路跑通之后你会发现 AI 编程工具不再只是个「会聊天的补全」而是能真正操作 IDEA、跑项目、做重构的助手。这才是 skill MCP 组合的价值所在。
1. 为什么要在 IntelliJ IDEA 里折腾 skill 和 MCP如果你平时写 Java、Kotlin 或者做 Android 开发大概率主力编辑器就是 IntelliJ IDEA。这两年 AI 编程工具换了一茬又一茬从最早的补全插件到后来的对话式助手再到能自己读文件、跑命令的 Agent能力是越来越强但有个问题一直很烦AI 工具和 IDEA 之间是割裂的。你在 AI 工具里说「帮我跑一下这个 Spring Boot 项目」它只能给你一段mvn spring-boot:run的命令让你自己复制到 IDEA 的终端里执行。它看不到 IDEA 里的运行配置也不知道当前项目结构更没法直接触发 IDEA 的构建、调试、运行按钮。这就是所谓的「AI 编程工具缺少项目级操作能力」。MCPModel Context Protocol就是来解决这个问题的。简单说它是一套让 AI 工具调用外部能力的协议。IDEA 从 2025.2 版本开始内置了 MCP Server等于把 IDEA 自己的运行、调试、构建、文件操作这些能力暴露成一个标准接口AI 工具通过这个接口就能直接操作你的项目。而 skill 则是另一层东西。你可以把它理解成「给 AI 的操作说明书」——告诉 AI 在什么场景下该调用哪个 MCP 工具、参数怎么填、顺序怎么走。没有 skillAI 面对一堆 MCP 工具可能不知道先用哪个有了 skill它就能按你预设的流程干活。这篇要讲的就是在 IntelliJ IDEA 里开启 MCP Server把 skill 描述文件配好然后让 AI 编程工具统一走 TaoToken 的 Key/API 通道去调用这些能力最后用一个真实的重构任务验证整条链路是否跑通。适合谁适合已经在用 AI 编程工具、但觉得它「只会聊天不会干活」的 IDEA 用户。下面每一步我都会给可复制的配置你跟着做就行。2. TaoToken 前置准备统一 Key 与 API 通道在动手配 MCP 之前先把「通道」这件事理清楚。AI 编程工具要调用模型就得有 API Key 和 Base URL。如果你同时用 Codex、Claude Code、Cline 好几个工具每个都单独配 Key、单独记地址管理起来很乱额度也分散。TaoToken 的作用就是把这些统一到一个入口一个 Key、一个 Base URL所有工具都走这条通道。官网入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。注意 API 地址后面不加任何参数直接用它作为 Base URL 就行。具体要准备三样东西我把它叫做「三件套」项目值说明Base URLhttps://taotoken.net/api所有工具统一填这个API Key在控制台生成形如sk-xxxx只显示一次记得存好Model ID按需选择比如claude-sonnet-4-5、gpt-4o等生成 Key 的路径是进控制台找到 API Keys 页面新建一个。这里有个坑要提醒Key 生成后只完整显示一次关掉页面就看不到了所以一定要先复制到安全的地方。如果你不确定该用哪个 Model ID可以先去模型对话页面试一下确认模型能正常响应再填到工具配置里。为什么强调「统一」因为 MCP 这条链路里AI 工具本身要调模型走 TaoTokenMCP Server 是 IDEA 本地起的走 localhost两者是分开的。很多人配 MCP 配到一半发现 AI 不响应其实是模型通道的 Key 没配对跟 MCP 本身没关系。所以先把 TaoToken 这层打通后面排障会轻松很多。另外如果你打算长期用 AI 做编码和 Agent 任务可以考虑 Coding Plan额度更划算适合天天跑重构、跑测试的场景。短期的验证用按量就行不用一上来就上套餐。准备好三件套之后我们进入正题在 IDEA 里开启 MCP Server。3. 可复制配置IDEA MCP Server skill 描述文件这一节是全文的核心配置片段都可以直接复制。先确认你的 IDEA 版本在 2025.2 以上低版本没有内置 MCP Server 这个选项。第一步打开 IDEA进Settings搜索框输入mcp server。你会看到 MCP Server 的设置页。这里有两种情况如果你用的是 Codex 或 Claude Code它们通常能自动识别并配置点Auto-Configure就行。如果你用的是其他 AI 工具比如 Trae CN、Cline 等就用Manual Client Configuration下面的配置。点Copy HTTP Stream Config会复制出一段 JSON长这样{ type: streamable-http, url: http://127.0.0.1:64342/stream, headers: { IJ_MCP_SERVER_PROJECT_PATH: /Users/xxxx/Documents/xxxx } }这里要划重点你实际只需要其中的url。headers里的IJ_MCP_SERVER_PROJECT_PATH是用来指定项目路径的可以不填——IDEA 会默认用当前打开的项目。端口64342是 IDEA 随机分配的每次重启可能不一样所以配置要以你当下复制到的为准。接下来打开你的 AI 工具的 MCP 设置。以 Trae CN 为例在 MCP 配置里填入{ mcpServers: { idea-debugger: { url: http://127.0.0.1:64342/stream } } }idea-debugger是 MCP 服务的名字你可以随便改只要自己记得住。保存之后AI 工具这边就接上了 IDEA 的 MCP Server。然后是 skill。IDEA 里自带了一些 skill 文件你可以直接复制出来用。复制到 Trae CN 的全局 skills 文件夹/Users/你的用户名/.trae-cn/skills或者放到项目根目录的.trae/skills下这样只对当前项目生效。也可以通过 Trae CN 的设置页直接上传skill.md文件。一个 skill 描述文件的模板大概长这样你可以按自己的项目改--- name: idea-project-runner description: 通过 IDEA MCP 运行和调试当前项目 --- ## 何时使用 当用户要求运行、启动、调试当前项目时使用本 skill。 ## 操作步骤 1. 调用 idea-debugger 的 run 工具传入当前项目路径 2. 等待 IDEA 返回运行状态 3. 如果启动失败读取 IDEA 的 console 输出并反馈给用户 ## 参数说明 - projectPath: 项目根目录绝对路径 - configurationName: IDEA 运行配置名称可选这个模板的关键是description和「何时使用」——AI 靠这两块判断该不该触发这个 skill。写得太模糊AI 就不会调用写得具体命中率就高。配置到这里链路是AI 工具 → TaoToken模型通道→ 识别 skill → 调用 IDEA MCP Server → 操作项目。下一节我们用一个真实任务验证它。4. 验证请求用一次真实重构任务跑通调用链配置完不验证等于没配。我建议用一个「小而完整」的重构任务来测既能看出 MCP 有没有真的操作项目又不会因为任务太大而难以判断哪一步出错。任务设定把项目里一个工具类的方法名从getUserInfo改成fetchUserProfile并同步更新所有调用点。这个任务需要 AI 读文件、改文件、可能还要跑编译验证正好覆盖 MCP 的多个能力。第一步在 AI 工具对话框里输入使用 idea-debugger mcp 运行当前项目的前后端如果 MCP 配好了你会看到 IDEA 里项目真的启动了控制台开始输出日志。这一步验证的是「AI 能不能触发 IDEA 的运行能力」。第二步测试文件操作。输入用 idea-debugger 找到 UserService.java 里 getUserInfo 方法的所有调用点AI 会通过 MCP 读取项目文件列出调用位置。这一步验证的是「AI 能不能读项目结构」。第三步执行重构。输入把 getUserInfo 重命名为 fetchUserProfile更新所有调用点然后编译验证观察 IDEA 里的变化文件被修改、编译任务被触发、结果返回给 AI。如果这三步都跑通了说明整条调用链是通的。这里有个细节AI 工具调模型走的是 TaoToken 的通道你可以在工具的模型设置里确认 Base URL 填的是https://taotoken.net/apiKey 是你在控制台生成的那个。如果 AI 能正常对话但 MCP 工具不触发问题多半在 skill 描述或者 MCP 连接上不在模型通道。实测下来最容易出问题的是端口变化。IDEA 重启后 MCP Server 端口可能变AI 工具里还留着旧端口就会连不上。所以每次重启 IDEA 后如果 MCP 不响应先去 Settings 里重新复制一下 url。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth配 MCP 这条链路报错基本集中在几个地方。我把真实遇到过的整理出来对照着查。401 Unauthorized这个几乎都是 TaoToken 的 Key 问题。要么 Key 没填、填错要么 Key 被删了。去控制台 API Keys 页面确认 Key 还在然后检查工具配置里的 Base URL 是不是https://taotoken.net/api注意不要多加斜杠或者路径。还有一种情况是 Key 复制时带了空格肉眼看不出来重新复制一遍。local proxy failed / connection refused这个报错指向 MCP 连接不是模型通道。原因通常是 IDEA 的 MCP Server 没开或者端口对不上。先去 IDEA Settings 里确认 MCP Server 是开启状态然后重新Copy HTTP Stream Config把新的 url 更新到 AI 工具的 MCP 配置里。如果 IDEA 根本没开AI 工具连127.0.0.1:64342当然会被拒绝。reading choices / 读取响应失败这个多半是 MCP 返回的数据格式和 AI 工具预期不一致。常见于 skill 描述里参数写错比如projectPath传了相对路径。改成绝对路径试试。另外确认 AI 工具的 MCP 配置里type是streamable-http填成别的类型会解析失败。OAuth 相关报错有些 AI 工具在连 MCP 时会尝试走 OAuth 流程但 IDEA 的本地 MCP Server 不走这套。如果你看到 OAuth 报错检查工具配置里有没有多余的认证字段把headers里除必要项外的都删掉只留url最稳。排查顺序建议是先确认模型通道TaoToken能对话再确认 MCP 端口能连通最后看 skill 有没有被触发。三层分开查比一锅乱炖快得多。如果你在配置 Codex 的auth.json或者 Cline 的 MCP 设置记住三件套要写全Base URL 填https://taotoken.net/apiKey 填控制台生成的Model ID 填你验证过的模型。少任何一个链路都跑不起来。6. 把通道固定下来让 AI 真正干活配好之后日常使用其实就顺了。我的习惯是IDEA 常开MCP Server 保持开启AI 工具里 MCP 配置和 TaoToken 的 Key 都固定好不轻易动。这样每次打开项目AI 就能直接读结构、跑任务、改代码不用再手动复制命令。有几个实用技巧可以让你少踩坑。第一skill 文件按项目放不同项目的运行方式不一样全局 skill 容易串。第二IDEA 重启后先测一句「用 idea-debugger 列出当前项目结构」能返回就说明链路正常。第三TaoToken 的 Key 如果要在多个工具间共用记得在控制台留意额度别一个工具跑飞了把额度耗光。如果你还没生成 Key现在就可以去控制台建一个然后按第 3 节的配置把 MCP 接上。验证模型能不能正常响应可以去模型对话页面发一句话试试。长期做编码和 Agent 任务的话Coding Plan 会比按量更省心。整条链路跑通之后你会发现 AI 编程工具不再只是个「会聊天的补全」而是能真正操作 IDEA、跑项目、做重构的助手。这才是 skill MCP 组合的价值所在。
