POST /accounts/{account_id}/access/ai-controls/mcp/servers
Creates a new MCP portal for managing AI tool access through Cloudflare Access.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
id |
String | Yes |
server id |
secure_web_gateway |
Boolean | No |
Route outbound traffic to this MCP server through Zero Trust Secure Web Gateway Default value: false |
name |
String | Yes | |
updated_tools[] |
Array | No | |
updated_tools[].name |
String | Yes | |
updated_tools[].description |
String | No | |
updated_tools[].enabled |
Boolean | No | |
updated_tools[].alias |
String | No | |
description |
String | No | |
auth_type |
String | Yes |
Valid values:
|
updated_prompts[] |
Array | No | |
updated_prompts[].name |
String | Yes | |
updated_prompts[].description |
String | No | |
updated_prompts[].enabled |
Boolean | No | |
updated_prompts[].alias |
String | No | |
auth_credentials |
String | No | |
client_secret |
String | No |
Pre-registered OAuth client_secret. Write-only - accepted on create/update when auth_credentials.auth_mode is 'manual'. Stored AES-GCM-encrypted in server_oauth_secrets; never returned by read endpoints. |
hostname |
String | Yes | |
is_shared_oauth_callback_enabled |
Boolean | No |
When true, the gateway worker uses the shared Cloudflare-owned OAuth callback endpoint as the redirect_uri for upstream on-behalf OAuth, instead of the customer portal hostname. Defaults to false (off); opt in per server by setting true. Effective behavior is gated by the gateway worker's per-env rollout mode KV key. Default value: false |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.