如何通过 MCP 将你的 Supabase 数据库连接到 Cursor 并改到 TaoToken-开发者社区

1. 为什么 Supabase 连 Cursor 总卡在鉴权这一步

如果你已经在用 Supabase 做后端，又习惯在 Cursor 里写代码，大概率动过一个念头：能不能让 Cursor 的 AI 直接读我的数据库表结构，甚至帮我跑查询？MCP（Model Context Protocol）就是干这个的。它相当于给 Cursor 装了一个"数据库外挂"，让 AI 代理不用你每次手动贴 schema，就能自己去看表、查字段、验证数据。

但真正动手的人会发现，事情没那么顺。最常见的卡点不是 MCP 本身，而是连接字符串里的 Base URL 和鉴权通道指向不对。Supabase 给你的连接串有好几种形态：Direct Connection、Connection Pooling、还有各种带参数的 URI。你从控制台复制的那一串，直接塞进 MCP 配置里，十有八九会报local proxy failed或者401。原因很简单——MCP 的 postgres server 走的是标准 PostgreSQL 协议，而 Supabase 的直连地址在某些网络环境下并不通，或者密码里的特殊字符没转义。

我试过把 Supabase 的 Direct Connection URI 原样贴进去，结果 Cursor 的 MCP 状态灯一直红着。后来才发现，问题出在两个地方：一是连接串里的[YOUR-PASSWORD]方括号没删干净，二是 Supabase 现在默认推荐用 Session Pooler 的地址，而不是直连。这两个细节不解决，后面所有步骤都是白搭。

这篇文章要解决的，就是这条完整链路：从 Supabase 拿正确的连接串，到在 Cursor 里配置 MCP，再到把 Base URL 和鉴权指向改对，最后在 Cursor 里发一次真实查询验证。适合已经有 Supabase 项目、想在 Cursor 内直接操作数据库的开发者。你不需要懂 MCP 协议细节，跟着配置走就行。

先说清楚 MCP 在这里的角色。它不是一个数据库驱动，而是一个中间层。Cursor 的 AI 代理通过 MCP 协议调用你配置的 server，server 再去连 Supabase。所以你的配置里必须同时告诉 Cursor 两件事：用什么命令启动 server，以及 server 连哪个数据库、用什么身份。前者是command和args，后者就是那个容易出错的连接字符串。

很多人以为 MCP 配置就是填个 URL，其实不是。Supabase 的连接串里包含了 host、port、database、user、password 五个要素，任何一个错了都会导致鉴权失败。而且 Supabase 的密码如果包含@、#、%这类字符，必须做 URL 编码，否则解析会断在错误的位置。这就是为什么你看着连接串"没问题"，但 MCP 就是连不上。

还有一个隐藏坑：Cursor 的 MCP 配置有两种方式，一种是图形界面里填，一种是直接改mcp.json。图形界面适合快速试，但一旦要改 Base URL 或者加多个 server，还是得回到mcp.json。这个文件的位置在用户目录下的.cursor文件夹里，Windows 和 macOS 路径不同，后面会给出具体写法。

总结一下这一节要记住的：MCP 连 Supabase 失败，九成不是协议问题，而是连接串的形态和鉴权参数没配对。下一步我们先解决"用哪个连接串"和"Base URL 怎么改"。

2. TaoToken 前置：把鉴权通道指向正确的 Base URL

在配置 MCP 之前，得先理清一个概念：你的 Cursor 里其实有两套"连接"在跑。一套是 Cursor 自己作为 IDE 连 AI 模型服务，另一套是 MCP server 连你的数据库。这两套的鉴权通道是分开的，但很多人会把它们搞混，结果改错了地方。

先说 Cursor 连模型这一层。如果你用的是默认的 OpenAI 或 Anthropic 官方通道，那 Base URL 就是官方地址。但如果你希望统一管理 Key、或者用更灵活的计费方式，可以把 Cursor 的模型请求指向 TaoToken 的 API 地址。这一步不是必须的，但它能让你后面在 MCP 里做验证时，AI 代理的响应更稳定，不会因为模型通道的鉴权问题干扰你判断数据库连接是否成功。

TaoToken 的 API 入口是https://taotoken.net/api，注意这个地址不带任何查询参数。你在 Cursor 的设置里找模型配置，把 Base URL 改成这个，然后把 API Key 填成你在 TaoToken 控制台生成的 Key。这样 Cursor 的 AI 请求就走这条通道了。控制台地址是https://taotoken.net/console，API Keys 管理页在https://taotoken.net/api-keys。

