docs: clarify MCP client credentials vs Mintlify API keys

ai/model-context-protocol.mdx

@@ -14,7 +14,7 @@
 Your search MCP server exposes tools for AI applications to search and retrieve your content. Your users must connect your search MCP server to their tools.
 
 <Tip>
   Looking to let agents edit your content instead of read it? Use the [admin MCP server](/ai/mintlify-mcp) for an authenticated MCP server that exposes branching, page editing, navigation, and `docs.json` tools to trusted agents.
 </Tip>
 
 ### How MCP servers work
@@ -26,21 +26,21 @@
 - Each tool call happens during the generation process, so the AI application uses up-to-date information from your site to generate its response.
 
 <Tip>
   Some AI tools like Claude support both MCP and skills. MCP gives access to your content, while skills instruct agents how to use that content effectively. They're complementary and connecting your MCP server gives agents access to both.
 </Tip>
 
 ### MCP tools
 
 Your search MCP server provides two 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.
 
 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.
 
 ### MCP resources
 
 Your search MCP server also exposes your [skill.md files](/ai/skillmd) as MCP resources. Agents connected to your search MCP server can discover and access your skill files without installing them separately.
 
 `Skill.md` resources appear in the search MCP server's resource list and contain the capability descriptions Mintlify generates or that you define in your [custom skill files](/ai/skillmd#custom-skill-files).
 
@@ -82,7 +82,7 @@
 
 ### Discovery endpoint
 
 Mintlify hosts a discovery document at `/.well-known/mcp` for agents and tools to locate your search MCP server without prior configuration.
 
 `GET /.well-known/mcp` returns a JSON document describing your search MCP server:
 
@@ -168,7 +168,7 @@
 | `tools[].inputSchema` | JSON Schema for the tool's input parameters. |
 | `tools[].annotations` | Optional [MCP tool annotations](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#tool-annotations) that describe tool behavior. |
 
 The built-in search and query docs filesystem tools are read-only and non-destructive with the following annotations:
 
 - `readOnlyHint: true` — the tool does not modify any state.
 - `destructiveHint: false` — the tool has no destructive side effects.
@@ -210,6 +210,10 @@
 
 Client credentials authenticate against the `/authed/mcp` endpoint and return all content from public pages and authenticated pages that aren't restricted to specific groups.
 
+<Note>
+  MCP client credentials are separate from [Mintlify API keys](/api/introduction). The admin and assistant API keys authenticate requests to the Mintlify REST API and cannot authenticate to your MCP server. To call your MCP server programmatically, create a client credential on the [MCP server page](https://app.mintlify.com/products/mcp) and exchange it for an access token.
+</Note>
+
 <Steps>
   <Step title="Create a client credential">
     1. Navigate to the [MCP server page](https://app.mintlify.com/products/mcp) in your dashboard.

es/ai/model-context-protocol.mdx

@@ -234,6 +234,10 @@ Las credenciales de cliente te permiten conectarte a tu servidor MCP autenticado
 
 Las credenciales de cliente se autentican contra el endpoint `/authed/mcp` y devuelven todo el contenido de las páginas públicas y de las páginas autenticadas que no estén restringidas a grupos específicos.
 
+<Note>
+  Las credenciales de cliente de MCP son distintas de las [claves de API de Mintlify](/es/api/introduction). Las claves de API de administración y del asistente autentican solicitudes a la API REST de Mintlify y no pueden usarse para autenticarse en tu servidor MCP. Para llamar a tu servidor MCP de forma programática, crea una credencial de cliente en la [página del servidor MCP](https://dashboard.mintlify.com/products/mcp) e intercámbiala por un token de acceso siguiendo los pasos a continuación.
+</Note>
+
 <Steps>
   <Step title="Crear una credencial de cliente">
     1. Ve a la [página del servidor MCP](https://dashboard.mintlify.com/products/mcp) en tu dashboard.

fr/ai/model-context-protocol.mdx

@@ -234,6 +234,10 @@ Les identifiants client vous permettent de vous connecter à votre serveur MCP a
 
 Les identifiants client s'authentifient auprès de l'endpoint `/authed/mcp` et renvoient l'ensemble du contenu des pages publiques et des pages authentifiées qui ne sont pas restreintes à des groupes spécifiques.
 
+<Note>
+  Les identifiants client MCP sont distincts des [clés d'API Mintlify](/fr/api/introduction). Les clés d'API admin et assistant authentifient les requêtes à l'API REST de Mintlify et ne peuvent pas être utilisées pour s'authentifier auprès de votre serveur MCP. Pour appeler votre serveur MCP de manière programmatique, créez un identifiant client sur la [page du serveur MCP](https://dashboard.mintlify.com/products/mcp) et échangez-le contre un jeton d'accès en suivant les étapes ci-dessous.
+</Note>
+
 <Steps>
   <Step title="Créer un identifiant client">
     1. Accédez à la [page du serveur MCP](https://dashboard.mintlify.com/products/mcp) dans votre Dashboard.