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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api 。
你需要先拿到 Key。进控制台的 API Keys 页面创建：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。创建后复制那串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/api，Key 填你刚创建的那串。这样 Claude Code 的所有模型请求都会走 TaoToken 通道，不用再单独配 Anthropic 官方地址。
如果你后面要做长期编码、跑 Agent 任务，可以考虑 Coding Plan，额度更划算：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，遇到字段疑问可以对照。
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 Server：
npm 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 里 export：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="sk-你的TaoToken密钥"两种方式二选一即可，settings 文件的好处是换终端不用重新 export。
3.3 注册 MySQL MCP 到 Claude Code
在项目根目录执行claude mcp add。注意命令要写成一行，参数之间只留空格，否则 CLI 可能把换行识别成多行命令：
claude mcp add mysql_dev -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -e ALLOW_INSERT_OPERATION="false" -e ALLOW_UPDATE_OPERATION="false" -e ALLOW_DELETE_OPERATION="false" --scope project -- npx @benborla29/mcp-server-mysql参数含义对照：
| 参数 | 作用 | 建议值 |
|---|---|---|
| MYSQL_HOST | 数据库地址 | 127.0.0.1 |
| MYSQL_PORT | 端口 | 3306 |
| MYSQL_USER | 用户名 | 只读账号优先 |
| MYSQL_PASS | 密码 | 本地测试密码 |
| MYSQL_DB | 目标库 | 你的业务库 |
| ALLOW_INSERT_OPERATION | 允许插入 | false |
| ALLOW_UPDATE_OPERATION | 允许更新 | false |
| ALLOW_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_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。
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 配置。
模型请求 401：TaoToken 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_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入细节和字段说明对照文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。需要新建或轮换 Key 时，去 API Keys 页面操作：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。
最后提醒一句：MCP 连的是真实数据库，哪怕只读，也建议用测试库或只读账号，别把生产库的写权限交出去。配置一次，之后 Claude Code 就能自己读表结构、辅助写 SQL，上下文里再也不用堆一大段字段说明了。
