From b0aaa58b6aa920d8ca5415cf479ca3909477a335 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Fri, 24 Jul 2026 15:27:10 -0700
Subject: [PATCH 1/2] docs: clarify agent feedback MCP workflow
---
changelog.mdx | 2 +-
es/changelog.mdx | 2 +-
es/optimize/feedback.mdx | 21 +++------------------
fr/changelog.mdx | 2 +-
fr/optimize/feedback.mdx | 21 +++------------------
optimize/feedback.mdx | 21 +++------------------
zh/changelog.mdx | 2 +-
zh/optimize/feedback.mdx | 21 +++------------------
8 files changed, 16 insertions(+), 76 deletions(-)
diff --git a/changelog.mdx b/changelog.mdx
index ec0fb1917..fcfae7fe8 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -619,7 +619,7 @@ noindex: true
## Agent feedback
- Enable [agent feedback](/optimize/feedback#agent-feedback) in your deployment settings to let agents submit structured feedback about your documentation. When turned on, Markdown versions of your pages include feedback instructions so agents know how to report any issues they encounter accessing your documentation. Available as a beta feature in the dashboard under deployment add-ons.
+ Enable [agent feedback](/optimize/feedback#agent-feedback) in your deployment settings to let agents submit structured feedback about your documentation. When turned on, your search MCP server provides a `submit_feedback` tool that connected agents can use to report documentation issues. Available as a beta feature in the dashboard under deployment add-ons.
## MCP filesystem access
diff --git a/es/changelog.mdx b/es/changelog.mdx
index af8e0744e..4bfb69245 100644
--- a/es/changelog.mdx
+++ b/es/changelog.mdx
@@ -758,7 +758,7 @@ noindex: true
## Feedback de agentes
- Activa el [feedback de agentes](/es/optimize/feedback#agent-feedback) en la configuración de tu despliegue para permitir que los agentes envíen feedback estructurado sobre tu documentación. Cuando está activado, las versiones Markdown de tus páginas incluyen instrucciones de feedback para que los agentes sepan cómo reportar cualquier problema que encuentren al acceder a tu documentación. Disponible como función beta en el dashboard en complementos de despliegue.
+ Activa el [feedback de agentes](/es/optimize/feedback#agent-feedback) en la configuración de tu despliegue para permitir que los agentes envíen feedback estructurado sobre tu documentación. Cuando está activado, tu servidor Search MCP proporciona una herramienta `submit_feedback` que los agentes conectados pueden usar para reportar problemas en la documentación. Disponible como función beta en el dashboard en complementos de despliegue.
## Acceso al sistema de archivos MCP
diff --git a/es/optimize/feedback.mdx b/es/optimize/feedback.mdx
index 70e6d3e26..6248b3f78 100644
--- a/es/optimize/feedback.mdx
+++ b/es/optimize/feedback.mdx
@@ -122,28 +122,13 @@ Estos comentarios aparecen en la sección **Detailed feedback** identificados co
### Cómo funcionan los comentarios de agentes
-Los agentes pueden enviar comentarios de dos maneras:
-
-- **Servidor Search MCP**: Un agente conectado al [servidor Search MCP](/es/ai/model-context-protocol) de tu sitio puede descubrir y llamar a la herramienta `submit_feedback`. La herramienta requiere la ruta de la página y una descripción del problema.
-- **Endpoint HTTP**: Un agente con capacidad para realizar solicitudes `POST` puede enviar la ruta de la página y el texto del comentario directamente a `https://your-domain.com/feedback`. Este método no requiere una conexión MCP.
-
-Por ejemplo:
-
-```bash
-curl --request POST \
- --url https://your-domain.com/feedback \
- --header 'Content-Type: application/json' \
- --data '{
- "path": "/quickstart",
- "feedback": "El comando de instalación de esta página está desactualizado."
- }'
-```
+Conecta un agente al [servidor Search MCP](/es/ai/model-context-protocol) de tu sitio. El servidor proporciona una herramienta `submit_feedback` que requiere la ruta de la página y una descripción del problema.
- Las herramientas de búsqueda y obtención web no proporcionan al agente la herramienta MCP `submit_feedback`. Un agente que solo admite solicitudes `GET` no puede enviar comentarios. Necesita una conexión a tu servidor Search MCP o la capacidad de realizar una solicitud HTTP `POST`.
+ Las herramientas de búsqueda y obtención web no conectan a un agente con el servidor Search MCP. El agente debe estar conectado al servidor para descubrir y llamar a la herramienta `submit_feedback`.
-Ambos métodos registran el envío como un comentario no útil para la página especificada. Los comentarios aparecen en el panel junto con los comentarios humanos.
+Cada envío se registra como un comentario no útil para la página especificada. Los comentarios aparecen en el panel junto con los comentarios humanos.
### Recuperar los comentarios de agentes vía API
diff --git a/fr/changelog.mdx b/fr/changelog.mdx
index 45c8a92f9..eab7a1888 100644
--- a/fr/changelog.mdx
+++ b/fr/changelog.mdx
@@ -758,7 +758,7 @@ noindex: true
## Feedback des agents
- Activez le [feedback des agents](/fr/optimize/feedback#agent-feedback) dans les paramètres de votre déploiement pour permettre aux agents de soumettre des retours structurés sur votre documentation. Lorsqu'il est activé, les versions Markdown de vos pages incluent des instructions de feedback pour que les agents sachent comment signaler les problèmes qu'ils rencontrent en accédant à votre documentation. Disponible en tant que fonctionnalité bêta dans le tableau de bord sous les modules complémentaires de déploiement.
+ Activez le [feedback des agents](/fr/optimize/feedback#agent-feedback) dans les paramètres de votre déploiement pour permettre aux agents de soumettre des retours structurés sur votre documentation. Lorsqu'il est activé, votre serveur Search MCP fournit un outil `submit_feedback` que les agents connectés peuvent utiliser pour signaler les problèmes de documentation. Disponible en tant que fonctionnalité bêta dans le tableau de bord sous les modules complémentaires de déploiement.
## Accès au système de fichiers MCP
diff --git a/fr/optimize/feedback.mdx b/fr/optimize/feedback.mdx
index 9ceb3acde..19ca9fb14 100644
--- a/fr/optimize/feedback.mdx
+++ b/fr/optimize/feedback.mdx
@@ -122,28 +122,13 @@ Ces retours apparaissent dans la section **Detailed feedback**, identifiés par
### Fonctionnement des retours des agents
-Les agents peuvent soumettre des retours de deux façons :
-
-- **Serveur Search MCP** : un agent connecté au [serveur Search MCP](/fr/ai/model-context-protocol) de votre site peut découvrir et appeler l'outil `submit_feedback`. L'outil requiert le chemin de la page et une description du problème.
-- **Point de terminaison HTTP** : un agent capable d'effectuer des requêtes `POST` peut envoyer le chemin de la page et le texte du retour directement à `https://your-domain.com/feedback`. Cette méthode ne nécessite pas de connexion MCP.
-
-Par exemple :
-
-```bash
-curl --request POST \
- --url https://your-domain.com/feedback \
- --header 'Content-Type: application/json' \
- --data '{
- "path": "/quickstart",
- "feedback": "La commande d’installation de cette page est obsolète."
- }'
-```
+Connectez un agent au [serveur Search MCP](/fr/ai/model-context-protocol) de votre site. Le serveur fournit un outil `submit_feedback` qui requiert le chemin de la page et une description du problème.
- Les outils de recherche et de récupération web ne donnent pas accès à l'outil MCP `submit_feedback`. Un agent qui prend uniquement en charge les requêtes `GET` ne peut pas soumettre de retour. Il doit être connecté à votre serveur Search MCP ou pouvoir effectuer une requête HTTP `POST`.
+ Les outils de recherche et de récupération web ne connectent pas un agent au serveur Search MCP. L'agent doit être connecté au serveur pour découvrir et appeler l'outil `submit_feedback`.
-Les deux méthodes enregistrent la soumission comme un retour négatif pour la page spécifiée. Le retour apparaît dans le tableau de bord aux côtés des retours humains.
+Chaque envoi est enregistré comme un retour négatif pour la page spécifiée. Le retour apparaît dans le tableau de bord aux côtés des retours humains.
### Récupérer les retours des agents via l'API
diff --git a/optimize/feedback.mdx b/optimize/feedback.mdx
index 19085d36a..006cf5cb5 100644
--- a/optimize/feedback.mdx
+++ b/optimize/feedback.mdx
@@ -107,28 +107,13 @@ This feedback appears in the **Detailed feedback** section identified by an **Ag
### How agent feedback works
-Agents can submit feedback in two ways:
-
-- **Search MCP server**: An agent connected to your site's [search MCP server](/ai/model-context-protocol) can discover and call the `submit_feedback` tool. The tool requires the page path and a description of the problem.
-- **HTTP endpoint**: An agent with the ability to make `POST` requests can submit the page path and feedback text directly to `https://your-domain.com/feedback`. This method does not require an MCP connection.
-
-For example:
-
-```bash
-curl --request POST \
- --url https://your-domain.com/feedback \
- --header 'Content-Type: application/json' \
- --data '{
- "path": "/quickstart",
- "feedback": "The installation command on this page is outdated."
- }'
-```
+Connect an agent to your site's [search MCP server](/ai/model-context-protocol). The server exposes a `submit_feedback` tool that requires the page path and a description of the problem.
- Web search and web fetch tools do not give an agent the `submit_feedback` MCP tool. An agent that only supports `GET` requests cannot submit feedback. It needs either a connection to your search MCP server or the ability to make an HTTP `POST` request.
+ Web search and web fetch tools do not connect an agent to the search MCP server. Connect the agent to the server so it can discover and call the `submit_feedback` tool.
-Both methods record the submission as unhelpful feedback for the specified page. The feedback appears in the dashboard alongside human feedback.
+Mintlify records each submission as unhelpful feedback for the specified page. The feedback appears in the dashboard alongside human feedback.
### Retrieve agent feedback via API
diff --git a/zh/changelog.mdx b/zh/changelog.mdx
index ad4bf71f9..a3835d90e 100644
--- a/zh/changelog.mdx
+++ b/zh/changelog.mdx
@@ -688,7 +688,7 @@ noindex: true
## Agent 反馈
- 在部署设置中启用 [agent 反馈](/zh/optimize/feedback#agent-feedback)，允许 agent 提交关于你文档的结构化反馈。启用后，页面的 Markdown 版本会包含反馈说明，以便 agent 知道如何报告他们在访问你的文档时遇到的任何问题。该功能作为 beta 功能在仪表板的部署附加组件中提供。
+ 在部署设置中启用 [agent 反馈](/zh/optimize/feedback#agent-feedback)，允许 agent 提交关于你文档的结构化反馈。启用后，Search MCP 服务器会提供 `submit_feedback` 工具，已连接的 agent 可以使用该工具报告文档问题。该功能作为 beta 功能在仪表板的部署附加组件中提供。
## MCP 文件系统访问
diff --git a/zh/optimize/feedback.mdx b/zh/optimize/feedback.mdx
index 28dfeb51a..788068550 100644
--- a/zh/optimize/feedback.mdx
+++ b/zh/optimize/feedback.mdx
@@ -122,28 +122,13 @@ boost: 3
### 智能体反馈的工作原理
-智能体可以通过两种方式提交反馈:
-
-- **Search MCP 服务器**:连接到您站点的 [Search MCP 服务器](/zh/ai/model-context-protocol)后,智能体可以发现并调用 `submit_feedback` 工具。该工具需要页面路径和问题描述。
-- **HTTP 端点**:能够发出 `POST` 请求的智能体可以将页面路径和反馈文本直接提交到 `https://your-domain.com/feedback`。这种方式不需要 MCP 连接。
-
-例如:
-
-```bash
-curl --request POST \
- --url https://your-domain.com/feedback \
- --header 'Content-Type: application/json' \
- --data '{
- "path": "/quickstart",
- "feedback": "此页面上的安装命令已过时。"
- }'
-```
+将智能体连接到您站点的 [Search MCP 服务器](/zh/ai/model-context-protocol)。该服务器提供 `submit_feedback` 工具,该工具需要页面路径和问题描述。
- 网页搜索和网页获取工具不会为智能体提供 `submit_feedback` MCP 工具。仅支持 `GET` 请求的智能体无法提交反馈。它需要连接到您的 Search MCP 服务器,或具备发出 HTTP `POST` 请求的能力。
+ 网页搜索和网页获取工具不会将智能体连接到 Search MCP 服务器。智能体必须连接到该服务器,才能发现并调用 `submit_feedback` 工具。
-两种方式都会将提交记录为指定页面的负面反馈。反馈将与人类反馈一起显示在仪表板中。
+每次提交都会记录为指定页面的负面反馈。反馈将与人类反馈一起显示在仪表板中。
### 通过 API 获取智能体反馈
From 1052730eea76fdd9cf0ea535a286416b646f051c Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Fri, 24 Jul 2026 15:39:39 -0700
Subject: [PATCH 2/2] undo changelog changes
---
changelog.mdx | 2 +-
es/changelog.mdx | 2 +-
fr/changelog.mdx | 2 +-
zh/changelog.mdx | 2 +-
4 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/changelog.mdx b/changelog.mdx
index fcfae7fe8..ec0fb1917 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -619,7 +619,7 @@ noindex: true
## Agent feedback
- Enable [agent feedback](/optimize/feedback#agent-feedback) in your deployment settings to let agents submit structured feedback about your documentation. When turned on, your search MCP server provides a `submit_feedback` tool that connected agents can use to report documentation issues. Available as a beta feature in the dashboard under deployment add-ons.
+ Enable [agent feedback](/optimize/feedback#agent-feedback) in your deployment settings to let agents submit structured feedback about your documentation. When turned on, Markdown versions of your pages include feedback instructions so agents know how to report any issues they encounter accessing your documentation. Available as a beta feature in the dashboard under deployment add-ons.
## MCP filesystem access
diff --git a/es/changelog.mdx b/es/changelog.mdx
index 4bfb69245..af8e0744e 100644
--- a/es/changelog.mdx
+++ b/es/changelog.mdx
@@ -758,7 +758,7 @@ noindex: true
## Feedback de agentes
- Activa el [feedback de agentes](/es/optimize/feedback#agent-feedback) en la configuración de tu despliegue para permitir que los agentes envíen feedback estructurado sobre tu documentación. Cuando está activado, tu servidor Search MCP proporciona una herramienta `submit_feedback` que los agentes conectados pueden usar para reportar problemas en la documentación. Disponible como función beta en el dashboard en complementos de despliegue.
+ Activa el [feedback de agentes](/es/optimize/feedback#agent-feedback) en la configuración de tu despliegue para permitir que los agentes envíen feedback estructurado sobre tu documentación. Cuando está activado, las versiones Markdown de tus páginas incluyen instrucciones de feedback para que los agentes sepan cómo reportar cualquier problema que encuentren al acceder a tu documentación. Disponible como función beta en el dashboard en complementos de despliegue.
## Acceso al sistema de archivos MCP
diff --git a/fr/changelog.mdx b/fr/changelog.mdx
index eab7a1888..45c8a92f9 100644
--- a/fr/changelog.mdx
+++ b/fr/changelog.mdx
@@ -758,7 +758,7 @@ noindex: true
## Feedback des agents
- Activez le [feedback des agents](/fr/optimize/feedback#agent-feedback) dans les paramètres de votre déploiement pour permettre aux agents de soumettre des retours structurés sur votre documentation. Lorsqu'il est activé, votre serveur Search MCP fournit un outil `submit_feedback` que les agents connectés peuvent utiliser pour signaler les problèmes de documentation. Disponible en tant que fonctionnalité bêta dans le tableau de bord sous les modules complémentaires de déploiement.
+ Activez le [feedback des agents](/fr/optimize/feedback#agent-feedback) dans les paramètres de votre déploiement pour permettre aux agents de soumettre des retours structurés sur votre documentation. Lorsqu'il est activé, les versions Markdown de vos pages incluent des instructions de feedback pour que les agents sachent comment signaler les problèmes qu'ils rencontrent en accédant à votre documentation. Disponible en tant que fonctionnalité bêta dans le tableau de bord sous les modules complémentaires de déploiement.
## Accès au système de fichiers MCP
diff --git a/zh/changelog.mdx b/zh/changelog.mdx
index a3835d90e..ad4bf71f9 100644
--- a/zh/changelog.mdx
+++ b/zh/changelog.mdx
@@ -688,7 +688,7 @@ noindex: true
## Agent 反馈
- 在部署设置中启用 [agent 反馈](/zh/optimize/feedback#agent-feedback)，允许 agent 提交关于你文档的结构化反馈。启用后，Search MCP 服务器会提供 `submit_feedback` 工具，已连接的 agent 可以使用该工具报告文档问题。该功能作为 beta 功能在仪表板的部署附加组件中提供。
+ 在部署设置中启用 [agent 反馈](/zh/optimize/feedback#agent-feedback)，允许 agent 提交关于你文档的结构化反馈。启用后，页面的 Markdown 版本会包含反馈说明，以便 agent 知道如何报告他们在访问你的文档时遇到的任何问题。该功能作为 beta 功能在仪表板的部署附加组件中提供。
## MCP 文件系统访问