MMyPlanDokumentasi
MCPReferensi tool

Goals & kolaborasi

Goals dan key result, initiative, project update, notifikasi, intake, dan customer.

Goals dan key result, initiative, project update, notifikasi, intake, dan customer. Lihat Token dan izin untuk aturan akses.

ToolJenisRingkasan
list_goalsbacaLists the goals (objectives) of a workspace with status, progress, owner and period.
get_goalbacaReads one goal with its key results, links, sub-goals and optionally the check-in history.
create_goaltulisCreates a goal (objective) for a period.
update_goaltulisChanges a goal.
delete_goaltulisDeletes a goal with its key results, check-ins and links.
add_key_resulttulisAdds a key result to a goal.
update_key_resulttulisChanges a key result.
delete_key_resulttulisDeletes a key result and its check-ins.
check_intulisRecords progress: a new value (with a note) on a key result, and/or a new status on the goal.
link_goaltulisLinks a project, epic, cycle or work item to a goal, or to a work-kind key result (its progress then counts that work).
unlink_goaltulisRemoves a goal or key-result link (linkId from get_goal).
list_initiativesbacaLists workspace initiatives (efforts above projects and epics) with status, health and progress.
get_initiativebacaReads one initiative with its linked projects, epics and goals, and optionally its status updates.
create_initiativetulisCreates an initiative.
update_initiativetulisChanges an initiative.
delete_initiativetulisDeletes an initiative (linked projects, epics and goals stay).
attach_to_initiativetulisAttaches a project, epic or goal to an initiative.
detach_from_initiativetulisDetaches a project, epic or goal from an initiative.
post_initiative_updatetulisPosts a status update on an initiative; its health becomes the initiative's health.
list_project_updatesbacaLists the status updates (health posts) of a project, newest first, optionally with their comments.
post_project_updatetulisPosts a status update on a project with a health (on_track, at_risk, off_track).
comment_project_updatetulisComments on a project status update (id from list_project_updates).
list_notificationsbacaLists your inbox notifications in a workspace (newest first, up to 200) and the unread count.
update_notificationtulisMarks a notification read or unread, archives or unarchives it, or snoozes it.
mark_all_notifications_readtulisMarks every unread notification in a workspace as read.
my_work_summarybacaYour work overview in a workspace: counts of items you created, are assigned or subscribed to, by status category, priority and project.
list_intakebacaLists intake requests of a project: open (pending/snoozed) or closed (accepted/declined/duplicate).
create_intaketulisFiles a request into a project's intake (triaged later into a work item).
triage_intaketulisDecides an intake request: accept (creates a work item), decline, snooze, mark duplicate of a work item, or reopen.
list_customersbacaLists the customers of a workspace with stage, owner and request counts.
create_customertulisCreates a customer.
list_customer_requestsbacaLists customer requests (feature asks, bugs) with linked work items, for one customer or the whole workspace.
create_customer_requesttulisRecords a request from a customer, optionally linked to work items.
link_customer_requesttulisLinks a work item to a customer request, or unlinks it.

list_goals

Hanya baca. Bisa dipakai dengan token baca saja.

Lists the goals (objectives) of a workspace with status, progress, owner and period.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
statusarray<"on_track" / "at_risk" / "off_track" / "achieved" / "dropped">tidakOnly these statuses

get_goal

Hanya baca. Bisa dipakai dengan token baca saja.

Reads one goal with its key results, links, sub-goals and optionally the check-in history.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
goalstringyaGoal id or exact title
include_check_insbooleantidak

create_goal

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Creates a goal (objective) for a period. Add key results with add_key_result. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
titlestringyaminimal 1 karakter
start_onstringyaformat YYYY-MM-DD
end_onstringyaformat YYYY-MM-DD
descriptionstringtidakPlain text
status"on_track" / "at_risk" / "off_track" / "achieved" / "dropped"tidak
ownerstringtidakEmail or name; "me" for yourself
parentstringtidakParent goal id or title

update_goal

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Changes a goal. Only the fields given change; clear removes owner or parent. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
goalstringyaGoal id or exact title
titlestringtidakminimal 1 karakter
start_onstringtidakformat YYYY-MM-DD
end_onstringtidakformat YYYY-MM-DD
descriptionstringtidakPlain text
status"on_track" / "at_risk" / "off_track" / "achieved" / "dropped"tidak
ownerstringtidakEmail or name; "me" for yourself
parentstringtidakParent goal id or title
cleararray<"owner" / "parent">tidak

