Lien de téléchargement d'un document
Nom de l'outil
get_document_download_linkLecture seule
Description
Renvoie un lien de téléchargement direct, en lecture seule et valable quelques minutes, vers le fichier d'un document d'un dossier ou d'une pièce jointe de courriel. À n'appeler que si l'utilisateur veut le fichier, et à lui transmettre tel quel.
Accès requis
- Au moins une de ces permissions :
dossier-detail.tab.documentoumail-inbox.list.viewoumail-outbox.list.viewoumail-sendbox.list.viewoumail-trashbox.list.viewouall-mail.list.viewoudossier-detail.tab.mailbox - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
documentId | integer | obligatoire | Identifiant du document (champ id de list_dossier_documents ou documentId d'une pièce jointe de get_email). |
Résultat
Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.
Champs du résultat
| Nom | Type | Présence | Description |
|---|---|---|---|
documentId | integer | Identifiant du document. | |
name | string | peut être null | Nom du fichier. |
url | string | Lien de téléchargement direct, en lecture seule. À transmettre tel quel à l'utilisateur ; il expire à expiresAt. | |
expiresAt | string (date-time) | Fin de validité du lien (UTC). |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Lien de téléchargement d'un document | Nom lisible affiché par le client MCP. |
readOnlyHint | oui | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | non | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur. |
Définition JSON
Entrée exacte de tools/list
{
"name": "get_document_download_link",
"title": "Lien de téléchargement d'un document",
"description": "Renvoie un lien de téléchargement direct, en lecture seule et valable quelques minutes, vers le fichier d'un document d'un dossier ou d'une pièce jointe de courriel. À n'appeler que si l'utilisateur veut le fichier, et à lui transmettre tel quel.",
"inputSchema": {
"type": "object",
"properties": {
"documentId": {
"description": "Identifiant du document (champ id de list_dossier_documents ou documentId d'une pièce jointe de get_email).",
"type": "integer"
}
},
"required": [
"documentId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"documentId": {
"description": "Identifiant du document.",
"type": "integer"
},
"name": {
"description": "Nom du fichier.",
"type": [
"string",
"null"
]
},
"url": {
"description": "Lien de téléchargement direct, en lecture seule. À transmettre tel quel à l'utilisateur ; il expire à expiresAt.",
"type": "string"
},
"expiresAt": {
"description": "Fin de validité du lien (UTC).",
"type": "string",
"format": "date-time"
}
},
"required": [
"documentId",
"url",
"expiresAt"
]
},
"annotations": {
"title": "Lien de téléchargement d'un document",
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": true
}
}