Scalekit Mcp Server

开发 TypeScript

🚀 Scalekit MCP 服务器

Scalekit MCP 服务器是一款强大的工具，它基于模型上下文协议（MCP），为管理 Scalekit 环境、组织、用户、连接和工作区操作提供了全面的支持。开发者可以借助该服务器，通过简单的自然语言查询，将自己的 AI 工具与 Scalekit 的上下文和功能相连接。

🚀 快速开始

Scalekit MCP 服务器能够让 AI 助手通过一套标准化工具与 Scalekit 的身份和访问管理平台进行交互。它提供了安全的、由 OAuth 保护的访问方式，可用于管理环境、组织、用户、认证连接等。

✨ 主要特性

环境管理与配置
组织和用户管理
工作区成员管理
OIDC 连接设置与管理
MCP 服务器注册与配置
角色和范围管理
管理门户链接生成

📦 安装指南

配置说明

根据你的 MCP 主机，以下是将 Scalekit 添加为 MCP 服务器的配置说明：

VS Code（版本 1.101 或更高）

使用 OAuth	使用 mcp - remote 代理

{
"servers": {
"scalekit": {
"type": "http",
"url": "https://mcp.scalekit.com/"
}
}
}

{
"mcpServers": {
"scalekit": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.scalekit.com/"]
}
}
}

Claude Desktop

配置 Claude 应用以使用 MCP 服务器：

打开 Claude Desktop 应用，转到“设置”，然后选择“开发者”。
点击“编辑配置”。
打开 claude_desktop_config.json 文件。
将服务器配置复制并粘贴到现有文件中，然后保存。
重启 Claude。

{
"mcpServers": {
"scalekit": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.scalekit.com/"]
}
}
}

Cursor

配置 Cursor 以使用 MCP 服务器：

打开 Cursor，转到“设置”，然后选择“Cursor 设置”。
在左侧选择 MCP。
点击右上角的“添加新的全局 MCP 服务器”。
将服务器配置复制并粘贴到现有文件中，然后保存。
重启 Cursor。

{
"mcpServers": {
"scalekit": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.scalekit.com/"]
}
}
}

Windsurf

配置 Windsurf 以使用 MCP 服务器：

打开 Windsurf，转到“设置”，然后选择“开发者”。
点击“编辑配置”。
打开 windsurf_config.json 文件。
将服务器配置复制并粘贴到现有文件中，然后保存。
重启 Windsurf。

{
"mcpServers": {
"scalekit": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.scalekit.com/"]
}
}
}

📚 详细文档

可用工具

环境管理

工具名称	描述	参数	权限范围
`list_environments`	列出所有可用环境	无	环境读取
`get_environment_details`	通过 ID 获取环境详细信息（例如，`env_123`）	`environmentId`	环境读取
`list_environment_roles`	列出指定环境中的所有角色	`environmentId`（格式：`env_`）	环境读取
`create_environment_role`	在指定环境中创建新角色	`environmentId`（格式：`env_`）、`roleName`、`displayName`、`description`、`isDefault`（布尔值）	环境写入
`list_environment_scopes`	列出指定环境中的所有范围	`environmentId`（格式：`env_`）	环境读取
`create_environment_scope`	在指定环境中创建新范围	`environmentId`（格式：`env_`）、`scopeName`、`description`	环境写入

工作区管理

工具名称	描述	参数	权限范围
`list_workspace_members`	列出当前工作区中的所有成员	`pageToken`（基于 1 的索引）	工作区读取
`invite_workspace_member`	邀请新成员加入当前工作区	`email`	工作区写入

组织管理

工具名称	描述	参数	权限范围
`list_organizations`	列出指定环境下的所有组织	`environmentId`（格式：`env_`）、`pageToken`	组织读取
`get_organization_details`	通过 ID 获取组织详细信息（例如，`org_123`）	`environmentId`（格式：`env_`）、`organizationId`	组织读取
`create_organization`	在指定环境下创建新组织	`environmentId`（格式：`env_`）	组织写入
`generate_admin_portal_link`	为选定的组织生成管理门户的魔法链接	`environmentId`（格式：`env_`）、`organizationId`（例如，`org_123`）	组织写入
`create_organization_user`	在选定的组织中创建新用户	`environmentId`（格式：`env_`）、`organizationId`、`email`、`externalId`、`firstName`、`lastName`、`metadata`（JSON 键值对）	组织写入
`list_organization_users`	列出选定组织中的所有用户	`environmentId`（格式：`env_`）、`organizationId`、`pageToken`	组织读取
`update_organization_settings`	更新组织的设置	`environmentId`（格式：`env_`）、`organizationId`、`feature`（功能对象的 JSON 数组）	组织写入

连接管理

工具名称	描述	参数	权限范围
`list_environment_connections`	列出指定环境的所有连接	`environmentId`（格式：`env_`）	环境读取
`list_organization_connections`	列出选定组织的所有连接	`environmentId`（格式：`env_`）、`organizationId`（例如，`org_123`）	组织读取
`create_environment_oidc_connection`	为指定环境创建新的 OIDC 连接	`environmentId`（格式：`env_`）、`provider`（OKTA、GOOGLE、MICROSOFT_AD、AUTH0、ONELOGIN、PING_IDENTITY、JUMPCLOUD、CUSTOM、GITHUB、GITLAB、LINKEDIN、SALESFORCE、MICROSOFT、IDP_SIMULATOR、SCALEKIT、ADFS）	环境写入
`update_environment_oidc_connection`	更新指定环境的现有 OIDC 连接	`environmentId`（格式：`env_`）、`connectionId`（例如，`conn_123`）、`key_id`、`provider`、`oidc_config`（全面的 OIDC 配置对象）	环境写入
`enable_environment_connection`	启用指定环境的现有连接	`environmentId`（格式：`env_`）、`connectionId`（例如，`conn_123`）	环境写入

MCP 服务器管理

工具名称	描述	参数	权限范围
`list_mcp_servers`	列出指定环境中的所有 MCP 服务器	`environmentId`（格式：`env_`）、`pageToken`	环境读取
`register_mcp_server`	在指定环境中注册新的 MCP 服务器	`environmentId`（格式：`env_`）、`name`、`description`、`url`、`access_token_expiry`（秒）、`provider`（可选，当 `use_scalekit_authentication` 为 `false` 时必需）、`use_scalekit_authentication`（布尔值）	环境写入
`update_mcp_server`	更新指定环境中的现有 MCP 服务器	`environmentId`（格式：`env_`）、`id`（MCP 服务器 ID）、`name`（可选）、`description`（可选）、`url`（可选）、`access_token_expiry`（可选，秒）、`provider`（可选）、`use_scalekit_authentication`（可选布尔值）	环境写入
`switch_mcp_auth_to_scalekit`	将现有 MCP 服务器的认证方式切换为 Scalekit 认证	`environmentId`（格式：`env_`）、`id`（MCP 服务器 ID）	环境写入

MCP 服务器认证

Scalekit MCP 服务器使用基于 OAuth 2.1 的认证方式。当你在 MCP 主机中注册 Scalekit MCP 服务器后，MCP 主机将启动 OAuth 授权流程，以便 MCP 客户端能够获取适当的令牌，从而与 Scalekit 的 MCP 服务器进行安全通信。

⚠️ 重要提示

如果你正在构建自己的 MCP 服务器并希望添加基于 OAuth 的授权，可以参考我们的 MCP 服务器认证解决方案：Auth for MCP Servers。

0 条评论
分类：开发