Referencia MCP para agentes
Descubre esquemas, elige herramientas y comprueba resultados sin inventar comandos.
Leer en MarkdownDescubre 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
| 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
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
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
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 y uso MCP.