← Tous les outils MCP

Propose edit

propose_edit
Écriture

Ce qu’il fait

Propose changes to a task's fields WITHOUT making them: a diff a human reads as current-vs-proposed and accepts or dismisses one field at a time. Use it when you would otherwise call update_task on something a human is likely to want a say in — retitling their task, moving a date they set, rewriting their acceptance criteria. Nothing changes until a person accepts, and they can take the three edits that were right and drop the one that wasn't, instead of rejecting the lot and making you redo all four. Each edit carries a reason, which is what the person is actually deciding on. You may only propose fields you could already set yourself: a field that is refused to you is not yours to propose either. A proposal records the field's current value, so if somebody edits that same field before your proposal is read, accepting it is refused rather than quietly overwriting their work — re-read the task and propose again.

Paramètres

NomTypeObligatoireDescription
idstringObligatoire

Task id

editsobject[]Obligatoire

One entry per field. Proposing the value a field already has is dropped rather than queued.

  • De 1 à 20 éléments
edits[].fieldstringObligatoire

The task field to change, e.g. title, notes, due_date, acceptance_criteria

edits[].valueunknownFacultatif

The proposed value. null proposes clearing the field.

edits[].reasonstringFacultatif

Why — one line. This is what the human is deciding on.

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 seulereadOnlyHint: false
Modifie des données de votre compte Done.
DestructifdestructiveHint: false
Ajoute ou lit seulement ; rien de ce qui existe n’est supprimé ni écrasé.
IdempotentidempotentHint: false
Chaque appel peut ajouter quelque chose de nouveau : un commentaire, une exécution, une tâche.
Monde ouvertopenWorldHint: 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 projetRefusé
  • Jeton limité à un espace de travailAutorisé

Essayez

Une fois Done connecté, demandez à votre assistant quelque chose comme :

“Suggérez un titre plus clair et une échéance pour la tâche du site web, mais laissez-moi valider le changement.”

Connectez Done à votre assistant

Un point d’accès MCP par compte, via OAuth ou un jeton. La configuration pas à pas pour chaque client :

Vue d’ensemble de la configuration MCP →