delete_goal

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Deletes a goal with its key results, check-ins and links. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
goalstringyaGoal id or exact title

add_key_result

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Adds a key result to a goal. Kinds: numeric (start->target), percentage, boolean, or work (progress computed from linked work; link it with link_goal). Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
goalstringyaGoal id or exact title
titlestringyaminimal 1 karakter
kind"numeric" / "percentage" / "boolean" / "work"tidakDefault numeric
start_valuenumbertidaknumeric only
target_valuenumbertidaknumeric only
current_valuenumbertidaknumeric/percentage (0-100)/boolean (0 or 1)
unitstringtidake.g. %, users, $ (max 20 chars)

update_key_result

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Changes a key result. Prefer check_in to record progress. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
key_resultstringyaKey result id, or its title together with goal
goalstringtidakGoal id or title, when key_result is a title
titlestringtidakminimal 1 karakter
kind"numeric" / "percentage" / "boolean" / "work"tidak
start_valuenumbertidaknumeric only
target_valuenumbertidaknumeric only
current_valuenumbertidaknumeric/percentage (0-100)/boolean (0 or 1)
unitstringtidake.g. %, users, $ (max 20 chars)

delete_key_result

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Deletes a key result and its check-ins. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
key_resultstringyaKey result id, or its title together with goal
goalstringtidak

check_in

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Records progress: a new value (with a note) on a key result, and/or a new status on the goal. Work-kind key results take their value from linked work. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
goalstringtidakGoal id or title (needed for a status change, or to find a key result by title)
key_resultstringtidakKey result id or title
valuenumbertidakNew current value of the key result
notestringtidak
status"on_track" / "at_risk" / "off_track" / "achieved" / "dropped"tidakNew goal status

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Links a project, epic, cycle or work item to a goal, or to a work-kind key result (its progress then counts that work). Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
goalstringtidakGoal id or title
key_resultstringtidakKey result id or title (work kind); link to it instead of the goal
kind"project" / "epic" / "cycle" / "task"ya
targetstringyaProject key/name/id, work item reference (PROJ-12) or id, epic number/title/id, cycle name/id
projectstringtidakProject of the epic or cycle when target is not an id

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Removes a goal or key-result link (linkId from get_goal). Needs write access.

ParameterTipeWajibKeterangan
link_idstringyalinkId shown by get_goal; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

list_initiatives

Hanya baca. Bisa dipakai dengan token baca saja.

Lists workspace initiatives (efforts above projects and epics) with status, health and progress.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
statusarray<"planned" / "active" / "completed" / "paused" / "cancelled">tidak

get_initiative

Hanya baca. Bisa dipakai dengan token baca saja.

Reads one initiative with its linked projects, epics and goals, and optionally its status updates.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
initiativestringyaInitiative id or exact name
include_updatesbooleantidak

create_initiative

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Creates an initiative. The lead defaults to you. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
namestringyaminimal 1 karakter
descriptionstringtidakPlain text
leadstringtidakEmail or name; "me" for yourself
status"planned" / "active" / "completed" / "paused" / "cancelled"tidak
health"on_track" / "at_risk" / "off_track"tidak
start_onstringtidakformat YYYY-MM-DD
target_onstringtidakformat YYYY-MM-DD

update_initiative

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Changes an initiative. Only the fields given change; clear empties lead or dates. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
initiativestringyaInitiative id or exact name
namestringtidakminimal 1 karakter
descriptionstringtidakPlain text
leadstringtidakEmail or name; "me" for yourself
status"planned" / "active" / "completed" / "paused" / "cancelled"tidak
health"on_track" / "at_risk" / "off_track"tidak
start_onstringtidakformat YYYY-MM-DD
target_onstringtidakformat YYYY-MM-DD
cleararray<"lead" / "start_on" / "target_on">tidak

delete_initiative

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Deletes an initiative (linked projects, epics and goals stay). Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
initiativestringyaInitiative id or exact name

attach_to_initiative

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Attaches a project, epic or goal to an initiative. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
initiativestringyaInitiative id or exact name
kind"project" / "epic" / "goal"ya
targetstringyaProject key/name/id, epic number/title/id, or goal title/id
projectstringtidakProject of the epic when target is not an id

detach_from_initiative

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Detaches a project, epic or goal from an initiative. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
initiativestringyaInitiative id or exact name
kind"project" / "epic" / "goal"ya
targetstringyaProject key/name/id, epic number/title/id, or goal title/id
projectstringtidakProject of the epic when target is not an id

