Create Task
create_task is one of the 32 MCP tools in Weft, the AI task manager you run by talking to Claude, Cursor, Codex or ChatGPT through one MCP endpoint. Create a new task on the user's board. Lands in Backlog if no column is set. Priority defaults to medium. Use when the user asks to add a task.
Weft는 1인 창업자와 소규모 팀을 위한 AI 작업 관리 도구입니다.
도구 레퍼런스는 영어로 관리합니다. 도구 이름, 인자, 예시는 모든 언어에서 동일합니다.
인자
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| title | string | 예 | Short, specific task title. |
| description | string | 아니요 | Markdown description with any context. |
| priority | "low" | "medium" | "high" | "urgent" | 아니요 | Defaults to "medium". |
| columnId | uuid | 아니요 | Column to place the task in. Omit to land in Backlog. |
| sprintId | uuid | 아니요 | Attach the task to this sprint. |
| project | string | 아니요 | Project to file the task under — name (case-insensitive) or id. |
| assignee | string | 아니요 | Executor — a member’s name or email, or "me" to assign to the calling agent. A task has one executor: a person or an agent. |
| estimateMinutes | integer | 아니요 | Honest guess of work time in minutes. |
| dueAt | ISO-8601 datetime string | 아니요 | The day it is due — only the date part is used. Dated tasks show on the Weft calendar and in a subscribed Google/Apple/Outlook calendar. |
| startAt | ISO-8601 datetime string | 아니요 | The day work begins. With dueAt it makes a span on the calendar; never after dueAt. |
| requiresReview | boolean | 아니요 | Stop at the user before this counts as done. For the irreversible only — money, publishing outward, production, anything legal; everything else finishes without them. |
| verification | { mode, checks[] } | 아니요 | How "done" will be checked — the server executes these checks on complete_task. mode "executable"/"state_delta" lets fully-passed work close itself; "checklist"/"human" always stops at you. Check kinds: http (url → expected status + optional mustContain), citation (url + quote that must appear on the page), string_check, file_hash (sha256 among the artifacts), human_checklist (items only you can judge — resolved when you accept). Statuses and results are written by the server only. |
| blockedBy | uuid[] | 아니요 | Tasks that must finish first. The task derives agentState "blocked" while any is open and leaves ready-sets; it unblocks the moment the last blocker completes. Cycles are refused. |
반환값
The newly created task with its generated id and position.
주석
기본 쓰기 도구입니다. 상태를 변경하며, MCP 클라이언트는 사용자가 원하는 바를 파악한 뒤 자유롭게 호출할 수 있습니다. 확인을 요청할지는 클라이언트가 정합니다. Model Context Protocol 사양은 사람이 개입해 도구 호출을 거부할 수 있도록 할 것을 권장합니다.
예시
사용자가 하는 말:
"Add a high-priority task: fix flaky CI tests."AI가 내부에서 호출하는 것:
json
{
"name": "create_task",
"arguments": {
"title": "Fix flaky CI tests",
"priority": "high"
}
}관련 항목
- MCP 도구 32개 전체 — 카탈로그 보기.
- 셔틀 — AI 클라이언트가 이 도구들을 쓰는 방식.
- 직접 쓰는 클라이언트에서 이 도구를 호출하세요. 설정 가이드 보기, 또는
https://letsweft.com/api/mcp를 바로 호출하면 됩니다.