Register an external MCP server (admin)
Creates a server and synchronously syncs its tool catalog (all tools start disabled). url and auth_mode are immutable after creation. The oauth_client_secret is write-only. API keys are per-user (set on the account endpoint), never on the server.
Authorizations
Use Authorization: Bearer
Path Parameters
UUID of the project
Body
Fields for creating a server. The client secret is write-only.
Response
Created
A knowledge-store-level external MCP server registration. Secrets are never returned.
Immutable after creation.
oauth, api_key, none Available to internal playground chat agents (default true).
Available to CMA Task agents (default true).
Available to Work-with-Clara agents (default true).
Synced tools; each is {name, description, annotations, input_schema}.
Allowlist of tool names exposed to agents (all disabled by default).