Skip to main content
POST
Create an MCP server

Authorizations

Authorization
string
header
required

JWT tokens should be used with OIDC account (human to machine). JWT tokens used by the Qovery console to communicate with the API have a TTL. Curl Example ' curl https://console.qovery.com/organization -H "Authorization: Bearer $qovery_token" '

Path Parameters

organizationId
string<uuid>
required

Organization ID

Body

application/json
name
string
required

MCP server name, unique per scope owner within the organization

Minimum string length: 1
url
string<uri>
required

HTTPS URL of the remote MCP server

Pattern: ^https://
description
string
default:""
headers
object
write-only

HTTP headers sent to the MCP server. Header values are encrypted and never returned by the API.

scope
enum<string>

Cannot be changed after creation. On create, omitting it means ORGANIZATION, which requires the MANAGE_INFRASTRUCTURE permission; creating a USER connector requires CREATE_PROJECT. On edit, omitting it leaves the connector's scope unchanged, and stating a scope that differs from the connector's is refused with 400.

Available options:
ORGANIZATION,
USER

Response

MCP server created

id
string<uuid>
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
name
string
required
description
string
required
url
string<uri>
required

HTTPS URL of the remote MCP server

Pattern: ^https://
header_names
string[]
required

Names of the configured HTTP headers. Header values are never returned.

scope
enum<string>
required

ORGANIZATION: usable by every member who can edit an agentic workflow. USER: personal to the member who created it; only that member can attach or edit it.

Available options:
ORGANIZATION,
USER
attachable
boolean
required

Whether the member making this request may attach the connector to an agentic workflow. Computed per caller: an organization admin sees every USER connector but can attach none of them, so a picker must use this rather than scope alone.

owner_user_sub
string | null

Identity of the owning member. Null for an ORGANIZATION connector.

owner_name
string | null

Display name of the owning member. Null for an ORGANIZATION connector.