Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs 菜单
Docs 主页
/
MongoDB MCP 服务器
/

使用 OpenID Connect (OIDC) 进行连接

您可以使用 OpenID Connect (OIDC)身份验证与MongoDB MCP服务器连接到MongoDB Enterprise部署或MongoDB Atlas 群集。

要学习;了解详情,请参阅使用 OIDC/OAuth 2.0 进行身份验证和授权。

要使用 OIDC 连接到MongoDB 部署,请在 MCP服务器配置中配置以下选项:

CLI选项名称
操作系统环境变量名称
类型
必要性
说明

authenticationMechanism

MDB_MCP_AUTHENTICATION_MECHANISM

字符串

必需

设置为 MONGODB-OIDC 可使用 OIDC身份验证。

oidcFlows

MDB_MCP_OIDC_FLOWS

字符串数组

Optional

以逗号分隔的列表形式指定 OIDC 流。OIDC 流指定MongoDB MCP服务器如何与身份提供商交互以进行身份验证进程。MongoDB MCP服务器支持以下 OIDC 流:auth-codedevice-auth

oidcRedirectUri

MDB_MCP_OIDC_REDIRECT_URI

字符串

Optional

指定身份提供程序在身份验证后将您重定向的 URI。URI 必须与身份提供程序的配置匹配。默认值:http://localhost:27097/redirect

browser

MDB_MCP_BROWSER

字符串

Optional

指定启用 MONGODB-OIDC 时MongoDB MCP服务器重定向到的浏览器。

oidcIdTokenAsAccessToken

MDB_MCP_OIDC_ID_TOKEN_AS_ACCESS_TOKEN

布尔

Optional

指定MongoDB MCP服务器是否使用从身份提供商收到的ID令牌而不是访问权限令牌。将此选项与您无法配置的身份提供程序一起使用以提供JSON web token访问权限令牌。

oidcTrustedEndpoint

MDB_MCP_OIDC_TRUSTED_ENDPOINT

字符串

Optional

指定一个与受信任端点的连接(不是 Atlas 或 localhost),以确保访问令牌发送到受信任的服务器。仅在连接到您信任的服务器时使用此选项。

MongoDB MCP服务器支持两种 OIDC 流:

  • 授权代码流(默认)

  • 设备授权授予流程(当基于浏览器的身份验证不可用时)

注意

当您将MongoDB MCP 服务器配置为接受远程连接时,它会使用设备授权授予流。

授权代码流是默认的OIDC 机制。在此流程中,用户在浏览器中向身份提供商(IdP) 进行身份验证,MCP服务器将授权代码交换为令牌。

  • 如果使用MongoDB连接字符串启动服务器,则服务器将在初创企业时完成基于浏览器的身份验证。

  • 如果您使用 MCP 服务器的 connect 工具,身份验证将以交互方式运行。正在进行身份验证时,无法执行需要数据库连接的操作。如果登录没有立即完成,则尝试超时,您可以重试。您可以查看 MCP服务器日志以了解详细信息。

在浏览器不可用的环境中,MCP 服务器使用设备授权授予流程。当 MCP 服务器使用HTTP传输运行时,可以使用设备授权。有关使用HTTP传输 (--transport http) 运行MCP 服务器的说明,请参阅MongoDB MCP 服务器配置。

要启动设备授权:

1
2
3

正在进行身份验证时,无法执行需要数据库连接的操作。如果登录没有立即完成,则尝试超时,您可以重试。有关详细信息,请参阅 MCP服务器日志。

后退

安全性

在此页面上