为什么要先做这一步？因为后面你在 Cursor 里发查询验证时，AI 代理需要先能正常调用模型，才能把你的自然语言转成对 MCP 工具的调用。如果模型通道本身就在报 401，你根本分不清是数据库连不上还是模型没配好。先把模型通道理顺，排障时变量就少一个。

具体操作：打开 Cursor 设置，找到 Models 或 AI 配置区域，把 OpenAI 或 Anthropic 的 Base URL 覆盖成https://taotoken.net/api。如果你用的是 Claude Code 类的接入方式，配置里会有ANTHROPIC_BASE_URL这个环境变量，同样指向这个地址。Key 就填sk-开头的那串，从 API Keys 页面复制。

这里有个细节：TaoToken 的 API 地址和 MCP 要连的 Supabase 地址是完全不同的两个东西。前者是模型服务的入口，后者是数据库的入口。你在mcp.json里写的连接串，指向的是 Supabase 的 host，不是 TaoToken。千万别把这两个搞混，否则 MCP server 会去连一个根本不存在的数据库。

配好模型通道后，你可以先在 Cursor 的 Chat 里随便问一句，确认 AI 能正常回复。这一步过了，再进入 MCP 配置。如果这一步就报错，先检查 Key 有没有复制完整、Base URL 有没有多写斜杠。TaoToken 的文档页在https://taotoken.net/doc，里面有各客户端的接入示例，不确定的时候可以对照。

对于长期在 Cursor 里做编码和 Agent 任务的开发者，如果模型调用量比较大，可以考虑用 Coding Plan 来管理额度，入口在https://taotoken.net/coding-plan。这不是必须的，但如果你每天都要让 AI 读数据库、改代码，统一在一个通道里管理会更省心。

这一节的核心就一句话：先把 Cursor 的模型 Base URL 指向https://taotoken.net/api并配好 Key，确保 AI 通道畅通，再去搞 MCP 连数据库。顺序反了，排障会很痛苦。

3. 可复制配置：mcp.json 里 Base URL 与鉴权的正确写法

现在进入正题。Cursor 的 MCP 配置，推荐直接改mcp.json文件，而不是在图形界面里填。因为图形界面里改连接串容易漏掉转义，而且不好版本管理。mcp.json的位置：

macOS / Linux：~/.cursor/mcp.json
Windows：C:\Users\你的用户名\.cursor\mcp.json

如果文件不存在，就手动创建。内容结构是一个 JSON 对象，顶层是mcpServers，里面每个 key 是一个 server 的名字。下面是一个完整的、可复制的配置片段，连 Supabase 用的 postgres server：

{ "mcpServers": { "supabase": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "postgresql://postgres.你的项目ref:你的密码@aws-0-区域.pooler.supabase.com:5432/postgres" ] } } }

这里的关键是第三个参数，也就是那个连接字符串。它决定了 MCP server 连哪个数据库、用什么身份。Supabase 控制台里点顶部的 "Connect" 按钮，会弹出几种连接方式。你要选的是Session Pooler或者Transaction Pooler的 URI，而不是 Direct Connection。因为直连地址在很多网络环境下不通，而 pooler 地址是 Supabase 官方推荐的、走 IPv4 的通道。

连接串的格式拆开看：

postgresql://postgres.[项目ref]:[密码]@[pooler主机]:5432/postgres

postgres.[项目ref]是用户名，注意中间有个点，不是下划线。[密码]是你的数据库密码，如果密码里有@、#、%、:这些字符，必须做 URL 编码。比如@要写成%40，#写成%23。这一步不做，连接串会在密码位置被截断，报出来的错通常是password authentication failed或者invalid URI。

[pooler主机]是 Supabase 给你的 pooler 地址，形如aws-0-ap-southeast-1.pooler.supabase.com。区域部分根据你项目所在区域不同。端口是5432，数据库名是postgres。

如果你在 Cursor 图形界面里配置，对应的字段是：

字段	值
Name	supabase
Type	command
Command	npx -y @modelcontextprotocol/server-postgres "你的连接串"

注意图形界面里连接串要用引号包起来，否则空格和特殊字符会出问题。但更推荐用mcp.json，因为改起来清楚。

还有一个变体：如果你用的是 Supabase 的 Transaction Pooler，端口是6543而不是5432。Transaction Pooler 适合短连接、高并发场景，但 MCP server 这种需要保持会话的场景，用 Session Pooler（端口 5432）更稳。如果你不确定，先用 5432 那个。

配置写好后，保存mcp.json，然后重启 Cursor。重启是必须的，因为 MCP server 是在 Cursor 启动时加载的，改完不重启不生效。重启后，在 Cursor 设置里的 MCP 选项卡下，应该能看到supabase这个 server，状态指示器会从灰变绿。如果一直是红的，看下一节的排障。

