MCP Tools 参考
内置工具
list_tasks
列出项目任务实例，按创建时间降序排列。
输入：
| 字段 | 类型 | 说明 |
|---|---|---|
status | string（可选） | 过滤状态：pending、running、success、failed、pending_approval、rejected |
limit | integer（可选） | 返回条数，默认 50，最大 200 |
offset | integer（可选） | 分页偏移，默认 0 |
输出（文本）： 任务列表，每项含状态、进度、类型、时间信息。
get_task
获取单个任务的详细信息，含参数、结果、错误信息。
输入：
| 字段 | 类型 | 说明 |
|---|---|---|
task_id | string | 任务实例 UUID |
list_agents
列出当前项目的所有 Agent。无需输入参数。
输出： Agent 列表，含 id、name、description、is_default、agent_type。
list_workspaces
列出当前项目的所有工作区。无需输入参数。
输出： 工作区列表，含 id、name、slug、type、is_default、artifact_type。
list_project_statuses
列出项目的所有共享状态，包含字段声明和当前值。
调用此工具可了解 set_project_status 可以写哪些字段。
set_project_status
更新项目状态的字段值，只有传入的字段会被修改。
输入：
| 字段 | 类型 | 说明 |
|---|---|---|
status | string | 状态名称（来自 list_project_statuses） |
values | object | 字段名 → 新值的映射 |
示例：
json
{
"status": "pipeline",
"values": { "current_stage": "embedding", "progress": 45 }
}list_task_type_memories
分页列举某个元任务跨所有运行积累的记忆，最新的在前。
输入：
| 字段 | 类型 | 说明 |
|---|---|---|
task_type | string | 元任务 identifier 或 UUID |
limit | integer（可选） | 页大小，默认 20，最大 100 |
offset | integer（可选） | 分页偏移，默认 0 |
get_task_memories
获取单次任务运行贡献的记忆。
输入：
| 字段 | 类型 | 说明 |
|---|---|---|
task_id | string | 任务实例 UUID |
limit | integer（可选） | 页大小，默认 20 |
offset | integer（可选） | 分页偏移，默认 0 |
okf_search
在项目知识库中搜索 OKF 概念。
输入：
| 字段 | 类型 | 说明 |
|---|---|---|
query | string | 搜索词 |
workspace_id | string（可选） | 知识库工作区 UUID；默认使用项目的知识库工作区 |
okf_lint
对项目知识库运行健康检查。
输入：
| 字段 | 类型 | 说明 |
|---|---|---|
workspace_id | string（可选） | 知识库工作区 UUID |
动态任务 Tools
每个开启了「允许 MCP 调用」的元任务都会生成一个同名 Tool。
Tool 名称： 元任务的 identifier 字段（字母、数字、-、_）
输入： 与元任务的 param_schema 定义的字段一致
输出文本：
Task 'web-scraper-20260821120000' created successfully.
task_id: 550e8400-e29b-41d4-a716-446655440000
status: pending使用元数据： 工具调用的 _meta 字段包含 task_id、task_name、status，便于后续查询。
提示：调用动态任务 Tool 后立即返回，任务在后台异步执行。使用
get_task工具轮询，或订阅状态变更。