v2

latestOpenAPI 3.1.02026-08-05100545344.4 KB

mcp

Set MCP configuration

Adds or updates MCP server entries for the workspace. Existing servers not included in the payload are preserved unchanged.

For each server entry in the payload, if headers is omitted or null and a server with the same id (or mcp_url) already exists, the stored header values are preserved. To explicitly clear all headers for a server, pass headers: {}. Returns the first saved server entry with its stable ID.

post/workspaces/{workspace_id}/mcp-config

Path parameters

workspace_idstring required

Headers

Authorizationstring required

Bearer authentication

Request body

Response

MCP configuration set successfully

idstring required

Stable config ID for linking actions to this server entry

mcp_urlstring uri required

The HTTPS URL of the MCP server (SSE endpoint)

has_headersboolean required

Whether custom headers are stored in Vault

headers_keysstring[]

Names of stored header keys (values redacted)