这里再强调一次 Base URL 的问题。有些人会把 Supabase 的 REST API 地址（https://xxx.supabase.co）填进来，那是错的。MCP 的 postgres server 要的是 PostgreSQL 连接串，不是 HTTP 地址。两者协议完全不同。你填了 HTTP 地址，server 会报getaddrinfo ENOTFOUND或者直接超时。

如果你同时还想让 Cursor 通过 TaoToken 走模型请求，mcp.json里不需要写 TaoToken 的任何东西。TaoToken 的配置在 Cursor 的模型设置里，和 MCP 是两套。别把https://taotoken.net/api写进mcp.json的 args 里，那会导致 server 启动失败。

配置片段就这些。复制的时候注意把你的项目ref、你的密码、区域替换成你自己的值。密码里的特殊字符记得编码。保存、重启、看状态灯。

4. 验证请求：在 Cursor 里发一次真实查询确认链路

配置绿灯之后，别急着高兴，得实际发一次查询，确认整条链路真的通了。这一步很多人跳过，结果后面用的时候才发现 AI 根本读不到表。

打开 Cursor 的 Chat 面板，切换到 Agent 模式（不是普通的 Ask 模式）。Agent 模式才会去调用 MCP 工具。然后输入一句自然语言，比如：

列出我 Supabase 数据库里所有的表，并告诉我每个表有多少行

如果 MCP server 正常工作，Cursor 的 AI 代理会先调用supabase这个 MCP server 提供的工具，执行一条类似SELECT table_name FROM information_schema.tables WHERE table_schema = 'public'的查询，然后把结果整理给你。你会看到回复里列出了你的表名，可能还有行数统计。

这个过程里，AI 代理实际上做了三件事：理解你的意图、选择调用哪个 MCP 工具、把工具返回的结果转成自然语言。如果中间任何一环断了，你看到的就不是表列表，而是报错。

更直接的验证方式是让 AI 跑一条具体查询：

查一下 users 表里最近注册的 5 个用户，按 created_at 倒序

如果users表存在，AI 会生成对应的 SQL，通过 MCP 执行，然后返回结果。这一步成功，说明鉴权、Base URL、表访问权限全都对了。

如果 AI 回复说"我没有访问数据库的工具"或者"无法连接到数据库"，那说明 MCP server 没被正确加载。回到设置里看状态灯，或者检查mcp.json的 JSON 格式有没有语法错误（比如多了个逗号）。JSON 格式错误会导致整个文件被忽略，Cursor 不会报明显错误，只是 server 不出现。

还有一种情况：AI 说"查询执行失败，permission denied"。这是 Supabase 的行级安全策略（RLS）在起作用。MCP server 用的是postgres用户，这个用户默认有超级权限，一般不会被 RLS 挡住。但如果你在连接串里用了别的用户，或者项目开了强制 RLS，就可能被拦。解决办法是确认连接串里的用户名是postgres.[项目ref]，而不是其他角色。

验证成功后，你可以让 AI 做更复杂的事，比如"帮我看看 orders 表和 users 表的关联字段是什么"，AI 会去查外键约束。这就是 MCP 的价值：AI 有了数据库的实时上下文，不用你手动贴 schema。

这里有个小技巧：第一次验证时，尽量用简单的查询，比如SELECT 1或者列出表名。别一上来就让 AI 做多表 JOIN，那样如果出错，你分不清是连接问题还是 SQL 逻辑问题。先确认链路通，再上复杂度。

如果查询成功返回了数据，恭喜你，整条链路打通了。后面你在 Cursor 里写代码时，AI 可以随时查数据库来验证字段名、检查数据格式，甚至帮你生成迁移脚本。这个体验比手动切到 Supabase 控制台查要顺畅得多。

5. 本篇常见错排查：401、local proxy failed、reading choices

即使按上面的步骤走，还是可能遇到报错。这一节把最常见的几个错误和对应解法列出来，对照着查。

错误一：401 Unauthorized或password authentication failed

这是鉴权失败。原因通常是密码错了，或者密码里的特殊字符没做 URL 编码。检查连接串里的密码部分，如果包含@、#、%、:、/这些字符，必须编码。比如密码是p@ss#123，要写成p%40ss%23123。另外确认你用的是数据库密码，不是 Supabase 的 API Key 或者 anon key。数据库密码在 Project Settings > Database > Database password 里，忘了可以重置。

错误二：local proxy failed或ECONNREFUSED

