Opsera MCP Server

Opsera-MCP-Server（注：这可能是一个特定软件或服务的名称，根据上下文，“Opsera”和“MCP”可能是该服务的专有名词，因此直接翻译为“Opsera-MCP-服务器”或保持原样作为专有名词使用）

Opsera MCP 配置指南

本指南将引导您完成在Cursor IDE中配置Opsera MCP（模型上下文协议）服务器访问的步骤。

先决条件

• 使用有效登录凭据访问Opsera门户

配置步骤

步骤1：访问Opsera门户

1. 导航至您的Opsera门户
2. 使用您的凭据登录
3. 登录后，您将看到Opsera的主页

步骤2：导航至个人访问令牌

Profile and Access Tokens

1. 点击右上角的个人资料图标
2. 从下拉菜单中选择 “Profile”翻译成中文是“简介”或“个人资料”
3. 你将降落在 “我的个人资料” 页面
4. 点击 “访问令牌” 页面顶部的标签

步骤3：生成API访问令牌

Generate Personal Access Token

在……上 “访问令牌” 页面，你会看到 “生成个人访问令牌” （1）部分；（2）章节；（3）部门；（4）区段。

请填写以下字段：

名字

• 为您的代币输入一个描述性名称（例如，“MCP 集成”）
• 允许使用空格、字母、数字、连字符、冒号、下划线和句点

过期后

• 从下拉菜单中选择有效期（默认：1个月）
• 选项通常包括：1个月、3个月、6个月、1年

范围

• 选择 API访问 （完全读/写访问权限）
• 这授予对API的完全读/写访问权限，包括基于单个资源访问规则的所有Pipeline和Tool Registry路由

创建代币

点击 “创造” 创建令牌的按钮。

重要提示： 生成后，请立即复制该令牌！ - 该令牌仅显示一次 - 它将以JWT格式呈现（以"eyJ..."开头） - 妥善保存，因为你再也看不到它了

步骤4：在Cursor IDE中配置MCP

1. 找到您的 Cursor MCP 配置文件：

- macOS/Linux： ~/.cursor/mcp.json - Windows（系统/操作系统）： %USERPROFILE%\.cursor\mcp.json

1. 打开 mcp.json 在文本编辑器中打开文件

1. 添加Opsera MCP服务器配置，并使用您的API密钥：

{
  "mcpServers": {
    "opsera-ai-agent": {
      "url": "https://agent.opsera.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN_HERE"
      }
    }
  }
}

1. 替换 "YOUR_API_TOKEN_HERE" 使用你在步骤3中复制的实际API令牌

1. 保存 mcp.json 文件

步骤5：验证配置

1. 保存 mcp.json 文件
2. 现在，Opsera MCP 服务器应该已出现在您的 MCP 工具列表中
3. 您可以通过检查您的可用MCP功能中是否出现与Opsera相关的工具和函数来验证连接

配置示例

完整的示例 mcp.json 文件：

{
  "mcpServers": {
    "opsera-ai-agent": {
      "url": "https://agent.opsera.io/mcp",
      "headers": {
        "Authorization": "Bearer ey..."
      }
    }
  }
}

注： 上面显示的令牌是简写形式。您实际的令牌会更长。

故障排除

认证错误（401 未授权）

• 验证您的API令牌是否正确且未过期
• 检查令牌是否具有所需的范围/权限（应为“API访问”）
• 如果当前令牌已过期，请生成一个新的令牌
• 确保标记前后没有多余的空格

连接错误

• 验证URL是否适用于您的Opsera实例
• 检查您的网络连接和互联网连通性
• 确认代理URL在您的网络中可访问

MCP 服务器未出现在光标中

• 完全重启 Cursor IDE（关闭所有窗口）
• 检查一下 mcp.json 语法是有效的JSON格式
• 验证文件是否保存在正确的位置
• 检查文件权限以确保文件可读

令牌已过期

1. 返回个人访问令牌页面
2. 生成一个带有适当过期日期的新令牌
3. 更新 mcp.json 使用新令牌进行文件操作（或“与新令牌一起处理文件”）
4. 重启 Cursor IDE

可用的Opsera MCP工具

一旦成功配置，您将能够通过MCP接口访问各种Opsera操作，包括：

• 管道作业

支持

如需更多帮助或有疑问：

电子邮件： support@opsera.io（可译为：“支持邮箱：support@opsera.io” 或 “联系邮箱：support@opsera.io”，具体根据语境选择更贴切的表述）