Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 9 additions & 4 deletions ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@

### How MCP servers work

When an AI application connects to your documentation MCP server, it can search your documentation directly instead of making a generic web search in response to a user's prompt. Your MCP server provides access to all indexed content on your documentation site.

Check warning on line 17 in ai/model-context-protocol.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L17

Use 'app' instead of 'application'.

- The AI application can proactively search your documentation while generating a response, not just when explicitly asked.

Check warning on line 19 in ai/model-context-protocol.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L19

Use 'app' instead of 'application'.
- The AI application determines when to use the search tool based on the context of the conversation and the relevance of your documentation.

Check warning on line 20 in ai/model-context-protocol.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L20

Use 'app' instead of 'application'.
- Each search (tool call) happens during the generation process, so the AI application searches up-to-date information from your documentation to generate its response.

Check warning on line 21 in ai/model-context-protocol.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L21

Use 'app' instead of 'application'.

<Tip>
Some AI tools like Claude support both MCP and Skills. MCP gives the AI access to your documentation content, while Skills instruct the AI how to use that content effectively. They're complementary. MCP provides the data and Skills provide the instructions.
Expand All @@ -26,12 +26,17 @@

### Search filtering parameters

The MCP search tool supports optional filtering parameters that AI applications can use to narrow search results.
The MCP search tool supports optional filtering parameters that AI applications can use to narrow search results. The available parameters adapt dynamically based on your documentation.

- **`version`**: Filter results to a specific documentation version. For example, `'v0.7'`. Only returns content tagged with the specified version or content available across all versions.
- **`language`**: Filter results to a specific language code. For example, `'en'`, `'zh'`, or `'es'`. Only returns content in the specified language or content available across all languages.
**Always available:**
- **`apiReferenceOnly`**: Only return API reference docs.
- **`codeOnly`**: Only return code snippets.

AI applications determine when to apply these filters based on the context of the user's query. For example, if a user asks about a specific API version, the AI application may automatically apply the appropriate filter to provide more relevant results.
**Available when configured:**
- **`version`**: Filter results to a specific documentation version (e.g., `'v0.7'`). Only available when your documentation uses [versions](/organize/versions). Only returns content tagged with the specified version or content available across all versions.

Check warning on line 36 in ai/model-context-protocol.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L36

Use 'for example' instead of 'e.g.'.
- **`language`**: Filter results to a specific language code (e.g., `'en'`, `'zh'`, or `'es'`). Only available when your documentation uses [languages](/organize/languages). Only returns content in the specified language or content available across all languages.

Check warning on line 37 in ai/model-context-protocol.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

ai/model-context-protocol.mdx#L37

Use 'for example' instead of 'e.g.'.

The MCP search tool schema dynamically includes only the parameters applicable to your deployment. AI applications determine when to apply these filters based on the context of the user's query.

### MCP compared to web search

Expand Down
13 changes: 9 additions & 4 deletions es/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,17 @@ Cuando una aplicación de IA se conecta a tu servidor MCP de documentación, pue
### Parámetros de filtrado de búsqueda
</div>

La herramienta de búsqueda de Model Context Protocol (MCP) admite parámetros de filtrado opcionales que las aplicaciones de IA pueden usar para acotar los resultados de búsqueda.
La herramienta de búsqueda de Model Context Protocol (MCP) admite parámetros de filtrado opcionales que las aplicaciones de IA pueden usar para acotar los resultados de búsqueda. Los parámetros disponibles se adaptan dinámicamente según la configuración de tu documentación.

* **`version`**: Filtra los resultados a una versión específica de la documentación. Por ejemplo, `'v0.7'`. Solo devuelve contenido etiquetado con la versión especificada o contenido disponible en todas las versiones.
* **`language`**: Filtra los resultados a un código de idioma específico. Por ejemplo, `'en'`, `'zh'` o `'es'`. Solo devuelve contenido en el idioma especificado o contenido disponible en todos los idiomas.
**Siempre disponibles:**
* **`apiReferenceOnly`**: Solo devuelve documentación de referencia de API.
* **`codeOnly`**: Solo devuelve fragmentos de código.

Las aplicaciones de IA determinan cuándo aplicar estos filtros según el contexto de la búsqueda del usuario. Por ejemplo, si un usuario pregunta por una versión específica de la API, la aplicación de IA puede aplicar automáticamente el filtro adecuado para proporcionar resultados más relevantes.
**Disponibles cuando están configurados:**
* **`version`**: Filtra los resultados a una versión específica de la documentación (por ejemplo, `'v0.7'`). Solo disponible cuando tu documentación usa [versiones](/es/organize/versions). Solo devuelve contenido etiquetado con la versión especificada o contenido disponible en todas las versiones.
* **`language`**: Filtra los resultados a un código de idioma específico (por ejemplo, `'en'`, `'zh'` o `'es'`). Solo disponible cuando tu documentación usa [idiomas](/es/organize/languages). Solo devuelve contenido en el idioma especificado o contenido disponible en todos los idiomas.

