跳到主内容

将ChatGPT连接到MCP

将ChatGPT连接到Casdoor的MCP服务器，以便您能从ChatGPT管理应用程序、用户和资源。 需要 ChatGPT Plus 或支持 MCP 的 Enterprise（OpenAI 文档)。

先决条件​

  • 运行中的 Casdoor 实例（ChatGPT 集成需启用 HTTPS）
  • 具备MCP支持的ChatGPT Plus或企业账户
  • 对您的Casdoor实例拥有管理员访问权限，以便创建应用

步骤1：在Casdoor中创建一个应用​

为ChatGPT的OAuth创建一个Casdoor应用：

  1. 登录您的Casdoor管理面板

  2. 导航至应用并点击添加

  3. 使用以下设置配置应用程序：

    • 名称：chatgpt-mcp（或您偏好的名称）

    • 显示名称：ChatGPT MCP 客户端

    • 组织：选择您的组织

    • 重定向 URI：添加ChatGPT OAuth回调URL：

      https://chat.openai.com/auth/callback
警告

ChatGPT要求OAuth回调使用HTTPS。 确保您的Casdoor实例可通过HTTPS访问。

  1. 授权类型：启用授权码和刷新令牌

  2. 启用PKCE：为增强安全性，请勾选此选项

  3. 令牌格式：JWT（推荐）

  4. （可选）应用类型**：设置为代理

  5. (可选) 类别：设置为 MCP 以实现更佳组织

    信息
    有关类别和类型选项，请参阅应用类别。

:::

  1. 单击保存，并记下下一步所需的客户端ID和客户端密钥。

步骤2：配置ChatGPT MCP连接​

ChatGPT 支持通过其设置界面连接到 MCP 服务器。

访问MCP设置​

  1. 点击左下角的个人资料图标
  2. 点击左下角的个人资料图标
  3. 前往设置→测试功能
  4. 启用模型上下文协议（如果尚未启用）
  5. 导航至设置→MCP服务器

添加Casdoor MCP服务器​

  1. 点击添加服务器或**+ 新增服务器**

  2. 填写服务器详细信息：

    • 服务器名称：Casdoor（或您偏好的名称）
    • 服务器URL：https://your-casdoor.com/api/mcp
    • 身份验证类型：选择 OAuth 2.0
    • 客户端ID：您在第1步中获取的客户端ID
    • 客户端密钥：您在第1步获得的客户端密钥
    • 授权URL：https://your-casdoor.com/api/login/oauth/authorize
    • 令牌URL：https://your-casdoor.com/api/login/oauth/access_token
    • 作用域**: read:application write:application openid profile email

  3. 单击保存或连接

备注

具体的界面和字段名称可能因ChatGPT当前界面而异。 请参阅ChatGPT的帮助文档，以获取最新说明。

配置作用域​

您配置的作用域控制着ChatGPT拥有的权限。 常见作用域包括：

  • read:application - 查看应用
  • write:application - 创建、更新、删除应用程序
  • read:user - 查看用户
  • write:user - 创建、更新、删除用户
  • openid profile email - 基本用户信息（OAuth所需）

有关可用作用域的完整列表，请参阅授权与作用域。

步骤3：完成OAuth流程​

添加服务器配置后：

  1. ChatGPT 将自动启动 OAuth 流程
  2. 您将被重定向到Casdoor登录页面（如果尚未登录）
  3. 登录后，您将看到一个同意屏幕，要求您授权ChatGPT
  4. 同意屏幕会显示所请求的作用域（权限）
  5. 点击授权以授予访问权限
  6. 您将被重定向回ChatGPT，并收到一条成功消息
  7. 连接现已建立
提示

OAuth令牌由ChatGPT安全存储。 除非您撤销令牌或更改作用域，否则无需重新授权。

步骤4：验证连接​

通过在新对话中让ChatGPT与Casdoor交互来测试连接：

示例提示词供尝试：

  • “使用Casdoor列出所有应用”
  • “向我展示关于Casdoor中名为‘my-app’的应用程序的详细信息”
  • “在Casdoor中为组织‘my-org’创建一个名为‘test-app’的新应用程序”

ChatGPT将使用MCP工具执行这些命令。 您应该会看到来自您的Casdoor实例的数据响应。

**“列出所有应用”的预期输出：”

I've connected to your Casdoor instance and found the following applications:

1. chatgpt-mcp (ChatGPT MCP Client)
   - Organization: my-org
   - Created: 2024-01-15

2. app-built-in (Casdoor)
   - Organization: built-in
   - Default application

...

替代方案：使用MCP代理（高级）​

如果ChatGPT不支持直接连接MCP服务器，或者您需要更多控制权，可以使用MCP代理服务：

使用云 MCP 代理​

  1. 在云平台上部署一个MCP代理服务，该服务会将请求转发到您的Casdoor实例
  2. 使用您的Casdoor OAuth凭据配置代理
  3. 将代理URL添加到ChatGPT，而非直接使用Casdoor URL

