1. 为什么要在 Cursor 里接入 MiniMaxCursor 默认只带 Claude 和 GPT 系列模型用久了你会发现两个问题一是额度消耗快二是某些中文语境下的代码注释、嵌入式寄存器命名、国产芯片手册里的术语内置模型理解得不够顺。MiniMax 作为国产大模型在中文技术文档和长上下文代码理解上有自己的优势尤其是 MiniMax-M3 这类代码模型处理 STM32 工程、驱动文件、头文件混在一起的长上下文时表现稳定。这篇要解决的问题很具体在 Cursor 中通过 OpenAI 兼容接口和 MCP 协议两种方式接入 MiniMax让你能在 Chat、Composer、行间编辑里直接调用 MiniMax 模型同时也能通过 MCP 插件调用它的音频、图像生成能力。适合已经在用 Cursor、想换国产模型降低成本或提升中文代码理解效果的开发者尤其是做嵌入式、硬件驱动这类中文注释密集项目的朋友。需要提前说清楚一个前提Cursor 自定义第三方模型需要 Pro 会员免费版在添加自定义模型时会提示当前套餐不支持。这不是 MiniMax 的限制是 Cursor 本身的策略。另外接入方式分两条线——文本大模型走 OpenAI 兼容模式多媒体工具走 MCP 插件两者配置位置不同别混在一起。如果你手上还没有可用的 API Key或者想先确认模型调用链路是否通可以先用 TaoToken 的模型对话页面做一次快速验证确认 Key 和接口地址没问题再回到 Cursor 里配置能省掉不少排查时间。2. 前置准备API Key 与接口地址在动手改 Cursor 配置之前先把两样东西准备好不然后面填配置时容易卡住。第一样是MiniMax API Key。去 MiniMax 开放平台注册账号创建一个应用在应用详情里复制 API Key格式通常是sk-开头的一长串。这个 Key 只显示一次复制后先存到本地文本里。第二样是接口地址。MiniMax 提供两个域名按你的网络环境选环境Base URL国内https://api.minimaxi.com/v1海外https://api.minimax.io/v1注意结尾的/v1要带上Cursor 的 Override Base URL 填的是完整前缀不是只填域名。还有一个容易被忽略的坑系统环境变量里的OPENAI_API_KEY和OPENAI_BASE_URL要清掉。Cursor 在某些版本会读取系统环境变量如果你之前配过别的中转或代理这两个变量会和 Cursor 里的设置冲突导致请求发到错误的地址。Windows 在「系统属性 → 环境变量」里删macOS/Linux 检查~/.zshrc或~/.bash_profile里有没有export OPENAI_...有就注释掉。提示如果你同时用多个工具调不同模型建议不要在系统层面设全局OPENAI_BASE_URL改成每个工具单独配置避免互相污染。3. 方案一OpenAI 兼容模式接入文本模型这是主流用法配好之后 MiniMax 模型会出现在 Cursor 的模型下拉框里Chat、Composer、CtrlK 行间编辑都能用。3.1 打开 Models 配置页快捷键Ctrl ,Windows或Cmd ,Mac打开设置左侧菜单找到Models。往下滚动能看到API Keys区域。3.2 配置全局转发在 API Keys 区域做三件事打开Override OpenAI Base URL开关在输入框填入国内地址https://api.minimaxi.com/v1。然后在OpenAI API Key输入框粘贴你的 MiniMax Key点右侧Verify按钮验证。弹窗提示确认时点Enable OpenAI API Key。这一步验证通过说明 Key 和地址都对。如果 Verify 报错先检查 Key 有没有复制完整、地址结尾/v1有没有漏。3.3 添加自定义模型点View All Models滚到底部点Add Custom Model。模型名称严格区分大小写和横杠二选一填MiniMax-M3最新代码模型适合大型工程、长上下文重构MiniMax-M2.7经典长上下文模型日常编码够用点Add添加然后打开该模型右侧的启用开关。回到编辑器右上角模型下拉框里就能选到 MiniMax-M3 了。3.4 一个必须知道的副作用Override OpenAI Base URL 是全局生效的。开启后Cursor 自带的 Claude、GPT 系列会全部失效因为请求都被转发到 MiniMax 的地址了。不用 MiniMax 的时候必须回到设置里把这个开关关掉官方模型才能恢复。我试过在项目间来回切换忘了关这个开关结果调 Claude 一直报模型不存在排查了半天才想起来。建议养成习惯切回官方模型前先关 Override。4. 方案二MCP 插件接入多媒体能力如果你要用 MiniMax 的音频生成、图像生成走 MCP 插件这条路。文本对话不需要配 MCP两者是独立的。4.1 添加自定义 MCPCursor 设置 →Tools Integrations→MCP Tools→Add Custom MCP。这会打开mcp.json文件把下面这段骨架粘进去替换掉里面的占位参数{ mcpServers: { MiniMax: { command: uvx, args: [minimax-mcp], env: { MINIMAX_API_KEY: 你的MiniMax API Key, MINIMAX_MCP_BASE_PATH: D:/AI/output, MINIMAX_API_HOST: https://api.minimaxi.com } } } }几个参数说明MINIMAX_MCP_BASE_PATH填本地文件夹的绝对路径生成的文件会落在这里。Windows 用正斜杠或双反斜杠路径里不要有中文否则 MCP 启动时可能读不到目录。MINIMAX_API_HOST填https://api.minimaxi.com注意这里不带/v1和文本模型的 Base URL 写法不一样别填错。command用的是uvx这是 Python 的 uv 工具链提供的命令。如果你机器上没装 uv先装一下否则 MCP 服务起不来。4.2 保存并重启保存mcp.json重启 Cursor。MCP 服务会自动加载在 Agent 模式里就能调用 MiniMax 的多媒体工具了。如果重启后没加载去 MCP Tools 页面看服务状态绿色表示正常。5. 验证请求与成功结果配置完别急着写代码先做一次最小验证确认链路通。文本模型验证在 Cursor 里按Ctrl L打开 Chat右上角模型选MiniMax-M3输入一句简单的测试比如「用 C 写一个 STM32 的 GPIO 初始化函数带注释」。如果几秒内返回带注释的代码说明文本链路通了。MCP 验证在 Agent 模式里让它调用 MiniMax 的图像生成工具比如「生成一张 512x512 的蓝色渐变图保存到输出目录」。执行后去MINIMAX_MCP_BASE_PATH指向的文件夹看有没有生成文件有就说明 MCP 通了。如果你在验证阶段想先确认 Key 本身有没有问题可以拿同一个 Key 去 TaoToken 的模型对话页面发一条请求那边通了说明 Key 和额度正常问题就出在 Cursor 配置上排查范围能缩小一半。6. 常见报错排查模型不可用 / The model does not work with your current plan先确认 Cursor 是 Pro 会员免费版不支持自定义模型。再检查模型名称拼写MiniMax-M3的大小写和横杠必须完全一致写成minimax-m3或MiniMax_M3都会失败。请求无响应 / 一直转圈检查 Base URL 是不是填了国内地址网络环境能不能访问api.minimaxi.com。关掉系统代理再试代理有时会拦截请求。另外确认 API Key 有余额、权限正常。自带 Claude 失效这是 Override OpenAI Base URL 全局生效导致的关掉这个开关就恢复。MCP 启动失败三个常见原因——没装uvx工具、输出文件夹没有写权限、路径里带中文。逐个排查路径改成纯英文再试。代码输出截断或失忆换MiniMax-M3它上下文更长。同时减少单次粘贴的代码行数一次别塞太多文件。响应很慢切到MiniMax-M2.7-highspeed或者确认走的是国内接口地址海外地址在国内访问会慢。7. 下一步把 Key 管起来配置跑通之后真正要长期面对的是 Key 的管理问题。Cursor 里填的 Key、MCP 里填的 Key、可能还有其他工具里的 Key散落在各处换一次 Key 要改好几个地方还容易漏。如果你打算把 MiniMax 作为主力模型长期用建议去 TaoToken 控制台把 Key 统一管理配合 API Keys 页面做权限和额度控制接入文档里有 OpenAI 兼容模式的完整说明换工具时照着改 Base URL 就行不用每次重新摸索。需要长期跑编码任务或 Agent 的可以看下 Coding Plan把额度规划好避免写到一半断掉。