FlowState Hosted
Hosted shared memory for AI apps: project decisions, to-dos and learnings. Beta.
사용해야 할까요
품질 및 안전성
발견 사항 (13)
- HIGH
- MEDIUMstart_here에서
- MEDIUMlog_work에서
- MEDIUMsearch에서
- MEDIUMmanage_todos에서
- MEDIUMmanage_handoffs에서
- MEDIUMmanage_links에서
- INFOstart_here에서
- INFOlog_work에서
- INFOsearch에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"flowstate-hosted": {
"url": "https://hosted.flowstatemcp.com/mcp"
}
}
}원격 엔드포인트
https://hosted.flowstatemcp.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (16)
⚪start_here(project, folder, size)
Returns the project brief as text: hard rules, a handoff note if any, review mode, possible conflicts, open todos (and claims) and problems, recent changes, decisions and learnings. With no project, lists projects. Side effects: opens or reuses the automatic session, and notes when the brief was read.
입력 스키마
{
"type": "object",
"properties": {
"project": {
"type": [
"string",
"integer"
],
"description": "Name or id. Omit to list projects."
},
"folder": {
"type": "string",
"description": "Working folder, if no project is given."
},
"size": {
"type": "string",
"description": "quick, standard (default) or deep.",
"enum": [
"quick",
"standard",
"deep"
],
"default": "standard"
}
}
}🟡log_work(project, kind, summary, details, component, ...)
Records one decision (a choice and why), change, problem, learning or todo. Only adds records; updates to existing todos and problems are separate actions. Review mode or suggested=true may queue the record. A change on a shared component alerts linked projects. A close decision may include a possible-conflict note. conflicts_with opens a disagreement card. Secrets are refused. Returns {logged, record, note} or {queued_for_review}.
입력 스키마
{
"type": "object",
"properties": {
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required."
},
"kind": {
"type": "string",
"description": "The record kind (see the description).",
"enum": [
"decision",
"change",
"problem",
"learning",
"todo"
]
},
"summary": {
"type": "string",
"description": "The record in one short line."
},
"details": {
"type": "string",
"description": "Why, or old and new values. Max 10,000 chars."
},
"component": {
"type": "string",
"description": "Component name; created if missing. Shared ones too."
},
"priority": {
"type": "string",
"enum": [
"critical",
"urgent",
"high",
"normal",
"medium",
"low"
],
"description": "todo or problem. Default normal."
},
"category": {
"type": "string",
"description": "learning only: the kind of lesson.",
"enum": [
"pattern",
"gotcha",
"best_practice",
"tool_tip",
"architecture",
"performance",
"security",
"other"
]
},
"suggested": {
"type": "boolean",
"description": "true = queue it for the user's review."
},
"replaces": {
"type": "integer",
"description": "Decision id this one replaces."
},
"evidence": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 2: file:line, or output:/url:/tool: text."
},
"conflicts_with": {
"type": "integer",
"description": "Record id this disagrees with."
},
"conflicts_with_type": {
"type": "string",
"description": "Default decision.",
"enum": [
"project",
"component",
"decision",
"change",
"learning",
"problem",
"todo"
]
},
"topic": {
"type": "string",
"description": "Short topic, e.g. API sessions."
},
"source": {
"type": "string",
"description": "user_stated, ai_inferred or from_code.",
"enum": [
"user_stated",
"ai_inferred",
"from_code"
]
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"project",
"kind",
"summary"
]
}🟢search(query, answer, project, content_types, since_hours, ...)
Finds stored todos, decisions, changes, learnings, problems and solutions. query: ranked matches. query + answer=true: a short quoted answer with record ids, or a notice that FlowState has nothing. query="D12": decision 12 in full. No query: the newest records. Read-only. Returns {results, count} or {answer, sources}.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Words, or a question when answer=true. Omit to list newest."
},
"answer": {
"type": "boolean",
"description": "true = answer the query, quoting records."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Omit to search every project."
},
"content_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"todo",
"decision",
"change",
"learning",
"problem",
"solution"
]
},
"description": "Only these record types. Omit for all."
},
"since_hours": {
"type": "integer",
"description": "No query only: from the last N hours."
},
"mode": {
"type": "string",
"description": "auto, keyword or meaning.",
"enum": [
"auto",
"keyword",
"meaning"
],
"default": "auto"
},
"limit": {
"type": "integer",
"description": "Default 10, max 50."
},
"include_set_aside": {
"type": "boolean",
"description": "true = also records that were set aside."
}
}
}🔴manage_todos(action, project, todo_id, status, priority, ...)
Todos. list; next: the top unblocked todo (others' claims last). update: status, priority or title. block / unblock: waits on todos or a problem. add: a subtask, blocker or due date only (new todos are recorded separately). claim: take a todo for a period (fails if someone already has it); renew; release or handoff (with a note). Returns rows.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"next",
"update",
"block",
"unblock",
"add",
"claim",
"renew",
"release",
"handoff"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required."
},
"todo_id": {
"type": "integer",
"description": "#id in the brief."
},
"status": {
"type": "string",
"description": "update: new. list: filter.",
"enum": [
"pending",
"in_progress",
"blocked",
"done",
"cancelled"
]
},
"priority": {
"type": "string",
"enum": [
"critical",
"urgent",
"high",
"normal",
"medium",
"low"
],
"description": "add / update. list: filter."
},
"title": {
"type": "string",
"description": "add (required) / update."
},
"description": {
"type": "string",
"description": "add / update."
},
"min_priority": {
"type": "string",
"enum": [
"critical",
"urgent",
"high",
"normal",
"medium",
"low"
],
"description": "list: this or more urgent."
},
"sort": {
"type": "string",
"description": "list: default priority.",
"enum": [
"priority",
"due",
"newest"
]
},
"limit": {
"type": "integer",
"description": "next: how many (default 5)."
},
"compact": {
"type": "boolean",
"description": "list: shorter rows."
},
"parent_todo_id": {
"type": "integer",
"description": "add: parent todo id."
},
"blocked_by": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Todo ids it waits on."
},
"blocked_by_problem": {
"type": "integer",
"description": "Problem id it waits on."
},
"due_date": {
"type": "string",
"description": "add: ISO due date."
},
"component_id": {
"type": "integer",
"description": "add: component id."
},
"minutes": {
"type": "integer",
"description": "claim / renew: 1-120, default 15."
},
"where_i_was": {
"type": "string",
"description": "handoff: your progress."
},
"next_step": {
"type": "string",
"description": "handoff: the next step."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action",
"project"
]
}🔴manage_problems(action, project, problem_id, description, parent_attempt_id, ...)
Existing project problems (bugs, blockers). list: open problems. tree: one problem with every attempt and its solution. add_attempt: record a try. end_attempt: how a try ended. solve: close it with what fixed it (undo reopens it). New problems are recorded separately. Reads: list, tree. Writes need project. Returns problem rows, the tree, or the saved attempt or solution.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"tree",
"add_attempt",
"end_attempt",
"solve"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required for writes; list: omit for all projects."
},
"problem_id": {
"type": "integer",
"description": "tree / add_attempt / solve: the problem's id."
},
"description": {
"type": "string",
"description": "add_attempt: what you tried (required)."
},
"parent_attempt_id": {
"type": "integer",
"description": "add_attempt: an earlier attempt this one builds on."
},
"attempt_id": {
"type": "integer",
"description": "end_attempt: the attempt's id (from add_attempt or tree)."
},
"outcome": {
"type": "string",
"description": "end_attempt: how it ended (required).",
"enum": [
"success",
"failure",
"partial",
"abandoned"
]
},
"notes": {
"type": "string",
"description": "end_attempt: what you learned."
},
"confidence": {
"type": "string",
"description": "end_attempt: how sure. Default attempted.",
"enum": [
"attempted",
"worked_once",
"verified",
"proven",
"deprecated"
]
},
"summary": {
"type": "string",
"description": "solve: what fixed it (required)."
},
"key_insight": {
"type": "string",
"description": "solve: the lesson, one sentence."
},
"winning_attempt_id": {
"type": "integer",
"description": "solve: the attempt that worked."
},
"code_snippet": {
"type": "string",
"description": "solve: the fix as text. No secrets."
},
"component_id": {
"type": "integer",
"description": "list: only this component's problems."
},
"compact": {
"type": "boolean",
"description": "list: shorter rows."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action"
]
}🔴manage_review(action, project, status, limit, after, ...)
The user's review queue and mode: summaries, suggestions, imports, clean-ups, deletes, conflicts. list (a line each; item_id: one in full), get_mode: read-only. walk: items waiting, as boxes or links. approve: make it a record (edit / move_to first), delete (confirm_name), or confirm a conflict (keep=a|b|both). set_mode: which new records wait. approve, reject and set_mode require a user_request quoting the user; on Hosted, approve and reject are refused for AI clients, and the user decides them on their FlowState review page. Returns {items, total}, the mode, or the result.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"walk",
"get_mode",
"approve",
"reject",
"set_mode"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Required to approve or reject."
},
"status": {
"type": "string",
"description": "list: which ones. Default pending.",
"enum": [
"pending",
"approved",
"rejected",
"all"
]
},
"limit": {
"type": "integer",
"description": "list: how many (20; max 100)."
},
"after": {
"type": "integer",
"description": "list, walk: the page after this id."
},
"item_id": {
"type": "integer",
"description": "list: one in full. approve / reject: its id."
},
"user_request": {
"type": "string",
"description": "The user's own words (required)."
},
"reason": {
"type": "string",
"description": "reject: the user's reason (required)."
},
"summary": {
"type": "string",
"description": "approve: new summary."
},
"details": {
"type": "string",
"description": "approve: new details."
},
"priority": {
"type": "string",
"enum": [
"critical",
"urgent",
"high",
"normal",
"medium",
"low"
],
"description": "approve: for a todo or problem."
},
"category": {
"type": "string",
"description": "approve: for a learning.",
"enum": [
"pattern",
"gotcha",
"best_practice",
"tool_tip",
"architecture",
"performance",
"security",
"other"
]
},
"component": {
"type": "string",
"description": "approve: component to file it under."
},
"move_to": {
"type": [
"string",
"integer"
],
"description": "Project to move a misfiled item to."
},
"mode": {
"type": "string",
"description": "set_mode: the new mode (default auto_only).",
"enum": [
"off",
"auto_only",
"types",
"everything"
]
},
"kinds": {
"type": "array",
"items": {
"type": "string",
"enum": [
"decision",
"change",
"problem",
"learning",
"todo"
]
},
"description": "set_mode, mode=types: kinds that wait."
},
"clear": {
"type": "boolean",
"description": "set_mode: drop this project's override."
},
"confirm_name": {
"type": "string",
"description": "Project delete: the exact name."
},
"keep": {
"type": "string",
"description": "Disagreement: a (older), b (newer) or both.",
"enum": [
"a",
"b",
"both"
]
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action"
]
}⚪manage_handoffs(action, project, where_i_was, next_step, handoff_id, ...)
Notes from one AI to the next. leave: saves where_i_was and next_step; the next brief shows it after the hard rules. pickup: marks a note so it stops showing. list: open notes. Not a session summary and not a todo. Adds or marks notes; does not delete. Returns the note or {notes}.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"leave",
"pickup",
"list"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required."
},
"where_i_was": {
"type": "string",
"description": "leave: progress so far. Max 1,000 chars."
},
"next_step": {
"type": "string",
"description": "leave: the next step. Max 500 chars."
},
"handoff_id": {
"type": "integer",
"description": "pickup: the note id."
},
"include_picked_up": {
"type": "boolean",
"description": "list: include picked-up notes."
},
"limit": {
"type": "integer",
"description": "list: max notes. Default 20."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action",
"project"
]
}🔴manage_rules(action, project, rule, rule_id, user_request, ...)
A project's hard rules: short never/always rules from the user, shown first in every brief and not cut. add: one sentence, max 300 chars; 25 rules, 2,000 chars in total. Added or removed rules wait in the user's review queue until the user approves them (on their review page; no app can). list: active rules. remove: requires a user_request quoting the user; it waits like add; the rule is kept as removed. Preferences and lessons are recorded separately. Requires project. Returns the rule or {rules}.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"add",
"list",
"remove"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required."
},
"rule": {
"type": "string",
"description": "add: the rule, one short sentence."
},
"rule_id": {
"type": "integer",
"description": "remove: the rule's id (R<id> in the brief)."
},
"user_request": {
"type": "string",
"description": "remove (required): the user's own words asking to remove it."
},
"include_removed": {
"type": "boolean",
"description": "list: also removed rules."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action",
"project"
]
}🔴manage_links(action, project, link_type, component, item_type, ...)
Connects things across projects. add: a project uses a shared component (link_type=uses, target_project, target_component), depends on a project, two components are the same, records relate, or a record gets a URL (e.g. an issue). A change or decision logged on the shared component then gives each linked project an update todo and a 'changed since' line; FlowState does not edit other projects. remove: by link_id or the add fields; kept as removed (undo, record_type=link). flag_conflict: two records disagree (topic, evidence); the user keeps one. list: read-only. Requires project. Returns the link, the card, or {links}.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"add",
"remove",
"list",
"flag_conflict"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "The source project, by name or id. Required."
},
"link_type": {
"type": "string",
"description": "How the source relates to the target: uses, depends_on, part_of, same_as, supersedes, subtask_of, blocks, about, or url.",
"enum": [
"uses",
"depends_on",
"part_of",
"same_as",
"supersedes",
"subtask_of",
"blocks",
"about",
"url"
]
},
"component": {
"type": "string",
"description": "Source: a component of this project, by name."
},
"item_type": {
"type": "string",
"description": "Source: a record type, with item_id.",
"enum": [
"project",
"component",
"decision",
"change",
"learning",
"problem",
"todo"
]
},
"item_id": {
"type": "integer",
"description": "Source: the record's id."
},
"target_project": {
"type": [
"string",
"integer"
],
"description": "add: the target project, by name or id."
},
"target_component": {
"type": "string",
"description": "add: a component name in the target project."
},
"target_type": {
"type": "string",
"description": "add: a target record type, with target_id.",
"enum": [
"project",
"component",
"decision",
"change",
"learning",
"problem",
"todo"
]
},
"target_id": {
"type": "integer",
"description": "add: the target record's id."
},
"url": {
"type": "string",
"description": "add: an https URL to attach to the source record."
},
"note": {
"type": "string",
"description": "add: a short note kept on the link."
},
"topic": {
"type": "string",
"description": "flag_conflict: what they disagree about, in plain words."
},
"evidence": {
"type": "array",
"items": {
"type": "string"
},
"description": "flag_conflict: up to 2 snippets for the source record."
},
"target_evidence": {
"type": "array",
"items": {
"type": "string"
},
"description": "flag_conflict: up to 2 snippets for the other record."
},
"link_id": {
"type": "integer",
"description": "remove: the link's id (from list); or give the add fields instead."
},
"include_removed": {
"type": "boolean",
"description": "list: also removed links."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action",
"project"
]
}🔴manage_history(action, project, record_type, record_id, limit, ...)
A project's record trail. list: latest first (kind, limit=20, 50 max; ids and titles). undo: one row, latest first; skipped rows stay listed. restore: a deleted project or one record by the id in the delete answer (not a row number). Logged changes (kind=change) appear in search results. list and undo require project. Returns {history}, the undo result, or {rows, page}.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"who",
"undo",
"metrics"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required for list and undo; who: omit for all."
},
"record_type": {
"type": "string",
"description": "list: only this record type. undo: required.",
"enum": [
"todo",
"project",
"component",
"problem",
"solution",
"attempt",
"variable",
"method",
"attachment",
"link",
"learning",
"decision",
"change",
"rule",
"handoff"
]
},
"record_id": {
"type": "integer",
"description": "list: only this record. undo: required."
},
"limit": {
"type": "integer",
"description": "list / who: max rows. Default 20, max 100."
},
"by_app": {
"type": "string",
"description": "who: only apps whose name contains this."
},
"by_model": {
"type": "string",
"description": "who: only models whose name contains this."
},
"by_machine": {
"type": "string",
"description": "who: only this machine or workspace."
},
"since": {
"type": "string",
"description": "who: from this local time, such as 2026-10-17."
},
"until": {
"type": "string",
"description": "who: up to this local time."
},
"page": {
"type": "integer",
"description": "who: page number. Default 1."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action"
]
}🔴manage_projects(action, project, name, description, status, ...)
Projects and their components (named parts of a project). list: projects (by status). create: names are unique. update: rename, describe, or set status (archived retires it). list_components / add_component / update_component: the same for components (deprecated retires one). delete / delete_component: deletes it with its child records after a safety copy; the answer includes the undo identifier. create and delete wait for the user's approval when approvals are on (the item then appears in the review queue, and the answer's next line names it). Reads: list, list_components. Returns project or component rows, or what was deleted.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"list_components",
"create",
"add_component",
"update",
"update_component",
"delete",
"delete_component"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Every action but list and create: the project, by name or id."
},
"name": {
"type": "string",
"description": "create / add_component: the new name (required, unique). update / update_component: a new name."
},
"description": {
"type": "string",
"description": "create / update / add_component / update_component: what it is."
},
"status": {
"type": "string",
"description": "list: only this status. update: active, paused, completed or archived. update_component: planning, in_progress, testing, complete or deprecated.",
"enum": [
"active",
"paused",
"completed",
"archived",
"planning",
"in_progress",
"testing",
"complete",
"deprecated"
]
},
"component_id": {
"type": "integer",
"description": "update_component / delete_component: the component's id (list_components shows ids)."
},
"parent_component_id": {
"type": "integer",
"description": "add_component: a parent component in the same project."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action"
]
}🔴manage_memory(action, project, kinds, text, format, ...)
Memory import, export, set-aside and wipe. preview_import: a markdown file of records without writing. import_markdown: writes them (an edited FlowState markdown export). export: JSON or markdown. set_aside / restore_aside / list_aside: hide or bring back a record (type + id). delete: every record except rules after a safety copy (clear_rules=true includes them); the answer includes the undo identifier. delete waits for the user's approval when approvals are on (the item then appears in the review queue, and the answer's next line names it). Requires project. Returns counts and ids.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"stale",
"cleanup",
"import",
"mark_checked",
"set_source",
"set_aside",
"restore_set_aside",
"files_changed",
"delete"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required."
},
"kinds": {
"type": "array",
"items": {
"type": "string",
"enum": [
"duplicate",
"stale",
"misfiled"
]
},
"description": "cleanup: which checks. Omit for all three."
},
"text": {
"type": "string",
"description": "import: the file contents. Max 200,000 chars."
},
"format": {
"type": "string",
"description": "import: memory (default; one memory per line or bullet) or flowstate_markdown (an edited FlowState markdown export).",
"enum": [
"memory",
"flowstate_markdown"
]
},
"origin": {
"type": "string",
"description": "import: where it came from, such as Claude or ChatGPT."
},
"kind": {
"type": "string",
"description": "import (memory format): record kind for each memory. Default learning.",
"enum": [
"learning",
"decision",
"todo",
"problem",
"change"
]
},
"record_type": {
"type": "string",
"description": "delete / mark_checked / set_source / set_aside / restore_set_aside: the record's type (all but delete: todo, decision, change, learning, problem, variable, method).",
"enum": [
"decision",
"change",
"learning",
"todo",
"problem",
"attempt",
"handoff",
"rule",
"link",
"variable",
"method",
"attachment"
]
},
"record_id": {
"type": "integer",
"description": "delete / mark_checked / set_source / set_aside / restore_set_aside: the record's id."
},
"reason": {
"type": "string",
"description": "set_aside (required): why the record no longer applies."
},
"paths": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 200,
"description": "files_changed (required): the files you changed, repo-relative."
},
"source": {
"type": "string",
"description": "set_source (required) / mark_checked (optional): user_stated, ai_inferred or from_code.",
"enum": [
"user_stated",
"ai_inferred",
"from_code"
]
},
"days": {
"type": "integer",
"description": "stale: unchecked for this many days. Default 60."
},
"limit": {
"type": "integer",
"description": "stale: max facts. Default 20."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action",
"project"
]
}🔴manage_sessions(action, project, session_id, summary, outcomes, ...)
Inspects FlowState's sessions. They open and close by themselves (closed after 2 hours idle or when the app quits, with a summary queued for review). current, list, conversations: read. start: returns the automatic session. end: close one with a summary (not undoable). Decisions are recorded separately. Returns session or conversation rows.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"current",
"list",
"conversations",
"start",
"end"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required except for current."
},
"session_id": {
"type": "integer",
"description": "end: the session's id (required). conversations: only this session."
},
"summary": {
"type": "string",
"description": "end: what was accomplished."
},
"outcomes": {
"type": "array",
"items": {
"type": "string"
},
"description": "end: short outcome lines."
},
"focus_component_id": {
"type": "integer",
"description": "start: component in focus (ignored if a session is open)."
},
"focus_problem_id": {
"type": "integer",
"description": "start: problem in focus (ignored if a session is open)."
},
"limit": {
"type": "integer",
"description": "list / conversations: max rows. Default 20."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action"
]
}🔴manage_variables(action, project, variable_id, name, value, ...)
Non-secret project settings: hosts, ports, endpoints, config. create, list (read), update (undoable), delete (undo restores it; with approvals on it waits for the user; refused for HTTP app keys and remote apps). Secrets are refused; is_secret only labels a value and does not hide it. Passwords, tokens and keys are refused and not saved. Requires project. Returns variable rows.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"create",
"update",
"delete"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required."
},
"variable_id": {
"type": "integer",
"description": "update / delete: the variable's id (required)."
},
"name": {
"type": "string",
"description": "create: name, unique per project and category (required). update: a new name."
},
"value": {
"type": "string",
"description": "create / update: the setting as text. Never a secret."
},
"description": {
"type": "string",
"description": "create / update: what it is for."
},
"category": {
"type": "string",
"description": "create / update: the group, default custom. list: filter.",
"enum": [
"server",
"credentials",
"config",
"environment",
"endpoint",
"custom"
]
},
"is_secret": {
"type": "boolean",
"description": "create / update: label as sensitive. It is still returned by list."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action",
"project"
]
}🔴manage_methods(action, project, method_id, name, description, ...)
Documented reusable procedures of a project (deploy, test, a code convention), with ordered steps. create, list (read), update (steps replaces the whole list; undoable), delete (undo restores it; with approvals on it waits for the user; refused for HTTP app keys and remote apps). One-off choices and lessons are recorded separately. Requires project. Returns method rows.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"create",
"update",
"delete"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required."
},
"method_id": {
"type": "integer",
"description": "update / delete: the method's id (required)."
},
"name": {
"type": "string",
"description": "create: name, unique in the project (required). update: a new name."
},
"description": {
"type": "string",
"description": "create (required) / update: what the procedure is."
},
"category": {
"type": "string",
"description": "create / update: the group. list: filter.",
"enum": [
"auth",
"deployment",
"testing",
"architecture",
"workflow",
"convention",
"api",
"security",
"other"
]
},
"steps": {
"type": "array",
"items": {
"type": "string"
},
"description": "create / update: ordered steps. update replaces the whole list."
},
"code_example": {
"type": "string",
"description": "create / update: sample code. No secrets."
},
"related_component_id": {
"type": "integer",
"description": "create / update: the component it belongs to."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action",
"project"
]
}🟡manage_skills(action, project, skill, skill_type, context, ...)
The connected app's own learned skills, checkpoints and metrics: how the AI works, not project facts (those are recorded separately). learn: save a skill. list: a project's and global skills. confirm: one more session where it held (promoted after 3 at a 0.8 rate). save_state / get_state: a checkpoint. log_metric / list_metrics: scores. Reads: list, get_state, list_metrics; the rest only add rows or counts. Returns rows.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"list",
"get_state",
"list_metrics",
"learn",
"confirm",
"save_state",
"log_metric"
],
"description": "The operation; see the tool description."
},
"project": {
"type": [
"string",
"integer"
],
"description": "Project name or id. Required except for list and list_metrics; list adds global skills."
},
"skill": {
"type": "string",
"description": "learn: what was learned (required)."
},
"skill_type": {
"type": "string",
"description": "learn (required) / list (filter): the kind of skill.",
"enum": [
"tool_capability",
"user_preference",
"approach",
"gotcha",
"project_specific"
]
},
"context": {
"type": "string",
"description": "learn: when it applies. log_metric: where it was scored."
},
"tool_name": {
"type": "string",
"description": "learn: the related tool. list: filter."
},
"promoted_only": {
"type": "boolean",
"description": "list: only promoted skills."
},
"skill_id": {
"type": "integer",
"description": "confirm: the skill's id (required)."
},
"focus_summary": {
"type": "string",
"description": "save_state: what the session was doing."
},
"key_facts": {
"type": "array",
"items": {
"type": "string"
},
"description": "save_state: facts to keep."
},
"pending_decisions": {
"type": "array",
"items": {
"type": "string"
},
"description": "save_state: decisions not made yet."
},
"active_problem_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "save_state: problem ids in progress."
},
"active_component_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "save_state: component ids in progress."
},
"metric_type": {
"type": "string",
"description": "log_metric (required) / list_metrics (filter): which metric.",
"enum": [
"checkpoint_timing",
"tool_choice",
"response_quality",
"prediction_accuracy",
"user_satisfaction"
]
},
"effectiveness_score": {
"type": "number",
"description": "log_metric: score from 0.0 to 1.0."
},
"action_taken": {
"type": "string",
"description": "log_metric: what was done."
},
"outcome": {
"type": "string",
"description": "log_metric: what happened."
},
"model": {
"type": "string",
"description": "Model name if known. Unknown names are omitted."
}
},
"required": [
"action"
]
}커뮤니티
증거