示例：使用 @modelcontextprotocol/sdk 部署 MCP 代理​

使用官方的@modelcontextprotocol/sdk构建代理服务器：

npm install @modelcontextprotocol/sdk express
// server.js
const express = require('express');
const app = express();

// Forward MCP requests to Casdoor with OAuth token injection
app.use('/mcp', async (req, res) => {
  const targetUrl = process.env.CASDOOR_URL + '/api/mcp';
  // Implement token forwarding logic here using @modelcontextprotocol/sdk
  // Refer to the MCP SDK documentation for transport and auth options
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`MCP proxy listening on port ${PORT}`);
});

设置环境变量：

  • 设置环境变量：
  • OAUTH_CLIENT_ID：您的客户端 ID
  • OAUTH_CLIENT_SECRET: 您的客户端密钥
  • OAUTH_SCOPES: 以空格分隔的范围列表

故障排除​

问题：“无法连接到 MCP 服务器”​

原因: MCP 服务器 URL 可能不正确或无法访问。

解决方案：

  • 验证ChatGPT设置中的URL是否正确
  • 确保您的Casdoor实例可通过HTTPS公开访问
  • 手动测试MCP端点：curl https://your-casdoor.com/api/mcp

问题：OAuth期间出现“重定向URI不匹配”错误​

原因：回调URL与Casdoor中配置的重定向URI不匹配。

解决方案：

  • 在Casdoor中，请确保您的应用程序拥有正确的重定向URI：

    https://chat.openai.com/auth/callback

  • 请查阅ChatGPT的文档，了解当前的回调URL

问题：“需要HTTPS”错误​

原因：ChatGPT的OAuth流程要求使用HTTPS。

解决方案：

  • 确保您的 Casdoor 实例使用 HTTPS
  • 为您的域名配置SSL证书
  • 使用带有自动HTTPS功能的反向代理（Nginx、Caddy）
  • 对于开发，可考虑使用ngrok或类似的隧道服务

问题：“CORS错误”出现在OAuth流程中​

原因：跨源资源共享（CORS）限制。

解决方案：

  • Casdoor应自动为OAuth端点允许CORS
  • 如果使用反向代理，请确保正确转发CORS标头
  • 检查您的Casdoor CORS配置，以确保支持ChatGPT的域名

问题：“insufficient_scope”错误​

原因：所请求的操作需要一个未被授予的作用域。

解决方案：

  • 在ChatGPT的MCP服务器设置中更新作用域
  • 示例：如果您想创建或修改应用程序，请添加write:application
  • 重新连接服务器以获取具有更新作用域的新令牌

问题：长对话中OAuth令牌过期​

原因：访问令牌在一定时间后会过期。

解决方案：

  • 请确保您的Casdoor应用程序中已启用刷新令牌授权类型（步骤1）
  • ChatGPT应自动刷新令牌，但如果刷新失败，您可能需要重新连接

问题：对话中MCP服务器不可用​

原因：服务器可能未正确连接或未被识别。

解决方案：

  • 在ChatGPT设置中验证连接
  • 在您的提示中明确提及“使用Casdoor MCP服务器”
  • 开启新对话以确保全新初始化

安全注意事项​

  • 仅限HTTPS：与ChatGPT集成时，生产环境的Casdoor实例务必始终使用HTTPS
  • PKCE（代码交换证明密钥）：在您的Casdoor应用中始终启用PKCE
  • 作用域：遵循最小权限原则——仅授予ChatGPT所需的范围
  • 令牌存储：ChatGPT 将令牌安全地存储在 OpenAI 的基础设施上
  • 客户端密钥：请妥善保管您的客户端密钥——不要在对话中分享它
  • 令牌撤销：您可以在Casdoor的管理面板中，在令牌选项下撤销访问令牌
  • 审计日志：监控Casdoor的审计日志，以查看ChatGPT执行的操作

隐私考量​

警告

使用ChatGPT与Casdoor MCP服务器时，请注意：

  • 您的Casdoor实例中的数据可能会被OpenAI处理
  • 请勿分享敏感的用户信息、密码或密钥
  • 查看OpenAI的隐私政策和服务条款
  • 考虑对敏感字段使用数据脱敏或过滤

当ChatGPT连接到Casdoor的MCP服务器时，您可以：​

当ChatGPT连接到Casdoor的MCP服务器时，您可以：

  • 自然语言查询：「显示上周创建的所有用户」
  • 批量操作：「为开发创建5个测试应用」
  • 配置协助：「app-xyz当前的OAuth配置是什么？」
  • 故障排除: “为什么用户John无法登录？”
  • 文档: “说明我们认证系统的设置”
  • 报告: “生成所有活跃应用的汇总”

下一步​

现在ChatGPT已连接到Casdoor：

相关资源​