From 6063c1c53292b04c1d413101d43d1ae1defb7e30 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?andr=C3=A9s=20gonz=C3=A1lez?= <andres.gonzalez79@gmail.com>
Date: Wed, 8 Apr 2026 17:48:05 +0200
Subject: [PATCH] :books:Clarify remote MCP availability in production (#8910)

---
 docs/mcp/index.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/mcp/index.md b/docs/mcp/index.md
index d09b7db8b7..c338faf96d 100644
--- a/docs/mcp/index.md
+++ b/docs/mcp/index.md
@@ -110,6 +110,18 @@ If you just want to try Penpot MCP quickly, follow this path for the **hosted (r
 
 ### Remote MCP in 5 steps
 
+<div class="advice">
+
+### Important: remote MCP is not in production yet
+
+Remote MCP is not available yet in Penpot production (`design.penpot.app`). It is planned for an upcoming release (currently targeted around **2.16**).
+
+Right now, the remote MCP flow is available only in **testing environments** (for example, instances deployed from the `staging` branch: https://github.com/penpot/penpot/tree/staging).
+
+If you need MCP in production today, use the **Local MCP server** setup instead. See [Local MCP server](#local-mcp-server).
+
+</div>
+
 1. #### Enable MCP in Penpot
    Go to **Your account → Integrations → MCP Server (Beta)** and enable the feature.
 
@@ -286,6 +298,16 @@ In Penpot, open a file and connect the plugin from **File → MCP Server → Con
 
 Remote MCP is the easiest way to start using AI agents with Penpot. It's hosted for you, so you don't need to install or run anything on your machine.
 
+<div class="advice">
+
+### Availability note
+
+Remote MCP is currently available only in **testing environments**. It is not yet available in Penpot production (`design.penpot.app`) and is planned for an upcoming release (currently targeted around **2.16**).
+
+If you need MCP in production today, use the **Local MCP server** setup instead. See [Local MCP server](#local-mcp-server).
+
+</div>
+
 <a id="install-and-activate-remote"></a>
 ### Install and activate