post_initiative_update

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Posts a status update on an initiative; its health becomes the initiative's health. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
initiativestringyaInitiative id or exact name
health"on_track" / "at_risk" / "off_track"ya
textstringyaminimal 1 karakter

list_project_updates

Hanya baca. Bisa dipakai dengan token baca saja.

Lists the status updates (health posts) of a project, newest first, optionally with their comments.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
projectstringyaProject key, id or name
limitintegertidakDefault 10; 1–100
include_commentsbooleantidak

post_project_update

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Posts a status update on a project with a health (on_track, at_risk, off_track). Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
projectstringyaProject key, id or name
health"on_track" / "at_risk" / "off_track"ya
textstringyaPlain text; blank lines start new paragraphs; minimal 1 karakter
target_onstringtidakNew target date for the project, if it moves; format YYYY-MM-DD

comment_project_update

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Comments on a project status update (id from list_project_updates). Needs write access.

ParameterTipeWajibKeterangan
update_idstringyaUpdate id from list_project_updates; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
textstringyaminimal 1 karakter

list_notifications

Hanya baca. Bisa dipakai dengan token baca saja.

Lists your inbox notifications in a workspace (newest first, up to 200) and the unread count.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
filter"unread" / "all" / "archived" / "snoozed"tidakDefault unread
kindstringtidakOnly this notification kind, e.g. task_assigned, task_updated, project_update, initiative_update, chat_mention

update_notification

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Marks a notification read or unread, archives or unarchives it, or snoozes it.

ParameterTipeWajibKeterangan
idstringyaNotification id; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
readbooleantidak
archivedbooleantidak
snoozed_untilstring / nulltidakISO date-time; null to unsnooze

mark_all_notifications_read

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Marks every unread notification in a workspace as read.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)

my_work_summary

Hanya baca. Bisa dipakai dengan token baca saja.

Your work overview in a workspace: counts of items you created, are assigned or subscribed to, by status category, priority and project.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)

list_intake

Hanya baca. Bisa dipakai dengan token baca saja.

Lists intake requests of a project: open (pending/snoozed) or closed (accepted/declined/duplicate).

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
projectstringyaProject key, id or name
tab"open" / "closed"tidakDefault open
searchstringtidakText in the title or requester

create_intake

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Files a request into a project's intake (triaged later into a work item). Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
projectstringyaProject key, id or name
titlestringyaminimal 1 karakter
descriptionstringtidakPlain text

triage_intake

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Decides an intake request: accept (creates a work item), decline, snooze, mark duplicate of a work item, or reopen. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
idstringyaIntake request id; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
action"accept" / "decline" / "snooze" / "duplicate" / "reopen"ya
titlestringtidakaccept: work item title (default: request title)
statusstringtidakaccept: status name or category
priority"none" / "low" / "medium" / "high" / "urgent"tidakaccept
assigneesarray<string>tidakaccept: emails or names; "me"
reasonstringtidakdecline: why
untilstringtidaksnooze: ISO date-time in the future; pola ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
duplicate_ofstringtidakduplicate: work item reference or id in the same project

list_customers

Hanya baca. Bisa dipakai dengan token baca saja.

Lists the customers of a workspace with stage, owner and request counts.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
stagearray<"lead" / "prospect" / "active" / "churned">tidak

create_customer

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Creates a customer. The owner defaults to you. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
namestringyaminimal 1 karakter
emailstringtidak
websitestringtidak
stage"lead" / "prospect" / "active" / "churned"tidak
ownerstringtidakEmail or name; "me"
employeesintegertidak0–9007199254740991
revenuenumbertidakmin 0
notesstringtidak

list_customer_requests

Hanya baca. Bisa dipakai dengan token baca saja.

Lists customer requests (feature asks, bugs) with linked work items, for one customer or the whole workspace.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
customerstringtidakCustomer id or exact name
statusarray<"new" / "under_review" / "planned" / "done" / "declined">tidak

create_customer_request

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Records a request from a customer, optionally linked to work items. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
customerstringyaCustomer id or exact name
titlestringyaminimal 1 karakter
descriptionstringtidak
status"new" / "under_review" / "planned" / "done" / "declined"tidak
source"email" / "call" / "chat" / "other"tidak
itemsarray<string>tidakWork item references or ids to link

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Links a work item to a customer request, or unlinks it. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
request_idstringyaCustomer request id; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
itemstringyaWork item reference or id
unlinkbooleantidak

Di halaman ini