agent mcp update (Developer Preview)
Update an MCP server registered in the API Catalog.
This command is available as a developer preview. The command isn’t generally available unless or until Salesforce announces its general availability in documentation or in press releases or public statements. All commands, parameters, and other features are subject to change or deprecation at any time, with or without notice. Don’t implement functionality developed with these commands or tools.
Updates an existing MCP server in the API Catalog. Only the fields you provide are changed; omitted fields are left untouched. You can update the label, description, and server URL, and replace the authorization configuration. When setting --auth-type OAUTH, you must also provide --identity-provider, --client-id, --client-secret, and --scope. When setting --auth-type NO_AUTH, no authorization credentials are required. At least one updatable field must be supplied.
| Flag Name (Long) | Flag Name (Short) | Description |
|---|---|---|
‑‑api‑version | N/A | Type: Value Override the api version used for api requests made by this command |
‑‑auth‑type | N/A | Type: Value Valid Values: OAUTH, NO_AUTHAuthorization type to apply to the MCP server (OAUTH or NO_AUTH). |
‑‑client‑id | N/A | Type: Value OAuth client ID (required when –auth-type is OAUTH). |
‑‑client‑secret | N/A | Type: Value OAuth client secret (required when –auth-type is OAUTH). Pass ”-” to read it from stdin (piped) and keep it out of shell history. |
‑‑description | N/A | Type: Value New description for the MCP server. |
‑‑flags‑dir | N/A | Type: Value Import flag values from a directory. |
‑‑identity‑provider | N/A | Type: Value Identity provider name for OAuth authorization (required when –auth-type is OAUTH). |
‑‑json | N/A | Type: Boolean Format output as json. |
‑‑label | N/A | Type: Value New display label for the MCP server. |
‑‑mcp‑server‑id | ‑i | Type: Value Required ID of the MCP server to update. |
‑‑scope | N/A | Type: Value OAuth scope (required when –auth-type is OAUTH). |
‑‑server‑url | N/A | Type: Value New endpoint URL of the MCP server. |
‑‑target‑org | ‑o | Type: Value Required Username or alias of the target org. Not required if the target-org configuration variable is already set. |
Update the label and description of an MCP server in the default target org:
Update the server URL and switch the authorization to OAuth, piping the client secret from stdin and outputting as JSON: