跳到主要内容

工作空间应用

该分类包含 20 条以 system.workspace-app. 开头的 Runtime 系统命令。

1. 列出工作区应用​

完整命令：system.workspace-app.list

列出工作区应用。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system workspace-app list [--json]

参数：

  • permissionScope（可选）— Permission view: admin for integrations management or user for end-user visibility; defaults to admin
  • sidebarVariant（可选）— Optional admin/user navigation projection. Omit or null to return both navigation records

2. 获取工作区应用​

完整命令：system.workspace-app.get

获取工作区应用资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system workspace-app get --app-code value [--json]

参数：

  • appCode（必填）— Stable workspace app code discovered with workspace-app.list
  • permissionScope（可选）— Permission view; defaults to admin
  • sidebarVariant（可选）— Optional admin/user navigation projection

3. 创建工作区应用​

完整命令：system.workspace-app.create

创建工作区应用资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app create \
  (--definition-json json|--definition-file path) [--json]

参数：

  • code（必填）— Tenant-unique immutable code matching ^[a-z0-9]+(?:_[a-z0-9]+)*$, at most 64 characters
  • name（必填）— Initial display name used for both en and zh-CN, 1-80 characters
  • description（可选）— Nullable initial description used for both en and zh-CN, at most 500 characters
  • iconKey（必填）— Uploaded icon URL/key, 1-2000 characters. Upload the image first; do not invent a file URL

4. 更新工作区应用​

完整命令：system.workspace-app.update

更新工作区应用资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app update \
  --app-code value (--definition-json json|--definition-file path) \
  [--json]

参数：

  • appCode（必填）— Existing app code. The code itself is immutable
  • name（可选）— Replacement display name, 1-80 characters
  • description（可选）— Replacement description; null clears it
  • iconKey（可选）— Replacement uploaded icon URL/key

5. 启用工作区应用​

完整命令：system.workspace-app.enable

启用工作区应用资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app enable --app-code value [--json]

参数：

  • appCode（必填）— Custom app code to show in the user workspace. Idempotent when already enabled

6. 停用工作区应用​

完整命令：system.workspace-app.disable

停用工作区应用资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app disable --app-code value [--json]

参数：

  • appCode（必填）— Custom app code to hide from the user workspace. Idempotent when already disabled

7. 删除工作区应用​

完整命令：system.workspace-app.delete

删除工作区应用资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system workspace-app delete --app-code value [--json]

参数：

  • appCode（必填）— Custom app code. System applications, including approval-center, cannot be deleted

8. 列出MCP 服务​

完整命令：system.workspace-app.mcp-server.list

列出工作区应用MCP 服务。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system workspace-app mcp-server list --app-code value [--json]

参数：

  • appCode（必填）— Workspace app code. Returns MCP servers bound to this app or shared with it

9. 获取MCP 服务​

完整命令：system.workspace-app.mcp-server.get

获取工作区应用MCP 服务资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system workspace-app mcp-server get \
  --app-code value --server-id uuid [--json]

参数：

  • appCode（必填）— Workspace app code
  • serverId（必填）— MCP server UUID returned by create or list

10. 创建MCP 服务​

完整命令：system.workspace-app.mcp-server.create

创建工作区应用MCP 服务资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app mcp-server create \
  --app-code value (--mcp-json json|--mcp-file path) [--json]

参数：

  • appCode（必填）— Existing workspace app code
  • sourceType|deploymentMode（必填）— remote_url requires remote_http; command and docker_image require managed_local
  • name（必填）— Tenant-unique server name, 1-128 characters
  • description（可选）— Server description, at most 500 characters
  • endpointUrl|networkZone（可选）— For remote_url only: URL and public_https or tenant_internal network zone
  • credentialConfig（可选）— For remote_url only: authType none, bearer_token with bearerToken, or api_key_header with headerName and apiKey
  • command|image（可选）— For managed_local: executable command or container image
  • args（可选）— For managed_local: ordered string argument array, maximum 200 items
  • env（可选）— For managed_local: string environment map; never put credentials in command arguments

