Disables a custom MCP service while retaining the service definition and saved configuration.
Endpoint
POST /api/v1/mcp/servers/{mcpCode}/disable
Supports custom MCP only. Disabling closes the service instance but retains the service definition and saved configuration. You can re-enable it with Enable a custom MCP.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| mcpCode | string | Yes | Custom MCP code |
Response
Returns a DetailResponse with only mcp_code, server_status, and server_status_text populated. All other fields are null.
Errors
| HTTP status | error_code | Description |
|---|---|---|
| 400 | InvalidParameter | A query parameter or request body is provided |
| 400 | OperationNotSupported | The service is an official MCP |
| 400 | DisableFailed | The disable operation failed, for example because the service is deploying |
| 404 | McpServerNotFound | The MCP service does not exist |
| 409 | McpServerBusy | Another operation is running on the MCP service |