这个错误说明 MCP server 尝试连的地址不通。最常见的原因是用了 Direct Connection 地址，而你的网络环境不支持 IPv6 直连。换成 Session Pooler 地址就好。Pooler 地址在 Supabase 控制台的 Connect 按钮里，选 "Session pooler" 那个选项卡。主机名形如aws-0-区域.pooler.supabase.com，端口 5432。

错误三：reading 'choices'或Cannot read properties of undefined

这个报错看起来像模型通道的问题，不是数据库问题。通常出现在 Cursor 调用 AI 模型时，返回格式不符合预期。如果你把 Base URL 指向了 TaoToken，检查地址是不是https://taotoken.net/api，有没有多写/v1或者少写。Key 是不是从https://taotoken.net/api-keys复制的完整串。这个错误和 MCP 无关，是模型请求层的问题，但因为它出现在你发查询的时候，容易误判成数据库连不上。

错误四：MCP server 状态灯一直红，但没有任何报错

先检查mcp.json的 JSON 语法。用编辑器的 JSON 校验功能，或者贴到在线校验器里看。常见问题是末尾多了逗号、引号没配对、反斜杠没转义。JSON 不允许注释，也不允许尾逗号。另外确认文件路径正确：macOS 是~/.cursor/mcp.json，Windows 是C:\Users\用户名\.cursor\mcp.json。放错位置 Cursor 读不到。

错误五：OAuth相关报错

如果你在配置里混入了需要 OAuth 的 server，或者 Cursor 尝试用 OAuth 方式连接，会出现这类错误。Supabase 的 postgres MCP server 不需要 OAuth，它用的是数据库原生鉴权。检查mcp.json里有没有多余的oauth字段，或者是不是误配了别的 server。删掉无关配置，只留 postgres 那个。

错误六：查询返回空结果，但表里明明有数据

这通常是 schema 问题。MCP server 默认查publicschema，如果你的表在别的 schema 下，AI 看不到。可以在查询里显式指定 schema，比如SELECT * FROM myschema.mytable。另外确认连接串里的数据库名是postgres，不是别的。

排查顺序建议：先看状态灯，再看mcp.json语法，再看连接串形态，最后看模型通道。大部分问题在前两步就能定位。如果状态灯是绿的但查询失败，那问题在鉴权或权限，重点查密码编码和用户角色。

还有一个容易忽略的点：Cursor 版本。MCP 功能在较新版本的 Cursor 里才稳定，如果你用的是老版本，可能 MCP 选项卡都没有。更新到最新版再试。

6. 配好之后：让 Cursor 真正成为你的数据库搭档

链路通了之后，你会发现 Cursor 的用法变了。以前你写一个查询，得先切到 Supabase 控制台看表结构，再回来写 SQL。现在直接在 Chat 里说"帮我查一下最近 7 天注册的用户，按天分组"，AI 自己去读表、写 SQL、跑查询、返回结果。你甚至可以让它根据查询结果直接生成 TypeScript 类型定义。

对于长期在 Cursor 里做全栈开发的场景，如果模型调用频繁，可以用 Coding Plan 来统一管理额度，入口在https://taotoken.net/coding-plan。这样模型通道和数据库通道各司其职，不会互相干扰。

如果你还想在别的客户端里用同样的模型通道，比如 Claude Code 类的工具，接入文档在https://taotoken.net/doc，里面有环境变量和配置文件的写法。核心还是那三件套：Base URL 填https://taotoken.net/api，Key 从控制台复制，Model ID 按文档里列的填。

回到 MCP 本身。配好 Supabase 之后，你还可以加别的 MCP server，比如文件系统、GitHub、Slack。每个 server 在mcp.json里是一个独立的 key，互不影响。Cursor 的 AI 代理会根据你的问题自动选择调用哪个 server 的工具。这就是 MCP 的设计初衷：一次配置，多处复用。

最后提醒一个实操细节：Supabase 的数据库密码如果重置了，记得同步更新mcp.json里的连接串，然后重启 Cursor。密码变了但配置没改，状态灯会变红，报的还是鉴权错误。这个坑我踩过，排查了半天才想起来是密码轮换了。

配置文件建议纳入版本管理，但别把真实密码提交到 Git。可以用环境变量或者本地覆盖文件的方式管理敏感信息。Cursor 的mcp.json目前不支持直接读环境变量，所以要么手动替换，要么用脚本生成。简单场景下，手动维护一份本地文件就够了。

到这里，从 Supabase 拿连接串、改 Base URL、配mcp.json、验证查询、排障，整条链路就闭环了。你可以让 Cursor 的 AI 直接读你的数据库，写代码时随时验证字段和数据。这个体验一旦用上，很难回去。