如何将托管后端连接到我的项目？

想想后端对于一个典型应用意味着什么：一个存储数据行的数据库、用户登录的方式、存放文件的地方，以及最好能有实时更新让两个浏览器标签页保持同步。这些概念本身并不复杂——但传统接入方式意味着要搭建服务、管理凭证，还要确保这些凭证不出现在 git 历史或客户端代码包里。对于一个可能永远不会上线的原型来说，这些繁文缛节纯粹是摩擦。

LingCode Cloud 的解决方案是为每个项目配备一个托管后端。"托管"意味着 Postgres、身份验证、存储和邮件服务都由 LingCode 负责运行——你永远不需要在第三方服务上创建账号或复制密钥。"每个项目"意味着你连接的每个文件夹都有自己独立的数据库（一个带有行级安全的私有 Postgres schema），即使两个项目共享同一套基础设施，它们也无法互相访问对方的数据。

连接本身的设计非常精简：它告诉项目的智能体如何连接后端。之后，你用自然语言与智能体交流——"让用户能够注册并保存笔记"——它会自动创建数据表并编写代码。本教程将解释"连接"实际上做了什么、完整操作步骤，以及如何管理连接结果。

你将学到什么

• Connect Backend 操作的实际作用（以及它不做什么）
• 后端如何绑定到项目——以及为什么重新打开同一文件夹会复用同一个后端
• 开箱即用的功能：数据库、身份验证、存储、实时更新、向量搜索
• 如何通过提示驱动它，以及如何在 Web 控制台中管理它
• 断开连接、重新连接，以及需要注意的一个陷阱

"Connect Backend" 真正做了什么

连接项目时会发生两件事，了解它们的区别很重要，因为它们可以独立失败或成功：

• 在项目文件夹中写入 .mcp.json。该文件注册了一个 lingcode-cloud MCP 服务器——智能体与后端通信的桥梁。它包含你的账号令牌和一个项目密钥（文件夹路径的稳定哈希值），确保智能体的调用只作用于这个项目的后端。
• 配置后端。连接操作会即时为项目创建托管 Postgres 后端，让它立即出现在控制台中。（如果这一步网络请求失败也没关系——智能体会在首次使用时自动完成配置。）

项目密钥是关键所在。由于它是从文件夹路径派生的，重新打开同一文件夹并重新连接会复用同一个后端——你的数据还在。移动或重命名文件夹会改变密钥，LingCode 会将其视为新项目（旧后端不会被删除，只是这个项目不再指向它）。

连接步骤

1. 在 Mac IDE 中登录你的 LingCode 账号（活动栏中的账号菜单）。后端将在此账号下创建。
2. 打开项目文件夹——任何本地文件夹均可。后端会绑定到这个文件夹的路径。
3. 选择 Account → LingCode Cloud → Connect Backend to This Project。你会收到确认提示，说明托管后端已创建且 .mcp.json 已写入。（稍后再次连接只会刷新令牌——操作是安全且幂等的。）
4. 开启一个新的 Claude (Native) 会话（必须是新会话，这样它才能重新读取 .mcp.json 并加载 lingcode-cloud 工具）。
5. 提出需要持久化或账号功能的需求，例如：
   "构建一个笔记应用，用户可以注册，每个人只能看到自己的笔记。使用 lingcode-cloud 作为后端。"

随后，智能体会调用 provision_backend（确保后端存在）、apply_migration（创建应用所需的数据表），然后基于后端的数据 API 编写应用代码。你无需粘贴任何密钥——工具已通过连接完成了身份验证。

开箱即用的功能

连接的后端不只是一个数据库。每个项目后端都包含：

• 带行级安全的 Postgres——真正的 SQL 数据表，每位用户隔离，已登录用户只能读写自己的数据行。
• 内置身份验证——邮箱/密码、无密码魔法链接、邮箱一次性验证码，以及社交登录（Google、GitHub，Apple 可选接入）。托管提供商无需任何配置。
• 文件存储——上传并通过公开 URL 提供文件访问。
• 实时更新——订阅数据表，获取经 RLS 过滤的 INSERT/UPDATE/DELETE 实时事件，让聊天、协作列表和仪表盘无需轮询即可实时更新。
• 向量搜索（pgvector）——存储向量嵌入并按相似度排序，适用于"按语义搜索笔记"、RAG 和推荐等场景。
• 事务性邮件——无需 API 密钥或发件人配置，直接发送邮件。

智能体了解所有这些功能，并会自动选用合适的方案——在需要实时性时订阅实时事件而非轮询，在你要求语义搜索时添加向量列，等等。

在控制台中管理

智能体配置的所有内容都可以在 lingcode.dev/backends 中查看和编辑，使用同一账号登录即可。控制台提供项目切换器，并针对每个后端提供以下功能：

• 数据库——浏览数据表，排序和翻页，直接插入/编辑/删除数据行（所有者视图绕过 RLS，类似表格编辑器）。
• 身份验证——查看已注册用户；删除用户。
• SQL——执行只读查询，或通过迁移修改 schema。
• 设置——重命名项目，复制连接详情，或删除后端。

这里的连接详情（数据 URL 和 anon key）也可以粘贴到其他 MCP 客户端——如 Claude Desktop 或 Cursor——从 IDE 外部访问同一个后端。

断开连接、重新连接和注意事项

Account → LingCode Cloud → Disconnect Backend 会从 .mcp.json 中移除 lingcode-cloud 条目。它不会删除后端或其数据——稍后重新连接同一文件夹会直接找回同一个后端（记住：项目密钥就是文件夹路径）。如需真正销毁后端及其数据，请在控制台的"设置"中使用 Delete backend。

值得再次强调的注意事项：后端归属于 IDE 登录的账号，以文件夹路径为标识符。如果项目后端"消失"了，请检查：（1）IDE 和 Web 控制台是否使用了同一个账号，（2）文件夹是否被移动过。这两点很容易核查，也能解释绝大多数"后端去哪儿了"的疑问。

接下来