# General Translation Integrations: Herramientas MCP de Google Drive
URL: https://generaltranslation.com/es/docs/integrations/google-drive/reference/mcp-tools.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Traduce Google Docs, Google Sheets y Google Slides mediante el MCP server alojado y autenticado. Referencia de API de las herramientas MCP de Google Drive.

El servidor alojado en `https://api.gtx.dev/mcp` expone tres herramientas para buscar Projects conectados, iniciar traducciones y sondear su progreso. Estas herramientas utilizan las mismas conexiones de Google Drive y las mismas copias traducidas que la integración del Dashboard, y admiten Google Docs, Google Sheets y Google Slides.

## Overview [#overview]

| Herramienta                                            | Description                                                                                              | Permiso                                             |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| [Autenticación y acceso](#access)                      | Elige las credenciales y un modo de conexión con Google Drive.                                           | —                                                      |
| [`get_google_drive_context`](#drive-context)           | Enumera los Projects conectados a los que tienes acceso y resuelve el contexto de archivo opcional.      | `project:files:read`                                   |
| [`translate_google_drive_file`](#translate-drive-file) | Sincroniza y traduce un archivo de Google Docs, Google Sheets o Google Slides.                           | `project:files:write` y `project:translations:enqueue` |
| [`get_google_drive_translation_status`](#drive-status) | Devuelve el progreso de la traducción, el progreso del layout y las URL de las copias traducidas. | `project:files:read`                                   |

## Autenticación y acceso [#access]

Conéctate al [MCP server alojado](/docs/overview/for-coding-agents#mcp) con OAuth o una clave de API admitida:

* **OAuth:** las herramientas pueden usar tu cuenta personal de Google vinculada o la conexión con la unidad compartida de Organization del Project. Una conexión personal legacy que solo tenga acceso `drive.file` puede llegar a los archivos seleccionados en el Dashboard, pero debe volver a conectarse con acceso completo a Drive para que una herramienta pueda traducir otro archivo.
* **Clave de API de Project:** la clave debe incluir los permisos que exige la herramienta, y el Project debe usar una conexión con una unidad compartida de Organization.
* **Clave de API de Organization:** la clave debe incluir los permisos que exige la herramienta y apuntar a un Project que use una conexión con una unidad compartida de Organization.
* **Locadex:** el Project debe usar una conexión con una unidad compartida de Organization.

Quien haga la llamada con una clave de API no puede usar una cuenta personal de Google para acceder a Drive. La Organization necesita la funcionalidad de project integrations, y el acceso a la unidad compartida de Organization requiere además su propia funcionalidad Enterprise. Configura ambos modos de conexión en la [referencia de Connection](/docs/integrations/google-drive/reference/connection).

Las llamadas de MCP y de la API aplican el permiso indicado para cada herramienta. Las acciones sobre archivos en el Dashboard requieren `project:files:write` y `project:translations:enqueue`, mientras que la página comprueba por separado `translations:content:write` antes de mostrar los controles de la cuenta personal.

## `get_google_drive_context` [#drive-context]

**Solo lectura** · **Permiso** `project:files:read`

Llama primero a esta herramienta para listar los Projects a los que puede acceder la credencial actual y obtener sus project IDs y su configuración regional. También puedes resolver el contexto de origen y de configuración regional de un archivo de Google Drive.

### Entradas

| Nombre    | Descripción                                                                                     | Tipo                             | Opcional | Predeterminado |
| --------- | ----------------------------------------------------------------------------------------------- | -------------------------------- | -------- | -------------- |
| `fileId`  | ID del archivo de Google Drive que aparece en la URL de Docs, Sheets o Slides después de `/d/`. | `string`                         | Sí       | —              |
| `hostApp` | Editor de Google al que pertenece el archivo.                                                   | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | Sí       | —              |

Omite ambas entradas para listar los projects conectados. Proporciona ambas para inspeccionar un source file o una copia traducida gestionada por la integración.

### Devuelve

El resultado incluye:

* `user.email`, que puede ser `null` y no indica si hay una cuenta personal de Google conectada.
* Las configuraciones regionales admitidas.
* Los Projects accesibles con sus ID, nombres, configuraciones regionales de origen predeterminadas, configuraciones regionales actuales, allowlists de locales y estado de la integración.
* El contexto de la configuración regional de origen y de destino cuando el archivo solicitado está vinculado o es una copia traducida gestionada.

Se omiten los Projects cuyo modo de conexión no puede utilizar quien realiza la llamada.

## `translate_google_drive_file` [#translate-drive-file]

**Mutación** · **Permisos** `project:files:write` y `project:translations:enqueue`

Sincroniza un archivo de Google Docs, Google Sheets o Google Slides, importa las ediciones de las copias traducidas existentes, encola el trabajo de traducción y aplica las traducciones completadas a las copias gestionadas.

### Entradas

| Nombre          | Descripción                                                                                                                                                                | Tipo                             | Opcional | Predeterminado                                                 |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------- | -------------------------------------------------------------- |
| `projectId`     | ID del proyecto devuelto por `get_google_drive_context`.                                                                                                                    | `string`                         | No       | —                                                              |
| `fileId`        | ID del archivo de Google Drive que aparece en la URL de Docs, Sheets o Slides después de `/d/`.                                                                            | `string`                         | No       | —                                                              |
| `hostApp`       | Editor de Google al que pertenece el archivo.                                                                                                                              | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | No       | —                                                              |
| `targetLocales` | De uno a 100 códigos de configuración regional admitidos. Si el Project tiene una allowlist de locales, todos los códigos deben figurar en ella. | `string[]`                       | No       | —                                                              |
| `sourceLocale`  | Configuración regional de origen. Recurre a la configuración regional almacenada del archivo y, después, a la predeterminada del Project.                                  | `string`                         | Sí       | Configuración regional almacenada o predeterminada del Project |
| `force`         | Vuelve a traducir el contenido existente en lugar de reutilizarlo.                                                                                                         | `boolean`                        | Sí       | `false`                                                        |

Cuando `fileId` identifica una copia traducida gestionada, la herramienta resuelve su origen original y usa únicamente la configuración regional de destino de esa copia. Su configuración regional de origen original también reemplaza a `sourceLocale`.

La herramienta descarta cualquier código de destino que coincida exactamente con el origen resuelto. La solicitud falla antes de poner nada en cola si no queda ningún destino o si un destino es un código más amplio o más específico del idioma de origen, como `en` y `en-GB`. Para traducir entre variantes, usa dos códigos que difieran en la región o en el sistema de escritura, como `en-US` y `en-GB`.

### Devuelve

El resultado contiene `accepted`, el `sourceLocale` y los `targetLocales` resueltos, los conteos en `enqueued` y `failed`, y un array `errors`. Revisa los tres campos de resultado, ya que una configuración regional de destino puede fallar mientras otras quedan en cola.

Los errores de validación de configuración regional hacen que falle toda la solicitud en lugar de devolver este resultado.

Esta herramienta puede consumir créditos de traducción y actualizar copias traducidas existentes. La traducción forzada puede sobrescribir el texto traducido y los cambios de layout.

## `get_google_drive_translation_status` [#drive-status]

**Solo lectura** · **Permiso** `project:files:read`

Consulta esta herramienta de forma periódica después de `translate_google_drive_file` para ver el progreso de la traducción y de la maquetación de cada configuración regional solicitada.

### Entradas

| Nombre      | Descripción                                                                                     | Tipo                             | Opcional | Predeterminado |
| ----------- | ----------------------------------------------------------------------------------------------- | -------------------------------- | -------- | -------------- |
| `projectId` | ID del proyecto devuelto por `get_google_drive_context`.                                         | `string`                         | No       | —              |
| `fileId`    | ID del archivo de Google Drive que aparece en la URL de Docs, Sheets o Slides después de `/d/`. | `string`                         | No       | —              |
| `hostApp`   | Editor de Google al que pertenece el archivo.                                                   | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | No       | —              |

### Devuelve

Cada resultado de configuración regional contiene sus detalles de configuración regional, los valores anulables `translationProgress` y `layoutProgress`, y un booleano `done`. Solo Google Slides tiene una fase de layout, por lo que `layoutProgress` se mantiene en `null` para Google Docs y Google Sheets. Cuando haya una copia gestionada disponible, `targetCopy` contendrá su ID de archivo de Google Drive y una URL que se abre en el editor indicado por `hostApp`.

Cuando `fileId` identifica una copia traducida gestionada, la herramienta resuelve su origen y devuelve el estado de la configuración regional de destino de esa copia.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
