Ce qu’il fait
Attach a real file to a task — a PDF, a screenshot, a spreadsheet, anything too large or too binary for an inline deliverable. Reserves a stored file on the task and returns a one-time upload_url. Then PUT the file's raw bytes to that URL with NO Authorization header (e.g. curl -X PUT --data-binary @report.pdf "<upload_url>"): the link itself is the credential, it works for one successful upload, and it expires 15 minutes after this call, so request it right before you upload. Once the PUT succeeds, record the file on the task with update_task as a deliverable {label, kind, artifact_id}, using the artifact_id returned here. To replace a file you already attached, pass its artifact_id — the deliverable keeps pointing at the newest upload. Refused for a read-only token, a task outside this token's project or workspace, a task in Trash, and a file past the size ceilings (25 MB per file, 100 MB across a task, 1 GB across the account).
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
task_id | string | Obligatoire | The task the file belongs to |
label | string | Obligatoire | What the file is, as a human reads it — e.g. "Q3 report" |
filename | string | null | Facultatif | What the downloaded file should be called. Advisory and sanitised before use — the extension comes from an allow-list, not from you. |
kind | string | Facultatif | "pdf" for a PDF; "binary" (the default) for anything else. Valeurs autorisées pdfbinary |
size_bytes | number | Obligatoire | The file's exact size in bytes. The quotas are checked against it now, and the upload is refused if the bytes you PUT are larger. |
artifact_id | string | null | Facultatif | To replace a file you already uploaded to this task: its artifact_id. Omit to attach a new file. |
Annotations
Les indications que le serveur envoie avec cet outil. Un client les lit pour décider s’il doit vous demander avant un appel.
- Lecture seule
readOnlyHint: false - Modifie des données de votre compte Done.
- Destructif
destructiveHint: false - Ajoute ou lit seulement ; rien de ce qui existe n’est supprimé ni écrasé.
- Idempotent
idempotentHint: false - Chaque appel peut ajouter quelque chose de nouveau : un commentaire, une exécution, une tâche.
- Monde ouvert
openWorldHint: false - Ne touche que votre propre compte Done.
Quels jetons peuvent l’appeler
Une connexion établie avec OAuth a un accès complet. Un jeton créé dans Réglages → Accès des agents → Jetons MCP supplémentaires peut être restreint, et un jeton restreint ne voit jamais au-delà de son projet ou de son espace de travail.
- Accès completAutorisé
- Jeton en lecture seuleRefusé
- Jeton limité à un projetAutorisé
- Jeton limité à un espace de travailAutorisé
Essayez
Une fois Done connecté, demandez à votre assistant quelque chose comme :
“Joignez le rapport PDF à la tâche du bilan trimestriel.”
Connectez Done à votre assistant
Un point d’accès MCP par compte, via OAuth ou un jeton. La configuration pas à pas pour chaque client :