All Products
Search

This Product

    DataWorks:UpdateMcpServer

    Document Center

    DataWorks:UpdateMcpServer

    Last Updated:Jun 17, 2026

    Updates an MCP Server.

    Operation description

    Description

    This API updates the configuration of a specified MCP Server. Omitted fields retain their original values.

    Note: When you modify theVisibility parameter, you must provide eitherProjectIds orUserIds inVisibilityScope to apply the correct access control scope.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    Name

    string

    Yes

    The name of the MCP Server to update.

    my-mcp-server
    Url

    string

    No

    The new service address. The address must start withhttps://.

    https://example.com/mcp/sse
    Transport

    string

    No

    The new transport protocol.

    SSE
    CustomHeaders

    object

    No

    The new custom request headers, specified as key-value pairs.

    {}
    Visibility

    string

    No

    The new visibility level.

    TENANT
    VisibilityScope

    object

    No

    The new visibility scope. The fields in this object depend on the value of the Visibility parameter.

    ProjectIds

    array

    No

    The list of workspace IDs that can access the MCP Server. This parameter takes effect only when Visibility is set to PROJECT.

    string

    No

    A workspace ID.

    [3162, 45766, 61258, 68916, 73279]
    UserIds

    array

    No

    The list of user IDs that can access the MCP Server. This parameter takes effect only when Visibility is set to USER.

    string

    No

    A user ID.

    [123]

    Response elements

    Element

    Type

    Description

    Example

    object

    The response schema.

    RequestId

    string

    The request ID.

    824F80BA-1778-5D8A-BAFF-668A4D9C4CC7
    McpServer

    object

    • The details of the updated MCP Server.

    Name

    string

    The name of the MCP Server.

    my-mcp-server
    GmtCreateTime

    string

    The creation time. This value is a millisecond timestamp.

    1780555634000
    GmtModifiedTime

    string

    The last modification time. This value is a millisecond timestamp.

    1780555634000

    Examples

    Success response

    JSON format

    {
  "RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
  "McpServer": {
    "Name": "my-mcp-server",
    "GmtCreateTime": "1780555634000",
    "GmtModifiedTime": "1780555634000"
  }
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.