From cb9eaf239b632e885999e8ea25ef7cb11e653797 Mon Sep 17 00:00:00 2001
From: Dustin Healy <54083382+dustinhealy@users.noreply.github.com>
Date: Mon, 7 Jul 2025 09:57:33 -0700
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9A=20docs:=20Add=20MCP=20Servers=20co?=
 =?UTF-8?q?nfiguration=20to=20interface=20documentation=20(#337)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 📚 docs: Add MCP Servers configuration to interface documentation

- Introduced `mcpServers` field in the interface configuration with a placeholder for the MCP server selection dropdown.
- Updated example configurations and added detailed descriptions for the `mcpServers` key and its sub-key `placeholder` in the documentation.

* 📚 docs: Add docs update summary to config_v1.2.8 changelog

---------

Co-authored-by: Danny Avila <danny@librechat.ai>
---
 .../changelog/content/config_v1.2.8.mdx       |  6 +++++-
 .../configuration/librechat_yaml/example.mdx  |  8 ++++++++
 .../object_structure/interface.mdx            | 19 +++++++++++++++++++
 3 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/components/changelog/content/config_v1.2.8.mdx b/components/changelog/content/config_v1.2.8.mdx
index a6468f3..9095ff2 100644
--- a/components/changelog/content/config_v1.2.8.mdx
+++ b/components/changelog/content/config_v1.2.8.mdx
@@ -16,6 +16,10 @@
   - Configurable through UI via settings icon in tool selection or MCP Settings panel
   - Ensures authentication details remain private in multi-user environments
   - See: [MCP Servers Object Structure - customUserVars](/docs/configuration/librechat_yaml/object_structure/mcp_servers#customuservars)
+- Added `mcpServers` to the `interface` configuration in `librechat.yaml`:
+  - Centralizes UI-related settings for Model Context Protocol (MCP) servers.
+  - This includes the `placeholder` option, which customizes the text shown in the server selection dropdown when no MCP is selected.
+  - See: [Interface Object Structure - mcpServers](/docs/configuration/librechat_yaml/object_structure/interface#mcp-servers)
 - Added user placeholder variables support to Custom Endpoint Headers:
   - Users can now use `{{LIBRECHAT_USER_ID}}`, `{{LIBRECHAT_USER_EMAIL}}`, and other user field placeholders in custom endpoint headers
-  - See: [Custom Endpoint Object Structure - Headers](/docs/configuration/librechat_yaml/object_structure/custom_endpoint#headers) for details
\ No newline at end of file
+  - See: [Custom Endpoint Object Structure - Headers](/docs/configuration/librechat_yaml/object_structure/custom_endpoint#headers) for details
diff --git a/pages/docs/configuration/librechat_yaml/example.mdx b/pages/docs/configuration/librechat_yaml/example.mdx
index 6e21d77..be5d71e 100644
--- a/pages/docs/configuration/librechat_yaml/example.mdx
+++ b/pages/docs/configuration/librechat_yaml/example.mdx
@@ -12,6 +12,10 @@ version: 1.2.8
 cache: true
 
 interface:
+  # MCP Servers UI configuration
+  mcpServers:
+    placeholder: 'MCP Servers'
+    
   # Privacy policy settings
   privacyPolicy:
     externalUrl: 'https://librechat.ai/privacy-policy'
@@ -279,6 +283,10 @@ cache: true
 
 # Custom interface configuration
 interface:
+  # MCP Servers UI configuration
+  mcpServers:
+    placeholder: 'MCP Servers'
+
   # Privacy policy settings
   privacyPolicy:
     externalUrl: 'https://librechat.ai/privacy-policy'
diff --git a/pages/docs/configuration/librechat_yaml/object_structure/interface.mdx b/pages/docs/configuration/librechat_yaml/object_structure/interface.mdx
index b13a4e0..b1ece79 100644
--- a/pages/docs/configuration/librechat_yaml/object_structure/interface.mdx
+++ b/pages/docs/configuration/librechat_yaml/object_structure/interface.mdx
@@ -6,6 +6,7 @@ The `interface` object allows for customization of various user interface elemen
 
 These are fields under `interface`:
 
+  - `mcpServers`
   - `privacyPolicy`
   - `termsOfService`
   - `modelSelect`
@@ -30,6 +31,8 @@ These are fields under `interface`:
 
 ```yaml filename="interface"
 interface:
+  mcpServers:
+    placeholder: "MCP Servers"
   privacyPolicy:
     externalUrl: "https://example.com/privacy"
     openNewTab: true
@@ -55,6 +58,22 @@ interface:
   webSearch: true
 ```
 
+## mcpServers
+
+**Key:**
+<OptionTable
+  options={[
+    ['mcpServers', 'Object', 'Contains settings related to the MCP (Model Context Protocol) server selection interface.', 'Allows for customization of the placeholder text shown in the MCP server selection dropdown.'],
+  ]}
+/>
+
+**Sub-keys:**
+<OptionTable
+  options={[
+    ['placeholder', 'String', 'The placeholder text displayed in the MCP server selection dropdown when no server is selected.', 'MCP Servers'],
+  ]}
+/>
+
 ## privacyPolicy
 
 **Key:**