El esquema de la herramienta de búsqueda de MCP incluye dinámicamente solo los parámetros aplicables a tu implementación. Las aplicaciones de IA determinan cuándo aplicar estos filtros según el contexto de la búsqueda del usuario.

<div id="mcp-compared-to-web-search">
### MCP en comparación con la búsqueda en la web
Expand Down
13 changes: 9 additions & 4 deletions fr/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,17 @@ Lorsqu&#39;une application d&#39;IA est connectée à votre serveur MCP de docum
### Paramètres de filtrage de la recherche
</div>

L&#39;outil de recherche MCP prend en charge des paramètres de filtrage optionnels que les applications d&#39;IA peuvent utiliser pour affiner les résultats de recherche.
L&#39;outil de recherche MCP prend en charge des paramètres de filtrage optionnels que les applications d&#39;IA peuvent utiliser pour affiner les résultats de recherche. Les paramètres disponibles s'adaptent dynamiquement en fonction de la configuration de votre documentation.

* **`version`** : Filtre les résultats pour une version spécifique de la documentation. Par exemple, `'v0.7'`. Ne renvoie que le contenu marqué avec la version spécifiée ou le contenu disponible pour toutes les versions.
* **`language`** : Filtre les résultats pour un code de langue spécifique. Par exemple, `'en'`, `'zh'` ou `'es'`. Ne renvoie que le contenu dans la langue spécifiée ou le contenu disponible dans toutes les langues.
**Toujours disponibles :**
* **`apiReferenceOnly`** : Ne renvoie que la documentation de référence de l'API.
* **`codeOnly`** : Ne renvoie que les extraits de code.

Les applications d&#39;IA déterminent quand appliquer ces filtres en fonction du contexte de la requête de l&#39;utilisateur. Par exemple, si un utilisateur pose une question sur une version spécifique d&#39;une API, l&#39;application d&#39;IA peut appliquer automatiquement le filtre approprié pour fournir des résultats plus pertinents.
**Disponibles lorsqu'ils sont configurés :**
* **`version`** : Filtre les résultats pour une version spécifique de la documentation (par exemple, `'v0.7'`). Disponible uniquement lorsque votre documentation utilise des [versions](/fr/organize/versions). Ne renvoie que le contenu marqué avec la version spécifiée ou le contenu disponible pour toutes les versions.
* **`language`** : Filtre les résultats pour un code de langue spécifique (par exemple, `'en'`, `'zh'` ou `'es'`). Disponible uniquement lorsque votre documentation utilise des [langues](/fr/organize/languages). Ne renvoie que le contenu dans la langue spécifiée ou le contenu disponible dans toutes les langues.

Le schéma de l'outil de recherche MCP inclut dynamiquement uniquement les paramètres applicables à votre déploiement. Les applications d&#39;IA déterminent quand appliquer ces filtres en fonction du contexte de la requête de l&#39;utilisateur.

<div id="mcp-compared-to-web-search">
### MCP par rapport à la recherche sur le web
Expand Down
13 changes: 9 additions & 4 deletions zh/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,17 @@ Model Context Protocol(MCP,模型上下文协议)是一个开放协议,
### 搜索筛选参数
</div>

MCP 搜索工具支持可选的筛选参数,AI 应用可以使用它们来缩小搜索结果范围。
MCP 搜索工具支持可选的筛选参数,AI 应用可以使用它们来缩小搜索结果范围。可用参数会根据你的文档配置动态调整。

- **`version`**:将结果筛选为特定的文档版本。例如,`'v0.7'`。只返回带有指定版本标签的内容,或在所有版本中通用的内容。
- **`language`**:将结果筛选为特定的语言代码。例如,`'en'`、`'zh'` 或 `'es'`。只返回指定语言的内容,或在所有语言中通用的内容。
**始终可用:**
- **`apiReferenceOnly`**:仅返回 API 参考文档。
- **`codeOnly`**:仅返回代码片段。

AI 应用会根据用户查询的上下文来决定何时应用这些筛选条件。例如,如果用户询问特定 API 版本,AI 应用可能会自动应用相应的筛选条件,以提供更相关的结果。
**配置后可用:**
- **`version`**:将结果筛选为特定的文档版本(例如 `'v0.7'`)。仅当你的文档使用[版本](/zh/organize/versions)时可用。只返回带有指定版本标签的内容,或在所有版本中通用的内容。
- **`language`**:将结果筛选为特定的语言代码(例如 `'en'`、`'zh'` 或 `'es'`)。仅当你的文档使用[语言](/zh/organize/languages)时可用。只返回指定语言的内容,或在所有语言中通用的内容。

MCP 搜索工具架构会动态包含仅适用于你的部署的参数。AI 应用会根据用户查询的上下文来决定何时应用这些筛选条件。

<div id="mcp-compared-to-web-search">
### MCP 与网页搜索的对比
Expand Down
Loading