Opsera-MCP-Server（注：这可能是一个特定软件或服务的名称，根据上下文，“Opsera”和“MCP”可能是该服务的专有名词，因此直接翻译为“Opsera-MCP-服务器”或保持原样作为专有名词使用）
Opsera MCP 配置指南
本指南将引导您完成在Cursor IDE中配置Opsera MCP（模型上下文协议）服务器访问的步骤。
先决条件
- 使用有效登录凭据访问Opsera门户
配置步骤
步骤1：访问Opsera门户
- 导航至您的Opsera门户
- 使用您的凭据登录
- 登录后，您将看到Opsera的主页
步骤2：导航至个人访问令牌
- 点击右上角的个人资料图标
- 从下拉菜单中选择 “Profile”翻译成中文是“简介”或“个人资料”
- 你将降落在 “我的个人资料” 页面
- 点击 “访问令牌” 页面顶部的标签
步骤3：生成API访问令牌
在……上 “访问令牌” 页面，你会看到 “生成个人访问令牌” （1）部分；（2）章节；（3）部门；（4）区段。
请填写以下字段：
名字
- 为您的代币输入一个描述性名称（例如，“MCP 集成”）
- 允许使用空格、字母、数字、连字符、冒号、下划线和句点
过期后
- 从下拉菜单中选择有效期（默认：1个月）
- 选项通常包括：1个月、3个月、6个月、1年
范围
- 选择 API访问 （完全读/写访问权限）
- 这授予对API的完全读/写访问权限，包括基于单个资源访问规则的所有Pipeline和Tool Registry路由
创建代币
点击 “创造” 创建令牌的按钮。
重要提示： 生成后，请立即复制该令牌！ - 该令牌仅显示一次 - 它将以JWT格式呈现（以"eyJ..."开头） - 妥善保存，因为你再也看不到它了
步骤4：在Cursor IDE中配置MCP
- 找到您的 Cursor MCP 配置文件：
- macOS/Linux： ~/.cursor/mcp.json - Windows（系统/操作系统）： %USERPROFILE%\.cursor\mcp.json
- 打开
mcp.json在文本编辑器中打开文件
- 添加Opsera MCP服务器配置，并使用您的API密钥：
{
"mcpServers": {
"opsera-ai-agent": {
"url": "https://agent.opsera.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN_HERE"
}
}
}
}- 替换
"YOUR_API_TOKEN_HERE"使用你在步骤3中复制的实际API令牌
- 保存
mcp.json文件
步骤5：验证配置
- 保存
mcp.json文件 - 现在，Opsera MCP 服务器应该已出现在您的 MCP 工具列表中
- 您可以通过检查您的可用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格式 - 验证文件是否保存在正确的位置
- 检查文件权限以确保文件可读
令牌已过期
- 返回个人访问令牌页面
- 生成一个带有适当过期日期的新令牌
- 更新
mcp.json使用新令牌进行文件操作（或“与新令牌一起处理文件”） - 重启 Cursor IDE
可用的Opsera MCP工具
一旦成功配置，您将能够通过MCP接口访问各种Opsera操作，包括：
- 管道作业
支持
如需更多帮助或有疑问：
电子邮件： support@opsera.io（可译为：“支持邮箱：support@opsera.io” 或 “联系邮箱：support@opsera.io”，具体根据语境选择更贴切的表述）