1. 为什么要在 Claude Code 里接 MySQL日常写业务代码时最烦的场景之一就是新接手一张表字段名、类型、索引、注释全靠猜然后要花大段篇幅跟 AI 描述「这张表有 id、user_id、created_at……」上下文越堆越长AI 还经常记混字段。更别提做索引优化、慢 SQL 分析时得把表结构一段段贴过去来回沟通成本极高。Claude Code 本身是个跑在终端里的编码 Agent它能读写文件、执行命令但它默认看不到你的数据库。如果能让它直接连上 MySQL自己DESCRIBE表、查information_schema、看索引那开发效率会完全不一样——你只需要说「帮我给 orders 表写个按状态时间分页的查询」它自己去读表结构不用你喂。这篇要解决的就是这条链路Claude Code 通过 TaoToken 统一 Key/API 通道接入 MySQL MCP Server让 AI 工具安全读取数据库结构。适合本地开发、测试环境目标是配置一次之后在 Claude Code 会话里就能直接查元数据、辅助写 SQL。核心思路分两层一层是 Claude Code 的模型请求走 TaoToken 统一通道一个 Key 管所有模型调用另一层是 MySQL 通过 MCP Server 暴露给 Claude Code。两层配好AI 就能「边想边查库」。2. TaoToken 前置统一 Key 与通道配置先说清楚 TaoToken 在这里的角色。Claude Code 默认要连 Anthropic 的接口你需要一个可用的 API 通道和 Key。TaoToken 提供统一的 API 入口把模型调用收敛到一个 Key 上配置项写进 Claude Code 的 settings 就能生效。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。你需要先拿到 Key。进控制台的 API Keys 页面创建https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建后复制那串sk-开头的字符串后面配置要用。注意别把它提交进 Git建议放环境变量或本地 settings 文件里。Claude Code 读取配置有两个位置项目级的.claude/settings.json和用户级的~/.claude/settings.json。项目级只对当前项目生效用户级全局生效。我建议模型通道放用户级所有项目共用一套 Key数据库 MCP 放项目级不同项目连不同库。关于通道参数Claude Code 认的是ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN这两个环境变量或者写进 settings 的env字段。TaoToken 的基址填https://taotoken.net/apiKey 填你刚创建的那串。这样 Claude Code 的所有模型请求都会走 TaoToken 通道不用再单独配 Anthropic 官方地址。如果你后面要做长期编码、跑 Agent 任务可以考虑 Coding Plan额度更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段疑问可以对照。3. 可复制配置settings.json 与 MCP 骨架这一节给完整可复制的配置。分三步装 MCP Server、配 Claude Code 模型通道、注册 MySQL MCP。3.1 安装 MySQL MCP Server依赖 Node.js 和 Claude Code CLI。先确认版本node -v claude --version然后全局装 MCP Servernpm install -g benborla29/mcp-server-mysql装完可以用npx benborla29/mcp-server-mysql试跑一下能启动就说明依赖没问题。3.2 配置 Claude Code 模型通道编辑用户级~/.claude/settings.json写入 TaoToken 通道{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥 } }如果你更习惯用环境变量也可以在 shell 里 exportexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的TaoToken密钥两种方式二选一即可settings 文件的好处是换终端不用重新 export。3.3 注册 MySQL MCP 到 Claude Code在项目根目录执行claude mcp add。注意命令要写成一行参数之间只留空格否则 CLI 可能把换行识别成多行命令claude mcp add mysql_dev -e MYSQL_HOST127.0.0.1 -e MYSQL_PORT3306 -e MYSQL_USERroot -e MYSQL_PASSyour_password -e MYSQL_DByour_database -e ALLOW_INSERT_OPERATIONfalse -e ALLOW_UPDATE_OPERATIONfalse -e ALLOW_DELETE_OPERATIONfalse --scope project -- npx benborla29/mcp-server-mysql参数含义对照参数作用建议值MYSQL_HOST数据库地址127.0.0.1MYSQL_PORT端口3306MYSQL_USER用户名只读账号优先MYSQL_PASS密码本地测试密码MYSQL_DB目标库你的业务库ALLOW_INSERT_OPERATION允许插入falseALLOW_UPDATE_OPERATION允许更新falseALLOW_DELETE_OPERATION允许删除false三个写操作全部设false这是安全底线——让 AI 只读结构不碰数据。--scope project表示只对当前项目生效执行后项目根目录会生成.mcp.json{ mcpServers: { mysql_dev: { command: npx, args: [benborla29/mcp-server-mysql], env: { MYSQL_HOST: 127.0.0.1, MYSQL_PORT: 3306, MYSQL_USER: root, MYSQL_PASS: your_password, MYSQL_DB: your_database, ALLOW_INSERT_OPERATION: false, ALLOW_UPDATE_OPERATION: false, ALLOW_DELETE_OPERATION: false } } } }注意.mcp.json里含数据库密码务必加进.gitignore别提交到仓库。4. 验证请求与查询回显配置写完要验证两件事模型通道通不通、MySQL MCP 连没连上。4.1 验证 TaoToken 通道先确认 Claude Code 能正常发起模型请求。随便进一个项目目录启动会话claude输入一句简单的话比如「你好确认一下通道是否正常」。如果能正常回显说明 TaoToken 通道生效。如果报鉴权错误回去检查ANTHROPIC_AUTH_TOKEN是否复制完整、有没有多余空格。4.2 验证 MySQL MCP 连接退出会话在终端执行claude mcp list看到mysql_dev后面显示connected就说明 MCP 已经连上数据库。另一种方式是在 Claude Code 会话里输入斜杠命令/mcp同样会列出 MCP 状态connected即成功。4.3 实测元数据查询连接成功后直接在会话里让 Claude Code 读表结构。比如帮我列出当前数据库所有表并说明 orders 表的字段和索引Claude Code 会通过 MCP 调用information_schema把表名、字段类型、索引信息拉回来。你也可以让它针对具体表写查询读取 users 表结构写一个按 created_at 倒序分页的 SQL每页 20 条它会先查表结构确认字段名再生成 SQL避免字段拼错。实测下来这一步省掉了大量手动贴表结构的时间。如果只是想验证模型本身是否正常也可以去模型对话页面单独测https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。5. 本篇常见错排查配置过程中容易踩几个坑逐个说。报错MCP server failed to start多半是npx找不到包或者 Node 版本太低。先npm install -g benborla29/mcp-server-mysql重装再确认node -v在 18 以上。claude mcp add执行后没生成.mcp.json检查命令是不是被换行拆成了多行。CLI 对多行命令敏感务必写成一行。另外确认当前目录是项目根目录--scope project才会写对位置。显示disconnected数据库地址、端口、账号密码有一项不对。先用mysql -h 127.0.0.1 -P 3306 -u root -p手动连一次确认参数无误再回填到 MCP 配置。模型请求 401TaoToken Key 没配对或者ANTHROPIC_BASE_URL写成了带路径的地址。基址就是https://taotoken.net/api不要多加/v1之类后缀。AI 说查不到表MYSQL_DB填错库名或者账号没有该库的读权限。给 MCP 用的账号建议单独建一个只读账号权限只给SELECT和SHOW VIEW。写操作被拒这是正常的三个ALLOW_*都是false。如果你确实需要 AI 在测试库写数据再单独开但生产库永远别开。提示排障时优先看claude mcp list的状态再看数据库手动连接是否正常最后才怀疑模型通道。顺序反了会浪费很多时间。6. 一次配置长期复用把模型通道放用户级 settings、数据库 MCP 放项目级.mcp.json这套结构的好处是换项目只改.mcp.json里的库名和账号TaoToken 的 Key 不用动。新项目初始化时复制一份.mcp.json改几个字段就能用。如果你后面要跑更重的编码任务、长时间 Agent 会话建议把 Key 和额度规划一下Coding Plan 页面有具体方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节和字段说明对照文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。需要新建或轮换 Key 时去 API Keys 页面操作https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。最后提醒一句MCP 连的是真实数据库哪怕只读也建议用测试库或只读账号别把生产库的写权限交出去。配置一次之后 Claude Code 就能自己读表结构、辅助写 SQL上下文里再也不用堆一大段字段说明了。