← Alle MCP-Tools

Create tag

create_tag
Schreiben

Was es tut

Create a tag. color is one of: violet, red, emerald, amber, blue, pink, teal, slate. Tags belong to one workspace and can only be attached to tasks on that board, so pass workspace_id (from list_workspaces, or a task's own) when the tag is for a workspace other than the personal one — a tag made in the wrong workspace can't be attached and has to be deleted and remade.

Parameter

NameTypPflichtBeschreibung
namestringPflicht
  • Bis zu 40 Zeichen
colorstringOptional
  • Bis zu 20 Zeichen
workspace_idstringOptional

Which workspace the tag belongs to. Optional — omitted, it lands in this account's personal workspace. Must be a workspace this account is a member of; ids come from list_workspaces.

idempotency_keystringOptional

Optional. One key per operation: pass the same key only when retrying this exact call, so a retry after a timeout replays the first result (a key already used on a different tool is refused, and keys expire after 48 hours) instead of creating a duplicate tag.

Annotationen

Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.

Nur lesenreadOnlyHint: false
Ändert Daten in deinem Done-Konto.
DestruktivdestructiveHint: false
Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
IdempotentidempotentHint: false
Jeder Aufruf kann etwas Neues hinzufügen, etwa einen Kommentar, einen Lauf oder eine Aufgabe.
Offene WeltopenWorldHint: false
Berührt nur dein eigenes Done-Konto.

Welche Tokens es aufrufen dürfen

Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.

  • Voller ZugriffErlaubt
  • Token nur zum LesenAbgelehnt
  • Token für ein ProjektAbgelehnt
  • Token für einen WorkspaceErlaubt

Probier es aus

Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:

“Leg einen Tag namens schnell-erledigt an.”

Verbinde Done mit deinem Assistenten

Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client:

Überblick über die MCP-Einrichtung →