11. 更新MCP 服务​

完整命令：system.workspace-app.mcp-server.update

更新工作区应用MCP 服务资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app mcp-server update \
  --app-code value --server-id uuid (--mcp-json json|--mcp-file path) \
  [--json]

参数：

  • appCode（必填）— Owning workspace app code
  • serverId（必填）— MCP server UUID
  • name|description（可选）— Updated metadata
  • endpointUrl|networkZone|command|image|args|env（可选）— Update fields must match the server source type; sourceType and deploymentMode cannot be changed

12. 更新MCP 服务凭据​

完整命令：system.workspace-app.mcp-server.credentials.update

更新工作区应用MCP 服务凭据资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app mcp-server credentials update \
  --app-code value --server-id uuid \
  (--credential-json json|--credential-file path) [--json]

参数：

  • appCode（必填）— Owning workspace app code
  • serverId（必填）— MCP server UUID
  • credentialConfig（必填）— Remote HTTP credential replacement. Secrets are write-only and never returned

13. 获取MCP 服务操作​

完整命令：system.workspace-app.mcp-server.operation.get

获取工作区应用MCP 服务操作资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system workspace-app mcp-server operation get \
  --operation-id uuid [--json]

参数：

  • operationId（必填）— Async operation UUID returned by create, update, sync, credentials.update, or delete

14. 列出MCP 服务工具​

完整命令：system.workspace-app.mcp-server.tools.list

列出工作区应用MCP 服务工具。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system workspace-app mcp-server tools list \
  --app-code value --server-id uuid [--json]

参数：

  • appCode（必填）— Workspace app code
  • serverId（必填）— MCP server UUID

15. 更新MCP 服务工具​

完整命令：system.workspace-app.mcp-server.tools.update

更新工作区应用MCP 服务工具资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app mcp-server tools update \
  --app-code value --server-id uuid \
  (--tools-json json|--tools-file path) [--json]

参数：

  • appCode（必填）— Owning or bound workspace app code
  • serverId（必填）— MCP server UUID
  • items（必填）— Complete selection list: each item has toolName, enabled, and optional riskLevel

16. 同步MCP 服务​

完整命令：system.workspace-app.mcp-server.sync

同步工作区应用MCP 服务资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app mcp-server sync \
  --app-code value --server-id uuid [--json]

参数：

  • appCode（必填）— Owning workspace app code
  • serverId（必填）— MCP server UUID

17. 共享MCP 服务​

完整命令：system.workspace-app.mcp-server.share

共享工作区应用MCP 服务资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app mcp-server share \
  --app-code value --server-id uuid --share-scope private|workspace \
  [--json]

参数：

  • appCode（必填）— Owning workspace app code
  • serverId（必填）— MCP server UUID
  • shareScope（必填）— private or workspace. Private is rejected while dependent app bindings exist

18. 更新MCP 服务绑定​

完整命令：system.workspace-app.mcp-server.binding.update

更新工作区应用MCP 服务绑定资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app mcp-server binding update \
  --app-code value --server-id uuid --enabled|--disabled [--json]

参数：

  • appCode（必填）— Workspace app to bind or unbind
  • serverId（必填）— MCP server UUID
  • enabled（必填）— Enable or disable this app binding. The owner binding cannot be disabled

19. 测试MCP 服务​

完整命令：system.workspace-app.mcp-server.test

测试工作区应用MCP 服务资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system workspace-app mcp-server test \
  --app-code value --server-id uuid [--json]

参数：

  • appCode（必填）— Owning workspace app code
  • serverId（必填）— MCP server UUID

20. 删除MCP 服务​

完整命令：system.workspace-app.mcp-server.delete

删除工作区应用MCP 服务资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system workspace-app mcp-server delete \
  --app-code value --server-id uuid [--json]

参数：

  • appCode（必填）— Owning workspace app code
  • serverId（必填）— MCP server UUID. Delete is asynchronous and removes the server after binding checks