Skip to content
Merged
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
10 changes: 5 additions & 5 deletions es/setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ cd docs
npx -y mint@latest deploy --subdomain <name>
```

`mint deploy` imprime la URL del sitio, un repositorio Git alojado, un token de escritura y los comandos de clonación y push que debes ejecutar. Ejecútalos. El sitio se elimina después de 24 horas a menos que la persona lo reclame. https://www.mintlify.com/auth.md tiene el recorrido completo.
`mint deploy` imprime la URL del sitio, un repositorio Git alojado, un token de escritura y los comandos de clonación y push que debes ejecutar. Ejecútalos y pasa el token solo como el encabezado por comando que muestra la salida. Nunca lo pongas en una URL remota, un archivo, la configuración de Git ni un mensaje a la persona. El token dura unos 10 minutos; si caduca, vuelve a ejecutar `mint deploy` desde el mismo directorio para obtener uno nuevo. El sitio se elimina después de 24 horas a menos que la persona lo reclame. [auth.md](https://www.mintlify.com/auth.md) tiene el recorrido completo.

**Luego reclama el sitio y añade un dominio personalizado.** Pide la dirección de correo electrónico que debe ser propietaria del sitio, nunca inventes una, y reclámalo:

Expand All @@ -118,7 +118,7 @@ npx -y mint@latest claim --email <email>
npx -y mint@latest claim --code <code>
```

Dales el enlace de reclamación que imprime el primer comando; ejecuta el segundo con el código que te lean. Luego pregunta en qué dominio debe estar la documentación. `add-domain` necesita una CLI con sesión iniciada, y `mint login` espera un inicio de sesión en el navegador o un código pegado, así que la persona ejecuta ambos comandos en su propia terminal:
Dales el enlace de reclamación que imprime el primer comando; ejecuta el segundo con el código que te lean. Luego pregunta en qué dominio debe estar la documentación. `add-domain` necesita una CLI con sesión iniciada. En la propia máquina de la persona, ejecuta `mint login` en segundo plano y dile que apruebe el inicio de sesión en el navegador que se abre; luego ejecuta `add-domain`. En una sesión en la nube o remota, el navegador no puede llegar a esta máquina, así que la persona ejecuta ambos comandos en su propia terminal:

```bash
npx -y mint@latest login
Expand All @@ -143,7 +143,7 @@ El OAuth de MCP necesita a una persona en el cliente: en Claude Code eso es `/mc
La VM es nueva en cada sesión y no lee nada de la máquina de la persona: ni `~/.claude.json`, ni sus plugins, ni un perfil de shell. Así que `claude mcp add --scope user` no configura nada que perdure. No lo intentes. Lo que hace que Mintlify funcione aquí lo configura la persona, una sola vez, en claude.ai; transmite una de estas dos opciones y detente:

