与 Vercel 集成
Atlas App Services 数据 API 已弃用。它将于 2025 年 9 月 30 日终止生命周期并被删除。有关详情，请参阅 App Services 文档中的 弃用页面。
您可以将 Atlas 集群连接到使用 Vercel 部署的应用程序。
使用本页完成以下任务：
在Atlas 中连接 Vercel 用户和团队到组织。
为这些用户和团队创建从 Vercel 项目到 Atlas 集群的 链接。
启用 Atlas Data API。
要将您在 Vercel 中部署的无服务器函数连接 Atlas 集群，您还可以使用 MongoDB Node.js 驱动程序或 Mongoose ODM 库。
Considerations
Vercel 中的帐户（个人或团队）
与 Vercel 的集成要求您：
注意
您可以添加一个 Vercel 集成作为个人帐户用户， 然后添加另一个 Vercel 集成作为团队用户。您无法将 Vercel 中现有集成范围 从个人账户更改为团队级别账户。
要从个人 Vercel 账号的 MongoDB 集成切换到同一 Atlas 组织中团队范围的集成，请断开 Atlas 中的现有集成，并添加团队范围的新集成。
Vercel 中的项目
您可以将一个 Atlas 集群链接到 Vercel 中的多个项目。
要配置该集成，您的个人或团队 Vercel 账户中必须有一个或多个项目。
您可以选择用于集成的 Vercel 项目列表取决于用户或团队范围。
Atlas 中的 IP 访问列表和 Vercel 中的 IP 允许列表
要连接到 Atlas 集群，Atlas 集群的 IP 访问列表必须支持所有 IP 地址 (0.0.0.0/0)。如果 Atlas 没有在 Atlas 项目的 IP 访问列表中找到 0.0.0.0/0 的条目，则作为集成工作流程的一部分，Atlas 会代表您添加此条目。
当您设置集成时，Atlas 会执行以下操作，保护 Vercel 与集群的连接：
创建
MONGODB_URI环境变量，作为您将此集群链接到所有 Vercel 项目的 Atlas 集群的连接字符串。当应用程序未指定数据库时，
MONGODB_URI变量使用/myFirstDatabase作为默认数据库名称。将此名称替换为您的数据库名称，或者如果您使用库与 MongoDB 交互，请确保您的应用程序代码指定您的数据库名称。在管理员数据库中创建数据库用户
vercel-admin-user，并将内置 readWriteAnyDatabase MongoDB 数据库角色授予集群中的所有其他非系统数据库。
添加 Vercel 集成
此过程允许您在 Atlas 中创建新帐户及其组织、项目和用户角色，然后创建新集群，或使用现有 Atlas 帐户、组织、项目和 Atlas 集群与 Vercel 集成。
要将 Vercel 应用程序与 Atlas 集群集成，请从 Vercel UI 开始。
导航到 MongoDB Atlas 集成。
前往 Vercel 中的 MongoDB Atlas 集成，然后单击 Add integration。
选择集成范围（用户或团队）。
从下拉菜单中选择一个 Vercel 范围：
Personal Account
Team
设置集成范围后无法更改。要切换到与所选范围不同的范围，请断开一个集成并使用此步骤创建另一个集成。
单击 Continue（连接）。
如果您还没有账户，请创建您的 MongoDB 账户。
选择以下其中一个选项：
如果使用 Google 账户，请按照步骤登录，或创建一个新的 Google 账户。
如果使用电子邮件，则该电子邮件已填写并显示为灰色。
如果贵公司使用联合身份验证，请使用贵公司的电子邮件地址。继续执行联合用户访问所需的验证步骤。
如果您已经拥有 Atlas 账户，请单击 Log in now。请参阅登录 Atlas 帐户。
输入您的名字和姓氏，然后选择密码。密码长度至少 8 个字符，包含唯一字符、数字或符号，并且不包含您的电子邮件地址。请参阅注册新的 Atlas 账户。
单击复选框 I accept the Privacy Policy and the Terms of Service（我接受隐私政策和服务条款）。
选择要与 Vercel 集成的 Atlas 组织。
从下拉列表中选择 Atlas 组织，或创建新的 Atlas 组织。
单击 Continue（连接）。
确认对 Atlas 组织的访问权限。
Atlas 为您创建组织。单击 I Acknowledge，确认您授予 Vercel 对 Atlas 组织的访问权限。
要删除此 Vercel 集成对 MongoDB Atlas 组织的访问权限，您必须断开此集成。
从下拉列表中选择要与 Vercel 集成的 Atlas 项目，或创建新项目。
（可选）。切换 Enable the Atlas Data API 开关。启用 Atlas Data API，允许您使用 HTTPS 连接到该组织中的 Atlas 数据库。
创建新的免费套餐集群，或将现有集群链接到一个或多个 Vercel 项目。
如果您已经拥有 Atlas 帐户，则可以选择现有的组织和项目， 然后选择现有的集群。
确保您拥有 Atlas Project Owner 角色。
从映射左侧的下拉列表中选择 Atlas 集群。
从右侧的下拉列表中选择一个或多个 Vercel 项目。您可以将一个 Atlas 集群映射到一个或多个 Vercel 项目。下拉菜单显示一个项目或所有项目，具体取决于您在此过程中为此集成所做的选择。稍后，您可以将更多的 Vercel 项目链接到此集成中的同一 Atlas 集群。
如果所选项目的 Atlas 访问列表中没有 0.0.0.0./0 条目，Atlas 会要求您确认，由于 Vercel 中的动态 IP 地址，您正在创建具有完全访问权限的 Atlas 集群。Atlas 会向您发送一封电子邮件，告知您这些信息。
如果您没有 Atlas 集群，请创建新集群。您稍后可以修改所创建的集群。
确保您拥有 Atlas
Project Owner角色。Atlas 会创建一个新的免费套餐集群，并将其链接到您选择的 Vercel 项目。 您稍后可以将更多 Vercel 项目链接到同一个 Atlas 集群。
单击，确认这些声明：
在 Atlas UI 中管理 Vercel 集成
要管理与 Vercel 的集成，请执行以下操作：
在 Atlas 中，转到 Organization Settings（项目设置）页面。
如果尚未显示，组织从导航栏中的Organizations菜单。
单击 Organizations 菜单旁边的 Organization Settings 图标。
显示“组织设置”页面。
转到 Organization Integrations（快速入门）页面。
单击侧边栏中的 Integrations（支持）。
显示组织集成页面。
链接其他 Atlas 集群
要将组织中的其他集群链接到 Vercel 中的项目，请执行以下操作：
注意
对已配置的集成使用此步骤。要配置初始集成，请参阅添加 Vercel 集成。
在 Atlas 中，转到 Organization Settings（项目设置）页面。
如果尚未显示，组织从导航栏中的Organizations菜单。
单击 Organizations 菜单旁边的 Organization Settings 图标。
显示“组织设置”页面。
转到 Organization Integrations（快速入门）页面。
单击侧边栏中的 Integrations（支持）。
显示组织集成页面。
将另一个 Atlas 集群链接到一个或多个 Vercel 项目。
单击 Link Clusters（连接）。
Add Another Cluster Link with Vercel 窗口打开并显示您的 Atlas 组织。
选择一个 Atlas 项目。
选择左侧下拉列表中未链接到 Vercel 的集群。如果您的项目没有其他 Atlas 集群，可以创建一个。
在右侧下拉列表中，选择一个或多个 Vercel 项目。
（可选）。切换 Enable the Atlas Data API 开关。启用 Atlas 数据 API，使您能够使用 HTTPS 连接到此组织中的 Atlas 数据库。
单击 Save（连接）。
您将收到 Atlas 发送的一封确认电子邮件，其中包含集成的 详细信息。
一个链接的新 Atlas 集群出现在链接集群列表中。
如需将组织内另一个 Atlas 项目的集群链接到 Vercel， 请重复该项目的此过程。
编辑或删除指向 Atlas 集群的链接
您可以添加或删除链接到 Atlas 集群的 Vercel 项目。
在 Atlas 中，转到 Organization Settings（项目设置）页面。
如果尚未显示，组织从导航栏中的Organizations菜单。
单击 Organizations 菜单旁边的 Organization Settings 图标。
显示“组织设置”页面。
转到 Organization Integrations（快速入门）页面。
单击侧边栏中的 Integrations（支持）。
显示组织集成页面。
如需添加或删除部分 Vercel 项目，请单击链接的 Atlas 项目旁边的 Edit（编辑）。
Atlas 显示现有的链接 Vercel 项目。
编辑右侧列表中的现有链接，从下拉列表中选择一个项目。 你可以执行以下操作：
单击列表中 Vercel 项目旁边的，将其添加到该集群的集成中。
点击 从此集成中删除一些 Vercel 项目。
（可选）。切换 Enable the Atlas Data API 开关。启用 Atlas 数据 API，使您能够使用 HTTPS 连接到此组织中的 Atlas 数据库。
如需删除与所有 Vercel 项目的链接，请单击链接的 Atlas 项目旁边的 Unlink（取消链接）。
Atlas 要求您确认是否要取消集群与项目的链接。要确认，请单击 Unlink 。Atlas 会删除在您将项目链接到 Atlas 集群时为 Vercel 项目创建的环境变量。
如果取消所有项目的链接，Atlas 的行为如下。其：
不会删除为该集成创建的数据、 数据库用户或 IP 访问列表。
不会删除集群或集成，即使 Atlas 用户界面可能显示您的集成中没有关联集群。要禁用集成，必须断开 Vercel 的连接。
断开与 Vercel 集成的连接
断开 Vercel 项目与 Atlas 集群的连接之前，为避免连接到同一 Atlas 集群的任何应用程序停机，请验证集群的用户和网络访问规则是否共享连接到此 Atlas 集群的其他项目和应用程序。
在 Atlas 中，转到 Organization Settings（项目设置）页面。
如果尚未显示，组织从导航栏中的Organizations菜单。
单击 Organizations 菜单旁边的 Organization Settings 图标。
显示“组织设置”页面。
转到 Organization Integrations（快速入门）页面。
单击侧边栏中的 Integrations（支持）。
显示组织集成页面。
确认要断开此 Vercel 集成。
Atlas 会要求您确认是否要断开 Atlas 组织与 Vercel 的连接。
断开集成可能会导致您的 Vercel 应用程序 和连接到您与 Vercel 链接的 Atlas 集群的任何其他应用程序停机。
要确认，请以大写字母输入 Disconnect Vercel ，然后单击 Disconnect Vercel （断开 Vercel 连接）。
Atlas 通过删除 Vercel 项目的环境变量来删除集成， 环境变量创建于您将项目链接到 Atlas 集群时。
Vercel 还删除了集成，并且不再显示在 Vercel 用户界面中。
断开 Vercel 集成后，如果您尚未删除用户、访问列表或 Atlas Data API 密钥，那么您可以：
注意
删除 Vercel 用户界面中的集成时，Atlas 也会删除集成，因此无需在 Atlas 用户界面中断开集成。