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
28 changes: 25 additions & 3 deletions es/ai/mintlify-mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,17 @@ Si tu proyecto tiene la [publicación automática](/es/editor/settings#auto-publ

Mintlify rechaza `create_branch` y las llamadas sobre cualquier otra rama en estos proyectos, y no cambia nada. Si tu conexión solo abarca ese proyecto, el Admin MCP no muestra `create_branch` ni `list_branches`.

**Enviar directamente a tu rama de despliegue** y la protección de ramas no bloquean las ediciones en la rama de despliegue en un proyecto con publicación automática. Mintlify sigue rechazando las ediciones cuando la edición de la rama de despliegue está bloqueada en el editor del panel, o cuando te conectaste con un token de cliente o de máquina a máquina.
**Enviar directamente a tu rama de despliegue** y la protección de ramas no bloquean las ediciones en la rama de despliegue en un proyecto con publicación automática. Mintlify rechaza las ediciones cuando la edición de la rama de despliegue está bloqueada en el editor del panel o cuando te conectaste con un token de cliente o de máquina a máquina.

<div id="projects-that-require-review">
### Proyectos que requieren revisión
</div>

Si tu proyecto [requiere revisión antes de publicar](/es/editor/review#require-review-before-publishing), solo los administradores pueden usar `publish` en tu rama de despliegue. Para cualquier otra persona, `publish` en la rama de despliegue devuelve `review_required` y los cambios siguen pendientes.

En otras ramas, `publish` hace commit de tus cambios y abre una pull request. Solo los administradores pueden fusionar pull requests en la rama de despliegue con `merge: true`. Para cualquier otra persona, una fusión devuelve `review_required` y la pull request sigue abierta, así que fusiónala en GitHub.

Para publicar tus cambios, pide a la herramienta de IA que solicite una revisión. La herramienta de IA llama a `request_review` con las páginas que cambiaste y los revisores que indiques. Después de que un revisor apruebe los cambios, un administrador o publicador los publica desde el editor del panel o con `publish_review_request`. Consulta [Solicitudes de revisión](#review-requests) para ver las herramientas.

<div id="work-on-a-branch">
## Trabajar en una rama
Expand Down Expand Up @@ -269,7 +279,7 @@ Trabaja con los [comentarios y sugerencias](/es/editor/collaborate#comments) que
- **`suggest_edit`**: Propone una sugerencia con control de cambios en una página en lugar de editarla. El texto original permanece en la página tachado y el reemplazo aparece a su lado. Nada cambia hasta que alguien acepta o rechaza la sugerencia en el editor del panel. Pasa `path` en los mismos formatos que `read`, `oldString` y `newString`. `oldString` es el fragmento de texto visible único más corto que se va a reemplazar, dentro de un párrafo o encabezado. Usa las palabras renderizadas, no la sintaxis de Markdown o MDX. Pasa un `newString` vacío para sugerir una eliminación. Pasa un `comment` opcional para explicar por qué el cambio es útil. Mintlify lo publica como la respuesta del agente en el hilo de la sugerencia. El parámetro anterior `note` sigue funcionando como alias obsoleto de `comment`. Devuelve el nuevo `threadId` con `originalText` y `suggestedText`, recortados al fragmento que cambia. Si la misma sugerencia ya está abierta, la respuesta incluye `alreadyExists: true` y el `threadId` existente. Los errores `no_match` y `not_unique` funcionan igual que en `add_comment`. El error es `no_change` cuando ambas cadenas son iguales y `conflicting_annotation` cuando el texto se superpone con otra sugerencia abierta.
- **`reply_to_comment`**: Responde a un hilo por `threadId` con `content`. Pasa `resolve: true` para resolver también el hilo. Mintlify publica la respuesta como el agente en nombre del usuario que autorizó la conexión, y aparece en tiempo real en el editor del panel.
- **`resolve_comment`**: Resuelve un hilo sin responder.
- **`read_inbox`**: Lista tu bandeja de entrada del dashboard en un proyecto, con la actividad más reciente primero. La bandeja de entrada incluye comentarios y menciones, ediciones sugeridas, y páginas y carpetas privadas compartidas contigo. De forma predeterminada, `read_inbox` devuelve los elementos abiertos. Pasa `state` como `open`, `done` o `all`, y `section` como `comment`, `suggestion`, `invitation` o `all` (predeterminado). Pasa `filter` para limitar los comentarios a `mentions` u `on-my-page` (páginas de las que eres propietario), o las sugerencias a las de `people` o del `agent`. El filtro debe coincidir con `section`, a menos que `section` sea `all`. Pasa `dateFrom` y `dateTo` como fechas y horas ISO 8601 para limitar los elementos según su actividad más reciente. Pasa `limit` para obtener de 1 a 50 elementos por llamada (20 de forma predeterminada), y pasa `nextCursor` como `cursor` para listar elementos más antiguos. Cada elemento incluye su `category`, `state`, `latestActivity` y `target`. Cuando `target.thread` está presente, no está resuelto y no está en una página privada, llama a `read_comments` con su `filePath` y responde con `reply_to_comment`, ambos en su `branch`. Los elementos `restricted` no incluyen detalles del hilo. `read_inbox` es de solo lectura y nunca marca elementos como leídos o completados. Los errores incluyen `invalid_filter`, `invalid_date_range` e `invalid_cursor`.
- **`read_inbox`**: Lista tu bandeja de entrada del dashboard en un proyecto, con la actividad más reciente primero. La bandeja de entrada incluye comentarios y menciones, ediciones sugeridas, solicitudes de revisión, y páginas y carpetas privadas compartidas contigo. De forma predeterminada, `read_inbox` devuelve los elementos abiertos. Pasa `state` como `open`, `done` o `all`, y `section` como `comment`, `suggestion`, `invitation`, `request` o `all` (predeterminado). La sección `request` incluye solicitudes de revisión e invitaciones. Pasa `filter` para limitar los comentarios a `mentions` u `on-my-page` (páginas de las que eres propietario), las sugerencias a las de `people` o del `agent`, o la sección `request` a `requests` o `invites`. El filtro debe coincidir con `section`, a menos que `section` sea `all`. Pasa `dateFrom` y `dateTo` como fechas y horas ISO 8601 para limitar los elementos según su actividad más reciente. Pasa `limit` para obtener de 1 a 50 elementos por llamada (20 de forma predeterminada), y pasa `nextCursor` como `cursor` para listar elementos más antiguos. Cada elemento incluye su `category`, `state`, `latestActivity` y `target`. Cuando `target.thread` está presente, no está resuelto y no está en una página privada, llama a `read_comments` con su `filePath` y responde con `reply_to_comment`, ambos en su `branch`. Los elementos `restricted` no incluyen detalles del hilo. `read_inbox` es de solo lectura y nunca marca elementos como leídos o completados. Los errores incluyen `invalid_filter`, `invalid_date_range` e `invalid_cursor`.

`add_comment`, `suggest_edit`, `reply_to_comment` y `resolve_comment` requieren una sesión OAuth y una `branch`. Actúan sobre los hilos de esa rama y funcionan en tu rama de despliegue incluso cuando sus ediciones requieren una pull request. Puedes responder a hilos de sugerencias, pero debes aceptar o rechazar las sugerencias en el editor. Los comentarios en páginas privadas no están disponibles a través del Admin MCP. `read_inbox` también requiere una sesión OAuth y solo devuelve la bandeja de entrada de un miembro activo de la organización del proyecto.

Expand Down Expand Up @@ -341,6 +351,18 @@ Las herramientas de escritura devuelven el estado actualizado del proyecto en `s
Las escrituras de gestión de proyectos se aplican de inmediato al proyecto en vivo. No crean una rama ni abren una pull request. Confirma el cambio previsto antes de pedirle a una herramienta de IA que actualice automatizaciones, configuraciones, dominios, autenticación o miembros.
</Warning>

<div id="review-requests">
### Solicitudes de revisión
</div>

Estas herramientas solo aparecen cuando tu proyecto [requiere revisión antes de publicar](/es/editor/review#require-review-before-publishing). Funcionan en tu rama de despliegue y no aceptan `branch`.

- **`list_review_requests`**: Lista las solicitudes de revisión abiertas en tu rama de despliegue. Cada solicitud incluye su `requester`, sus `reviewers` y su `state`, y sus `pages`. Cada página tiene un `path`, un `title` y una `approval` con el valor `approved`, `pending` o `stale` si la página cambió después de la aprobación.
- **`request_review`**: Pide a los revisores que aprueben tus cambios pendientes. Pasa hasta 100 `pages` en los mismos formatos que `read`, y los `reviewers`, cada uno como `email` o `role`. `role: "admin"` lo pide a todos los administradores. `role: "editor"` lo pide a todos los publicadores, o a todos los editores si tu organización no tiene el rol de publicador. Mintlify solo lo pide a miembros activos, distintos de ti, que puedan aprobar. Cada revisor recibe un correo electrónico y un elemento en la [bandeja de entrada](/es/dashboard/inbox). Los errores incluyen `no_pending_changes` cuando una página no tiene nada que revisar y `no_reviewers` cuando nadie que pueda aprobar coincide con `reviewers`.
- **`withdraw_review_request`**: Retira una solicitud de revisión que hiciste mediante `requestId`. Pasa un `reviewer` con un correo electrónico para quitar solo a ese revisor. Quitar al último revisor retira la solicitud. Las páginas conservan sus cambios pendientes.
- **`approve_review_request`**: Aprueba la solicitud de revisión de otra persona mediante `requestId`, como al hacer clic en **Approve** en el editor. El Admin MCP indica a la herramienta de IA que solo apruebe cuando le pidas aprobar esa solicitud concreta, y que primero confirme contigo el solicitante y las páginas. Devuelve `own_request` para tu propia solicitud y `not_reviewer` si tu rol no puede aprobar.
- **`publish_review_request`**: Publica una solicitud de revisión aprobada mediante `requestId`, con un `title` para el mensaje de commit, como al publicar los cambios aprobados de un compañero en el editor. Los administradores y publicadores pueden publicar. El Admin MCP indica a la herramienta de IA que solo publique cuando le pidas publicar esa solicitud concreta. Devuelve `not_approved` hasta que se apruebe la versión actual de cada página, `navigation_held` mientras otra solicitud abierta retiene cambios de navegación que esta solicitud necesita, y `not_allowed` si tu rol no puede publicar. Sigue el `deployment` devuelto con `deployment_status`.

<div id="branches-and-publishing">
### Ramas y publicación
</div>
Expand All @@ -350,7 +372,7 @@ Las herramientas de escritura devuelven el estado actualizado del proyecto en `s
- **`list_branches`**: Lista las ramas de Git disponibles para el repositorio de un proyecto, con filtrado opcional por `query`. Devuelve los nombres de las ramas, el total y la rama de despliegue. Pasa cualquiera de ellas como `branch`.
- **`status`**: Lista los archivos editados, las claves de `docs.json` modificadas y el diff de navegación pendiente en `branch`, o en tu rama de despliegue cuando lo omites. En la rama de despliegue, lista solo tus cambios.
- **`diff`**: Lista todos los cambios entre `branch` y tu rama de despliegue. Cada archivo modificado y la entrada de `docs.json` incluyen `authors` y `byYou`. `authors` enumera los miembros cuyas ediciones no publicadas contiene la entrada. `byYou` es `true` cuando la entrada incluye tus propias ediciones. Usa `byYou` para distinguir tus cambios de los de un colega en una rama compartida.
- **`publish`**: En la rama de despliegue, hace commit directamente solo de tus cambios pendientes. En una rama, hace commit de los cambios pendientes y devuelve la pull request de la rama, y abre una si es necesario. Pasa `merge: true` para fusionar también la pull request cuando se permiten ediciones en la rama de despliegue. Cuando los cambios llegan a la rama de despliegue, también devuelve un estado `deployment` que puedes seguir con `deployment_status`.
- **`publish`**: En la rama de despliegue, hace commit directamente solo de tus cambios pendientes. Si tu proyecto requiere revisión y no eres administrador, devuelve `review_required` en la rama de despliegue o cuando pasas `merge: true`. Consulta [Proyectos que requieren revisión](#projects-that-require-review). En una rama, hace commit de los cambios pendientes y devuelve la pull request de la rama, y abre una si es necesario. Pasa `merge: true` para fusionar también la pull request cuando se permiten ediciones en la rama de despliegue. Cuando los cambios llegan a la rama de despliegue, también devuelve un estado `deployment` que puedes seguir con `deployment_status`.
- **`deployment_status`**: Comprueba si los cambios publicados ya están activos en tu sitio de documentación. Pasa el `commitSha` de `publish`, u omítelo para comprobar el despliegue más reciente. Devuelve un `state` con el valor `pending`, `queued`, `building`, `live`, `not_live`, `failed` o `skipped`, junto con `live` y un `message` para compartir contigo. `not_live` significa que el sitio aún sirve una versión anterior, por ejemplo porque el despliegue se revirtió o tu despliegue está fijado a una versión anterior.
- **`discard`**: Abandona las ediciones en `branch`. En la rama de despliegue, revierte solo tus cambios pendientes. En otra rama que creaste, elimina la rama y cierra su pull request.

Expand Down
2 changes: 1 addition & 1 deletion es/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -347,7 +347,7 @@ noindex: true
- **Comprobaciones de MDX en el modo source:** El modo source señala componentes mal escritos, props desconocidas o duplicadas, valores de props no válidos, props obligatorias que faltan y etiquetas sin cerrar. Pasa el cursor sobre un problema señalado para aplicar una corrección rápida.
- **Autocompletado y definiciones al pasar el cursor en el modo source:** Escribe <kbd>&lt;</kbd> para ver sugerencias de componentes, props y valores, incluidos enlaces a páginas, rutas de imágenes e iconos. Pasa el cursor sobre un componente o una prop para ver su definición. Consulta [Modo visual y modo source](/es/editor/index#visual-and-source-mode).
- **Formato en el modo de sugerencias:** En el modo de sugerencias, los cambios de negrita, cursiva, subrayado, tachado y código en línea se convierten en sugerencias que tu equipo puede aceptar o rechazar. Consulta [Sugerencias](/es/editor/collaborate#suggestions).
- **Granular publishing:** El ajuste **Selective publishing** ahora se llama **Granular publishing**. De forma predeterminada, el menú **Publish** muestra y publica solo tus propios cambios. Activa Granular publishing para elegir también entre los cambios de tu equipo. Consulta [Granular publishing](/es/editor/settings#granular-publishing).
- **Granular publishing:** El ajuste **Selective publishing** ahora se llama **Granular publishing**. De forma predeterminada, el menú **Publish** muestra y publica solo tus propios cambios. Activa Granular publishing para elegir también entre los cambios de tu equipo. Consulta [Mostrar los cambios de los compañeros](/es/editor/settings#show-teammates-changes).
- **Atajos de listas y tablas:** <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>7</kbd> crea una lista numerada y <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>9</kbd> crea una lista de tareas. En Windows y Linux, usa <kbd>Ctrl</kbd> en lugar de <kbd>Cmd</kbd>. Escribe `[]` y un espacio para empezar una lista de tareas. <kbd>Tab</kbd> y <kbd>Shift</kbd> + <kbd>Tab</kbd> aumentan y reducen la sangría de todos los elementos de lista seleccionados. En las tablas, <kbd>Tab</kbd> pasa a la siguiente celda y agrega una fila desde la última celda. Consulta [Atajos de teclado](/es/editor/keyboard-shortcuts).
- **Copiar y pegar:** Al copiar se conservan la estructura, la numeración y el formato de las listas. Al pegar desde Google Docs se conservan la negrita y los enlaces en las listas, y las listas de verificación de Google Docs y las listas de tareas de GitHub se pegan como listas de tareas.
- **Comentarios:** Los borradores de comentarios sin enviar se conservan al recargar la página, las respuestas se mantienen cuando se contrae un hilo y un comentario puede contener solo una mención. Consulta [Comentarios](/es/editor/collaborate#comments).
Expand Down
Loading
Loading