- **El conector**, para una base o un sitio de documentación. claude.ai Settings → Connectors → Add custom connector, pega `https://mcp.mintlify.com`, aprueba el inicio de sesión y actívalo para la sesión. O dales este enlace, que abre ese cuadro de diálogo ya rellenado: [Connect to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Mintlify&connectorUrl=https%3A%2F%2Fmcp.mintlify.com). El tráfico del conector pasa por Anthropic, así que no se necesita ninguna configuración de red. Las herramientas aparecen en la siguiente sesión.
- **La CLI**, para una base nueva o un sitio de documentación público. Abre la configuración del entorno en la nube y establece **Network access** → Custom, con los hosts listados en https://www.mintlify.com/auth.md en Allowed domains, y con "Also include default list of common package managers" marcado para que `npx` siga llegando a npm. Luego, en una nueva sesión, sigue "Una base de conocimiento" o "Un sitio de documentación público" más arriba.
- **La CLI**, para una base nueva o un sitio de documentación público. Abre la configuración del entorno en la nube y establece **Network access** → Custom, con los hosts listados en [auth.md](https://www.mintlify.com/auth.md) para un sandbox con una lista de red permitida, y con "Also include default list of common package managers" marcado para que `npx` siga llegando a npm. Luego, en una nueva sesión, sigue "Una base de conocimiento" o "Un sitio de documentación público" más arriba.

Antes de dar por roto un inicio de sesión, lee los metadatos públicos de inicio de sesión de Mintlify. Un JSON que empieza con `{"issuer"` significa que la red deja pasar a Mintlify; una página de proxy o un error de conexión apuntan a la configuración de red:

Expand Down Expand Up @@ -342,7 +342,7 @@ La CLI crea y publica nuevas bases y sitios de documentación públicos sin cuen

Esta es también la forma en que **tú** publicas cuando el servidor MCP aún no está conectado o no está autorizado: funciona dentro de una sesión que ya está en curso, sin reinicio y sin `/mcp`.

**No ejecutes `mint login` tú mismo.** Abre un navegador y luego espera un código de autorización pegado, así que se queda colgado en la shell de un agente. Solo `add-domain` lo necesita; la persona ejecuta ambos en su propia terminal.
**Ejecuta `mint login` solo en la propia máquina de la persona.** Abre un navegador y espera hasta que la persona apruebe allí o pegue un código. Ejecútalo en segundo plano y dile que lo apruebe. En una sesión en la nube o remota, el inicio de sesión del navegador no puede volver a esta máquina, así que la persona lo ejecuta en su propia terminal. De los pasos de esta guía, solo `add-domain` lo necesita.

**Si el modo automático de Claude Code bloquea `npx -y mint@latest`, pregunta; no lo esquives.** No lo reintentes por tu cuenta y no lo sustituyas por otra forma de ejecutarlo. Diles en una línea qué hace ("El modo automático no me deja ejecutar por mi cuenta la CLI de Mintlify desde npm; responde _sí, ejecútala_ y publicaré el sitio") y, cuando lo hayan hecho, ejecuta el mismo comando una vez. Escribe la documentación antes de preguntar, para que lo único que espere la respuesta sea la publicación.

Expand Down Expand Up @@ -381,7 +381,7 @@ Write a one-page overview of this project in Mintlify and send me the editor lin
Turn this week's changes into release notes in Mintlify
```

`create_node` con `visibility: "private"`, `parentId: null` y `data: { type: "page", path, title, content }` escribe la página y devuelve un `editorUrl`. Envía ese enlace a la persona; abre la página en el editor de Mintlify. Los argumentos de las herramientas y el modelo de acceso están documentados en /es/ai/mintlify-mcp.
`create_node` con `visibility: "private"`, `parentId: null` y `data: { type: "page", path, title, content }` escribe la página y devuelve un `editorUrl`. Envía ese enlace a la persona; abre la página en el editor de Mintlify. Los argumentos de las herramientas y el modelo de acceso están documentados en [Servidor MCP de administración](/es/ai/mintlify-mcp).

<div id="something-here-wrong-or-broken">
## ¿Algo aquí está mal o roto?
Expand Down
10 changes: 5 additions & 5 deletions fr/setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ cd docs
npx -y mint@latest deploy --subdomain <name>
```

`mint deploy` affiche l'URL du site, un dépôt Git hébergé, un jeton d'écriture et les commandes de clonage et de push à exécuter. Exécutez-les. Le site est supprimé au bout de 24 heures si la personne ne le revendique pas. https://www.mintlify.com/auth.md contient la procédure complète.
`mint deploy` affiche l'URL du site, un dépôt Git hébergé, un jeton d'écriture et les commandes de clonage et de push à exécuter. Exécutez-les, et ne transmettez le jeton que sous forme de l'en-tête par commande indiqué dans la sortie. Ne le placez jamais dans une URL distante, un fichier, la configuration Git ou un message à la personne. Le jeton dure environ 10 minutes ; s'il expire, relancez `mint deploy` depuis le même répertoire pour en obtenir un nouveau. Le site est supprimé au bout de 24 heures si la personne ne le revendique pas. [auth.md](https://www.mintlify.com/auth.md) contient la procédure complète.

**Revendiquez ensuite le site et ajoutez un domaine personnalisé.** Demandez l'adresse e-mail qui doit être propriétaire du site, n'en inventez jamais une, et revendiquez-le :

Expand All @@ -118,7 +118,7 @@ npx -y mint@latest claim --email <email>
npx -y mint@latest claim --code <code>
```

Donnez-lui le lien de revendication affiché par la première commande ; exécutez la seconde avec le code qu'elle vous lit. Demandez ensuite sur quel domaine la documentation doit se trouver. `add-domain` nécessite une CLI connectée, et `mint login` attend une connexion dans le navigateur ou un code collé, donc la personne exécute les deux commandes dans son propre terminal :
Donnez-lui le lien de revendication affiché par la première commande ; exécutez la seconde avec le code qu'elle vous lit. Demandez ensuite sur quel domaine la documentation doit se trouver. `add-domain` nécessite une CLI connectée. Sur la propre machine de la personne, exécutez `mint login` en arrière-plan et demandez-lui d'approuver la connexion dans le navigateur qui s'ouvre ; exécutez ensuite `add-domain`. Dans une session cloud ou distante, le navigateur ne peut pas joindre cette machine, donc la personne exécute les deux commandes dans son propre terminal :

```bash
npx -y mint@latest login
Expand All @@ -143,7 +143,7 @@ L'OAuth MCP nécessite une personne devant le client : sur Claude Code, c'est `/
La VM est neuve à chaque session et ne lit rien de la machine de la personne : ni `~/.claude.json`, ni ses plugins, ni un profil de shell. Donc `claude mcp add --scope user` ne configure rien de durable. N'essayez pas. Ce qui fait fonctionner Mintlify ici est défini par la personne, une seule fois, sur claude.ai ; relayez l'une de ces deux options et arrêtez-vous :

- **Le connecteur**, pour une base ou un site de documentation. claude.ai Settings → Connectors → Add custom connector, collez `https://mcp.mintlify.com`, approuvez la connexion et activez-le pour la session. Ou donnez-lui ce lien, qui ouvre cette boîte de dialogue préremplie : [Connect to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Mintlify&connectorUrl=https%3A%2F%2Fmcp.mintlify.com). Le trafic du connecteur passe par Anthropic, donc aucun paramètre réseau n'est nécessaire. Les outils apparaissent à la session suivante.
- **La CLI**, pour une nouvelle base ou un site de documentation public. Ouvrez les paramètres de l'environnement cloud et définissez **Network access** → Custom, avec les hôtes listés dans https://www.mintlify.com/auth.md sous Allowed domains, et « Also include default list of common package managers » coché pour que `npx` atteigne toujours npm. Puis, dans une nouvelle session, suivez « Une base de connaissances » ou « Un site de documentation public » ci-dessus.
- **La CLI**, pour une nouvelle base ou un site de documentation public. Ouvrez les paramètres de l'environnement cloud et définissez **Network access** → Custom, avec les hôtes listés dans [auth.md](https://www.mintlify.com/auth.md) pour un sandbox avec une liste d'autorisation réseau, et « Also include default list of common package managers » coché pour que `npx` atteigne toujours npm. Puis, dans une nouvelle session, suivez « Une base de connaissances » ou « Un site de documentation public » ci-dessus.

Avant de déclarer une connexion défaillante, lisez les métadonnées publiques de connexion de Mintlify. Un JSON qui commence par `{"issuer"` signifie que le réseau laisse passer Mintlify ; une page de proxy ou une erreur de connexion indique un problème de paramètre réseau :

Expand Down Expand Up @@ -342,7 +342,7 @@ La CLI crée et publie de nouvelles bases et de nouveaux sites de documentation

C'est aussi ainsi que **vous** publiez lorsque le serveur MCP n'est pas encore connecté ou pas autorisé : cela fonctionne dans une session déjà en cours, sans redémarrage et sans `/mcp`.

**N'exécutez pas `mint login` vous-même.** Il ouvre un navigateur puis attend un code d'autorisation collé, donc il reste bloqué dans le shell d'un agent. Seul `add-domain` en a besoin ; la personne exécute les deux dans son propre terminal.
**N'exécutez `mint login` que sur la propre machine de la personne.** Il ouvre un navigateur et attend que la personne approuve la connexion ou colle un code. Exécutez-le en arrière-plan et demandez-lui d'approuver. Dans une session cloud ou distante, la connexion par navigateur ne peut pas revenir à cette machine, donc la personne l'exécute dans son propre terminal. Parmi les étapes de ce guide, seul `add-domain` en a besoin.

**Si le mode automatique de Claude Code bloque `npx -y mint@latest`, demandez ; ne le contournez pas.** Ne réessayez pas de vous-même et ne le remplacez pas par une autre façon de l'exécuter. Expliquez-leur en une ligne ce qu'il fait (« Le mode automatique ne me laisse pas exécuter de moi-même la CLI Mintlify depuis npm ; répondez _oui, exécute-la_ et je publierai le site ») et, une fois qu'ils l'ont fait, exécutez la même commande une seule fois. Écrivez la documentation avant de demander, pour que seule la publication attende la réponse.

Expand Down Expand Up @@ -381,7 +381,7 @@ Write a one-page overview of this project in Mintlify and send me the editor lin
Turn this week's changes into release notes in Mintlify
```

`create_node` avec `visibility: "private"`, `parentId: null` et `data: { type: "page", path, title, content }` écrit la page et renvoie une `editorUrl`. Envoyez ce lien à la personne ; il ouvre la page dans l'éditeur Mintlify. Les arguments des outils et le modèle d'accès sont documentés sur /fr/ai/mintlify-mcp.
`create_node` avec `visibility: "private"`, `parentId: null` et `data: { type: "page", path, title, content }` écrit la page et renvoie une `editorUrl`. Envoyez ce lien à la personne ; il ouvre la page dans l'éditeur Mintlify. Les arguments des outils et le modèle d'accès sont documentés dans [Serveur MCP d'administration](/fr/ai/mintlify-mcp).

<div id="something-here-wrong-or-broken">
## Quelque chose est faux ou cassé ici ?
Expand Down
10 changes: 5 additions & 5 deletions zh/setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ cd docs
npx -y mint@latest deploy --subdomain <name>
```

`mint deploy` 会打印站点 URL、一个托管的 Git 仓库、一个写入令牌,以及需要运行的克隆和推送命令。运行它们。除非对方认领,否则站点会在 24 小时后被删除。https://www.mintlify.com/auth.md 提供完整的操作说明。
`mint deploy` 会打印站点 URL、一个托管的 Git 仓库、一个写入令牌,以及需要运行的克隆和推送命令。运行它们,并且只按输出中显示的方式,将令牌作为每条命令的请求头传递。切勿把它放进远程 URL、文件、Git 配置或发给对方的消息中。令牌有效期约 10 分钟;如果过期,从同一目录再次运行 `mint deploy` 以获取新令牌。除非对方认领,否则站点会在 24 小时后被删除。[auth.md](https://www.mintlify.com/auth.md) 提供完整的操作说明。

**然后认领站点并添加自定义域名。** 询问应拥有该站点的电子邮件地址,绝不要自己编造,然后认领它:

Expand All @@ -118,7 +118,7 @@ npx -y mint@latest claim --email <email>
npx -y mint@latest claim --code <code>
```

把第一个命令打印的认领链接交给对方;用对方读给你的代码运行第二个命令。然后询问文档应部署在哪个域名上。`add-domain` 需要已登录的 CLI,而 `mint login` 会等待浏览器登录或粘贴的代码,因此由对方在自己的终端中运行这两个命令:
把第一个命令打印的认领链接交给对方;用对方读给你的代码运行第二个命令。然后询问文档应部署在哪个域名上。`add-domain` 需要已登录的 CLI。在对方自己的机器上,在后台运行 `mint login`,并告诉对方在打开的浏览器中批准登录;然后运行 `add-domain`。在云端或远程会话中,浏览器无法访问这台机器,因此由对方在自己的终端中运行这两个命令:

```bash
npx -y mint@latest login
Expand All @@ -143,7 +143,7 @@ MCP OAuth 需要有人在客户端前操作:在 Claude Code 中,这是由对
每个会话的 VM 都是全新的,不会读取对方自己机器上的任何内容:不读取 `~/.claude.json`、不读取其插件,也不读取 shell 配置文件。因此 `claude mcp add --scope user` 不会设置任何持久的内容。不要尝试。让 Mintlify 在这里工作的设置由对方在 claude.ai 上一次性完成;转达以下两种方式之一,然后停下:

- **连接器**,适用于 base 或文档站点。claude.ai Settings → Connectors → Add custom connector,粘贴 `https://mcp.mintlify.com`,批准登录,并为该会话启用它。或者把这个链接交给对方,它会打开已预填的对话框:[Connect to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Mintlify&connectorUrl=https%3A%2F%2Fmcp.mintlify.com)。连接器流量经由 Anthropic,因此无需任何网络设置。工具会在下一个会话中出现。
- **CLI**,适用于新的 base 或公开的文档站点。打开云端环境的设置,将 **Network access** 设为 Custom,填入 https://www.mintlify.com/auth.md 中 Allowed domains 下列出的主机,并勾选 "Also include default list of common package managers",以便 `npx` 仍能访问 npm。然后在新会话中按照上面的“知识库”或“公开的文档站点”操作。
- **CLI**,适用于新的 base 或公开的文档站点。打开云端环境的设置,将 **Network access** 设为 Custom,填入 [auth.md](https://www.mintlify.com/auth.md) 中针对带网络允许列表的沙盒列出的主机,并勾选 "Also include default list of common package managers",以便 `npx` 仍能访问 npm。然后在新会话中按照上面的“知识库”或“公开的文档站点”操作。

在认定登录出了问题之前,先读取 Mintlify 公开的登录元数据。以 `{"issuer"` 开头的 JSON 表示网络允许访问 Mintlify;代理页面或连接错误则说明是网络设置的问题:

Expand Down Expand Up @@ -342,7 +342,7 @@ CLI 无需账户、无需登录即可创建并发布新的 base 和公开的文

当 MCP 服务器尚未连接或尚未授权时,这也是**你**进行发布的方式:它可以在已运行的会话中工作,无需重启,也无需 `/mcp`。

**不要自己运行 `mint login`。** 它会打开浏览器,然后等待粘贴授权码,因此会在智能体的 shell 中挂起。只有 `add-domain` 需要它;由对方在自己的终端中运行这两个命令。
**只在对方自己的机器上运行 `mint login`。** 它会打开浏览器,并等待对方在浏览器中批准或粘贴回代码。在后台运行它,并告诉对方去批准。在云端或远程会话中,浏览器登录无法回到这台机器,因此由对方在自己的终端中运行它。在本指南的步骤中,只有 `add-domain` 需要它。

**如果 Claude Code 的自动模式阻止了 `npx -y mint@latest`,请询问;不要绕过它。** 不要自行重试,也不要换用其他方式运行它。用一句话告诉对方它的作用(“自动模式不允许我自行从 npm 运行 Mintlify CLI;回复 _是的,运行它_,我就会发布站点”),对方回复后,将同一条命令运行一次。在询问之前先写好文档,这样等待回复的只有发布这一步。

Expand Down Expand Up @@ -381,7 +381,7 @@ Write a one-page overview of this project in Mintlify and send me the editor lin
Turn this week's changes into release notes in Mintlify
```

使用 `visibility: "private"`、`parentId: null` 和 `data: { type: "page", path, title, content }` 调用 `create_node`,即可写入页面并返回一个 `editorUrl`。把该链接发给对方;它会在 Mintlify 编辑器中打开该页面。工具参数和访问模型记录在 /zh/ai/mintlify-mcp。
使用 `visibility: "private"`、`parentId: null` 和 `data: { type: "page", path, title, content }` 调用 `create_node`,即可写入页面并返回一个 `editorUrl`。把该链接发给对方;它会在 Mintlify 编辑器中打开该页面。工具参数和访问模型记录在 [管理员 MCP 服务器](/zh/ai/mintlify-mcp) 中。

<div id="something-here-wrong-or-broken">
## 这里有错误或问题?
Expand Down
Loading