From 6522daa856aac87c757e0eeb8536bf4eafda3ea4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 30 Jun 2026 00:35:48 +0000 Subject: [PATCH] docs: document submit feedback tool on search MCP server --- ai/model-context-protocol.mdx | 5 +++-- es/ai/model-context-protocol.mdx | 5 +++-- fr/ai/model-context-protocol.mdx | 5 +++-- zh/ai/model-context-protocol.mdx | 5 +++-- 4 files changed, 12 insertions(+), 8 deletions(-) diff --git a/ai/model-context-protocol.mdx b/ai/model-context-protocol.mdx index ba91c0f07..5b72ca987 100644 --- a/ai/model-context-protocol.mdx +++ b/ai/model-context-protocol.mdx @@ -31,12 +31,13 @@ When an AI application connects to your search MCP server, it can search your co ### MCP tools -Your search MCP server provides two tools that agents can use: +Your search MCP server provides three tools that agents can use: - **Search**: Searches across your site to find relevant content, returning snippets with titles and links. Use this to discover information or find pages matching a query. - **Query docs filesystem**: Reads and navigates your site's virtual filesystem using shell-style commands. Use this to browse and retrieve content, or extract specific sections—including batch reads across multiple pages in a single call. +- **Submit feedback**: Reports a documentation issue back to your team when an agent finds a page that is incorrect, outdated, confusing, or incomplete. The agent supplies the page path and a description of the problem, which is recorded as unhelpful feedback against that page so your team can fix it. This is the only tool that writes data; the rest of the server is read-only. -Agents determine when to use each tool based on the context of the conversation. For example, an agent might first search your site to find relevant pages, then use the query docs filesystem tool to read the full content of the most relevant results. +Agents determine when to use each tool based on the context of the conversation. For example, an agent might first search your site to find relevant pages, then use the query docs filesystem tool to read the full content of the most relevant results, and call submit feedback if it discovers a problem with the page along the way. ### MCP resources diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx index e5b439ed9..2a24af8e0 100644 --- a/es/ai/model-context-protocol.mdx +++ b/es/ai/model-context-protocol.mdx @@ -37,12 +37,13 @@ Cuando una aplicación de IA se conecta a tu servidor Search MCP, puede buscar e ### Herramientas MCP -Tu servidor Search MCP proporciona dos herramientas que los agentes pueden usar: +Tu servidor Search MCP proporciona tres herramientas que los agentes pueden usar: - **Search**: Busca en tu sitio para encontrar contenido relevante, devolviendo fragmentos con títulos y enlaces. Úsala para descubrir información o encontrar páginas que coincidan con una consulta. - **Query docs filesystem**: Lee y navega el sistema de archivos virtual de tu sitio usando comandos de estilo shell. Úsala para explorar y recuperar contenido, o extraer secciones específicas, incluyendo lecturas de múltiples páginas en una sola llamada. +- **Submit feedback**: Reporta a tu equipo un problema en la documentación cuando un agente encuentra una página incorrecta, desactualizada, confusa o incompleta. El agente proporciona la ruta de la página y una descripción del problema, que se registra como comentario no útil sobre esa página para que tu equipo pueda corregirla. Esta es la única herramienta que escribe datos; el resto del servidor es de solo lectura. -Los agentes determinan cuándo usar cada herramienta según el contexto de la conversación. Por ejemplo, un agente podría primero buscar en tu sitio para encontrar páginas relevantes y luego usar la herramienta query docs filesystem para leer el contenido completo de los resultados más relevantes. +Los agentes determinan cuándo usar cada herramienta según el contexto de la conversación. Por ejemplo, un agente podría primero buscar en tu sitio para encontrar páginas relevantes, luego usar la herramienta query docs filesystem para leer el contenido completo de los resultados más relevantes y llamar a submit feedback si detecta un problema con la página durante el proceso.
### Recursos MCP diff --git a/fr/ai/model-context-protocol.mdx b/fr/ai/model-context-protocol.mdx index 448d9a54c..42f37dd64 100644 --- a/fr/ai/model-context-protocol.mdx +++ b/fr/ai/model-context-protocol.mdx @@ -37,12 +37,13 @@ Lorsqu'une application d'IA se connecte à votre serveur Search MCP, elle peut r ### Outils MCP
-Votre serveur Search MCP fournit deux outils que les agents peuvent utiliser : +Votre serveur Search MCP fournit trois outils que les agents peuvent utiliser : - **Search** : Recherche sur votre site pour trouver du contenu pertinent, en renvoyant des extraits avec des titres et des liens. Utilisez cet outil pour découvrir des informations ou trouver des pages correspondant à une requête. - **Query docs filesystem** : Lit et parcourt le système de fichiers virtuel de votre site à l'aide de commandes de type shell. Utilisez cet outil pour parcourir et récupérer du contenu, ou extraire des sections spécifiques—y compris des lectures par lots sur plusieurs pages en un seul appel. +- **Submit feedback** : Signale un problème de documentation à votre équipe lorsqu'un agent trouve une page incorrecte, obsolète, confuse ou incomplète. L'agent fournit le chemin de la page et une description du problème, qui est enregistrée comme retour négatif sur cette page afin que votre équipe puisse la corriger. C'est le seul outil qui écrit des données ; le reste du serveur est en lecture seule. -Les agents déterminent quand utiliser chaque outil en fonction du contexte de la conversation. Par exemple, un agent peut d'abord rechercher sur votre site pour trouver des pages pertinentes, puis utiliser l'outil query docs filesystem pour lire le contenu complet des résultats les plus pertinents. +Les agents déterminent quand utiliser chaque outil en fonction du contexte de la conversation. Par exemple, un agent peut d'abord rechercher sur votre site pour trouver des pages pertinentes, puis utiliser l'outil query docs filesystem pour lire le contenu complet des résultats les plus pertinents, et appeler submit feedback s'il découvre un problème avec la page en cours de route.
### Ressources MCP diff --git a/zh/ai/model-context-protocol.mdx b/zh/ai/model-context-protocol.mdx index 353cf0bdf..172a359cc 100644 --- a/zh/ai/model-context-protocol.mdx +++ b/zh/ai/model-context-protocol.mdx @@ -36,12 +36,13 @@ Model Context Protocol (MCP，模型上下文协议) 是一个开放协议，用 ### MCP 工具
-你的 MCP 服务器提供两个代理可以使用的工具： +你的 MCP 服务器提供三个代理可以使用的工具： - **Search**：在你的文档中搜索相关内容，返回带有标题和链接的摘要片段。使用此工具来发现信息或查找与查询匹配的页面。 - **Query docs filesystem**：使用 shell 风格的命令读取和浏览文档的虚拟文件系统。使用此工具来获取页面内容、浏览文档结构或提取特定部分——包括在单次调用中批量读取多个页面。 +- **Submit feedback**：当代理发现某个页面不正确、过时、令人困惑或不完整时，将文档问题反馈给你的团队。代理会提供页面路径和问题描述，并将其记录为针对该页面的负面反馈，方便你的团队进行修复。这是唯一会写入数据的工具；服务器的其他部分均为只读。 -代理会根据对话的上下文来决定何时使用每个工具。例如，代理可能会先搜索你的文档以查找相关页面，然后使用 query docs filesystem 工具读取最相关结果的完整内容。 +代理会根据对话的上下文来决定何时使用每个工具。例如，代理可能会先搜索你的文档以查找相关页面，然后使用 query docs filesystem 工具读取最相关结果的完整内容，并在过程中发现页面存在问题时调用 submit feedback。
### MCP 资源