# Referencia MCP para agentes

Descubre esquemas, elige herramientas y comprueba resultados sin inventar comandos.

## Descubre antes de editar [#descubre-antes-de-editar]

`get_capabilities` informa de capacidades desplegadas y `get_command_schema` ofrece el esquema estructural de cada comando. También está el recurso `tryslides://reference/command-schema`. Core sigue validando combinaciones, límites y referencias: una estructura válida no basta.

Consulta `get_usage` y lee el documento y su secuencia actual. Las herramientas se filtran por permisos; que una no aparezca no autoriza a eludir el consentimiento.

## Familias de herramientas [#familias-de-herramientas]

| Tarea | Herramientas |
| --- | --- |
| Descubrir e identificar | `get_capabilities`, `get_command_schema`, `new_identifier` |
| Leer documentos sincronizados | `list_presentations`, `get_presentation` |
| Crear o editar | `create_presentation`, `estimate_commands`, `execute_commands` |
| Localizar y controlar un editor | `list_editor_sessions`, `editor_action` |
| Importar imágenes públicas | `import_image_from_url` |
| Subir bytes | `prepare_image_upload`, `complete_image_upload` |
| Exportar | `export_text`, `export_presentation` |
| Compartir | `list_share_links`, `create_share_link`, `revoke_share_link` |
| Consultar resultado y saldo | `get_request_status`, `get_usage` |
| Eliminar un documento | `delete_presentation` |

## Secuencia segura [#secuencia-segura]

Lee la versión, consulta el esquema, estima un lote acotado y ejecútalo con su control de versión e identidad de petición. Si otro cliente cambió el documento, vuelve a leer antes de adaptarlo. No elimines campos de concurrencia para forzar la operación.

Tras un timeout consulta el estado con la identidad original. Reintentar exactamente la misma petición aceptada evita duplicados; un identificador nuevo representa trabajo nuevo. Informa de éxito solo cuando el resultado lo confirme.

## Imágenes y exportaciones [#imágenes-y-exportaciones]

Importar una URL ya inserta la imagen y devuelve sus identidades: no insertes otra copia. Para bytes, prepara la subida, envía los bytes exactos a la URL recibida y completa. Subir sin completar no inserta contenido.

Una exportación remota devuelve un enlace privado de cinco minutos. Cambiar el documento puede invalidarlo. No lo presentes como enlace permanente para compartir. Las descargas conectadas ocurren en el navegador del propietario; las vistas PNG se recuperan mediante el estado de petición.

## Consentimiento [#consentimiento]

Solicita solo documentos y acciones necesarios. Leer no implica editar, exportar, compartir o eliminar. Compartir sigue requiriendo Pro. Las cuentas y suscripciones quedan fuera de estos permisos.

Consulta [el formato portátil](/es/docs/ai/tryslides-format) y [uso MCP](/es/docs/ai/usage).