You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/cloudflare-one/applications/configure-apps/mcp-servers/mcp-portals.mdx
+44-10Lines changed: 44 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,26 +40,36 @@ To add an MCP server:
40
40
6. In **HTTP URL**, enter the full URL of your MCP server. For example, if you want to add the [Cloudflare Documentation MCP server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/docs-vectorize), enter `https://docs.mcp.cloudflare.com/sse`.
41
41
7. Add [Access policies](/cloudflare-one/policies/access/) to show or hide the server in an [MCP server portal](#create-a-portal). The MCP server link will only appear in the portal for users who match an Allow policy. Users who do not pass an Allow policy will not see this server through any portals.
42
42
43
-
:::note
43
+
:::caution
44
44
Blocked users can still connect to the server (and bypass your Access policies) by using its direct URL. If you want to enforce authentication through Cloudflare Access, [configure Access as the server's OAuth provider](/cloudflare-one/applications/configure-apps/mcp-servers/saas-mcp/).
45
45
:::
46
-
8. Select **Add server**.
47
-
9. If the MCP server supports OAuth, you will be redirected to log in to your OAuth provider. You can log in to any account on the MCP server. The account used to authenticate will serve as the "admin" credential for that MCP Server. If you do not configure "user auth required" in your MCP portal, then the portal will use this admin credential to make requests.
46
+
8. Select **Save and connect server**.
47
+
9. If the MCP server supports OAuth, you will be redirected to log in to your OAuth provider. You can log in to any account on the MCP server. The account used to authenticate will serve as the admin credential for that MCP server. You can [configure an MCP portal](#create-a-portal) to use this admin credential to make requests.
48
48
49
49
Cloudflare Access will validate the server connection and fetch a list of tools and prompts. Once the server is successfully connected, the [server status](#server-status) will change to **Ready**. You can now add the MCP server to an [MCP server portal](#create-a-portal).
50
50
51
51
### Server status
52
52
53
-
The MCP server status indicates the connectivity status of the MCP server to Cloudflare Access.
53
+
The MCP server status indicates the synchronization status of the MCP server to Cloudflare Access.
54
54
55
55
| Status | Description |
56
56
| ------ | ----------- |
57
-
|Unknown | ?|
58
-
| Inactive | The latest syncronized of tools, prompts and resources failed due to expired or incorrect credentials|
59
-
| Waiting | The server's tools, prompts and resources are being syncronized|
60
-
| Ready | The server was successfully syncronized and all tools, prompts and resources are available|
57
+
|Error | The server's authentication failed or was interrupted. To fix the issue, [reauthenticate the server](#reauthenticate-the-mcp-server). |
58
+
| Inactive | The latest synchronization of tools, prompts and resources failed due to expired or incorrect credentials. To fix the issue, [reauthenticate](#reauthenticate-the-mcp-server) and [resync](#synchronize-the-mcp-server) the server.|
59
+
| Waiting | The server's tools, prompts and resources are being synchronized. |
60
+
| Ready | The server was successfully synchronized and all tools, prompts and resources are available. |
61
61
62
-
### Refresh the MCP server
62
+
### Reauthenticate the MCP server
63
+
64
+
To reauthenticate an MCP server in Cloudflare Access:
65
+
66
+
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Access** > **Applications** > **AI controls**.
67
+
2. Select the **MCP servers** tab and find the server that you want to reauthenticate.
68
+
3. Select the three dots > **Reset authentication**.
69
+
70
+
You will be redirected to log in to your OAuth provider. The account used to authenticate will serve as the new admin credential for this MCP server.
71
+
72
+
### Synchronize the MCP server
63
73
64
74
If your MCP server updates its tools and prompts, you can instruct Cloudflare Access to refresh the server profile in Zero Trust:
65
75
@@ -78,7 +88,11 @@ To create an MCP server portal:
78
88
3. Enter any name for the portal.
79
89
4. Under **Custom domain**, select a domain for the portal URL. Domains must belong to an active zone in your Cloudflare account. You can optionally specify a subdomain.
80
90
5.[Add MCP servers](#add-an-mcp-server) to the portal.
81
-
6. (Optional) Under **MCP servers**, configure the tools and prompts available through the portal. "require user auth" will prompt the user to utilize their own login credentials to establish a connection with the MCP Server, if it support OAuth authentication.
91
+
6. (Optional) Under **MCP servers**, configure the tools and prompts available through the portal.
92
+
7. (Optional) Configure **Require user auth** for servers that support OAuth:
93
+
-`Enabled`: (default) User will be prompted to utilize their own login credentials to establish a connection with the MCP server.
94
+
-`Disabled`: Users who are connected to the portal will automatically have access to the MCP server via its [admin credential](#reauthenticate-the-mcp-server).
95
+
82
96
7. Add [Access policies](/cloudflare-one/policies/access/) to define the users who can connect to the portal URL.
83
97
8. Select **Add an MCP server portal**.
84
98
9. (Optional) [Customize the login experience](#customize-login-settings) for the portal.
@@ -114,3 +128,23 @@ To test in Workers AI Playground:
114
128
6. ?? How do you log in to the individual MCP servers in the portal?
115
129
116
130
Workers AI Playground will show a **Connected** status.
131
+
132
+
## View portal logs
133
+
134
+
To view requests made through an MCP server portal:
135
+
136
+
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Access** > **Applications** > **AI controls**.
137
+
2. Find the portal that you want to view logs for, then select the three dots > **Edit**.
0 commit comments