工具 - 其他

本页记录了按领域分组、但没有专属页面的 MCP 工具。

潜在客户（CRM）

`list_leads`

列出 CRM 潜在客户，支持可选的分页和筛选。

参数：

名称	类型	必填	描述
page	number	否	页码（默认值：1）
limit	number	否	每页项目数（默认值：50，最大值：100）
search	string	否	按姓名、电子邮件、电话或公司搜索
source	string	否	按潜在客户来源筛选（例如：`linkedin`、`manual`、`api`）
funnelId	string (UUID)	否	按漏斗筛选
stageId	string (UUID)	否	按漏斗阶段筛选

示例：

{
  "search": "Juan",
  "source": "linkedin",
  "limit": 20
}

`get_lead`

按 ID 获取潜在客户，包括标签、漏斗阶段和其他关联。

参数：

名称	类型	必填	描述
id	string (UUID)	是	潜在客户 ID

示例：

{
  "id": "lead-uuid-001"
}

`create_lead`

在 CRM 中创建新的潜在客户。姓名为必填项。

参数：

名称	类型	必填	描述
name	string	是	潜在客户姓名
email	string	否	电子邮件地址
phone	string	否	电话号码
company	string	否	公司名称
position	string	否	职位/职务
source	string	否	来源（例如：`linkedin`、`tiktok`、`instagram`、`manual`、`api`、`import`）
notes	string	否	附加备注

示例：

{
  "name": "Ana Garcia",
  "email": "[email protected]",
  "company": "Empresa SL",
  "source": "linkedin"
}

`update_lead`

更新现有潜在客户的字段。仅更新提供的字段。

参数：

名称	类型	必填	描述
id	string (UUID)	是	潜在客户 ID
name	string	否	更新后的姓名
email	string	否	更新后的电子邮件
phone	string	否	更新后的电话
company	string	否	更新后的公司
position	string	否	更新后的职位
notes	string	否	更新后的备注

示例：

{
  "id": "lead-uuid-001",
  "position": "CTO",
  "notes": "对企业方案感兴趣"
}

`delete_lead`

按 ID 从 CRM 中永久删除潜在客户。

参数：

名称	类型	必填	描述
id	string (UUID)	是	要删除的潜在客户 ID

示例：

{
  "id": "lead-uuid-001"
}

`move_lead_stage`

将潜在客户移动到漏斗中的其他阶段。

参数：

名称	类型	必填	描述
leadId	string (UUID)	是	潜在客户 ID
funnelId	string (UUID)	是	目标漏斗 ID
stageId	string (UUID)	是	目标阶段 ID

示例：

{
  "leadId": "lead-uuid-001",
  "funnelId": "funnel-uuid-001",
  "stageId": "stage-uuid-003"
}

响应：

{
  "success": true,
  "previousStageId": "stage-uuid-002",
  "currentStageId": "stage-uuid-003",
  "lead": { ... }
}

文档

`list_documents`

列出文档，支持可选的分页和筛选。

参数：

名称	类型	必填	描述
page	number	否	页码（默认值：1）
limit	number	否	每页项目数（默认值：50，最大值：100）
search	string	否	按标题搜索
categoryId	string (UUID)	否	按类别筛选
projectId	string (UUID)	否	按项目筛选

示例：

{
  "search": "changelog",
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

`list_document_categories`

列出所有文档类别及每个类别中的文档数量。

参数：

此工具无需参数。

示例：

{}

响应：

[
  {
    "id": "cat-001",
    "name": "Changelogs",
    "documentCount": 12
  },
  {
    "id": "cat-002",
    "name": "Arquitectura",
    "documentCount": 5
  }
]

名称	类型	必填	描述
name	string	是	标签名称（唯一）
color	string	否	十六进制格式的颜色（例如：`#ff5733`）

名称	类型	必填	描述
id	string (UUID)	是	要删除的标签 ID

漏斗

`list_funnels`

列出所有销售漏斗，包括其阶段。

参数：

此工具无需参数。

示例：

{}

`get_funnel`

按 ID 获取漏斗，包括其所有阶段和配置。

参数：

名称	类型	必填	描述
id	string (UUID)	是	漏斗 ID

示例：

{
  "id": "funnel-uuid-001"
}

创意（Idea Hub）

`list_idea_items`

列出 Idea Hub 项目（创意和待办事项），支持分页和筛选。

参数：

名称	类型	必填	描述
page	number	否	页码（默认值：1）
limit	number	否	每页项目数（默认值：50，最大值：100）
type	string	否	按类型筛选：`idea`、`todo`
status	string	否	按状态筛选：`active`、`archived`、`pending`、`done`、`blocked`
ownerUserId	string	否	按负责人筛选
projectId	string (UUID)	否	按项目筛选
search	string	否	按标题/描述搜索
dueDate	string	否	按截止日期筛选
discussed	boolean	否	按讨论标记筛选

示例：

{
  "type": "idea",
  "status": "active",
  "limit": 20
}

`get_idea_item`

按 ID 获取 Idea Hub 项目，包括可追溯性链接。

参数：

名称	类型	必填	描述
id	string (UUID)	是	创意项目 ID

示例：

{
  "id": "idea-uuid-001"
}

`create_idea_item`

在 Idea Hub 中创建新项目。

参数：

名称	类型	必填	描述
title	string	是	项目标题
type	string	是	类型：`idea` 或 `todo`
status	string	否	初始状态：`active`、`archived`、`pending`、`done`、`blocked`
projectId	string (UUID) 或 null	否	关联项目（回退到会话项目）
description	string 或 null	否	描述
ownerUserId	string 或 null	否	负责人用户 ID
dueDate	string 或 null	否	截止日期（ISO 8601）
metadata	object	否	任意元数据

示例：

{
  "title": "Integrar notificaciones push",
  "type": "idea",
  "description": "Enviar notificaciones cuando se completan work items"
}

`update_idea_item`

更新现有 Idea Hub 项目。仅修改提供的字段。

参数：

名称	类型	必填	描述
id	string (UUID)	是	创意项目 ID
title	string	否	新标题
type	string	否	新类型：`idea`、`todo`
status	string	否	新状态
projectId	string (UUID) 或 null	否	新项目
description	string 或 null	否	新描述
ownerUserId	string 或 null	否	新负责人
dueDate	string 或 null	否	新截止日期
metadata	object	否	新元数据
discussed	boolean	否	标记为已讨论

示例：

{
  "id": "idea-uuid-001",
  "status": "done",
  "discussed": true
}

`delete_idea_item`

按 ID 删除 Idea Hub 项目。

参数：

名称	类型	必填	描述
id	string (UUID)	是	创意项目 ID

示例：

{
  "id": "idea-uuid-001"
}

`set_idea_item_status`

更新 Idea Hub 项目的状态。

参数：

名称	类型	必填	描述
id	string (UUID)	是	创意项目 ID
status	string	是	新状态：`active`、`archived`、`pending`、`done`、`blocked`

示例：

{
  "id": "idea-uuid-001",
  "status": "archived"
}

`assign_idea_item_owner`

分配或移除 Idea Hub 项目的负责人。

参数：

名称	类型	必填	描述
id	string (UUID)	是	创意项目 ID
ownerUserId	string 或 null	是	负责人用户 ID（使用 `null` 移除）

示例：

{
  "id": "idea-uuid-001",
  "ownerUserId": "user-uuid-001"
}

查找用户 ID

在分配负责人之前，使用 list_members 获取组织成员的用户 ID。

`set_idea_item_due_date`

设置或移除 Idea Hub 项目的截止日期。

参数：

名称	类型	必填	描述
id	string (UUID)	是	创意项目 ID
dueDate	string 或 null	是	ISO 8601 截止日期（使用 `null` 移除）

示例：

{
  "id": "idea-uuid-001",
  "dueDate": "2025-03-15"
}

`toggle_idea_item_discussed`

切换 Idea Hub 项目的“已讨论”标记。

参数：

名称	类型	必填	描述
id	string (UUID)	是	创意项目 ID
discussed	boolean	是	使用 `true` 标记为已讨论，使用 `false` 取消标记

示例：

{
  "id": "idea-uuid-001",
  "discussed": true
}

`promote_idea_item`

将 Idea Hub 项目提升为工作项，并在两者之间创建可追溯性链接。

参数：

名称	类型	必填	描述
id	string (UUID)	是	要提升的创意项目 ID
workItemType	string	是	工作项类型：`task`、`story`、`feature`、`epic`
title	string	是	所生成工作项的标题
description	string	否	工作项描述
priority	string	否	优先级：`low`、`medium`、`high`、`urgent`
boardId	string (UUID)	是	目标看板
boardColumnId	string (UUID)	是	初始列
projectId	string (UUID)	否	项目（回退到创意项目或会话项目）
parentId	string (UUID)	否	父工作项
notes	string	否	提升备注
promotedBy	string	否	执行提升操作的用户 ID

示例：

{
  "id": "idea-uuid-001",
  "workItemType": "task",
  "title": "Implementar notificaciones push",
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef",
  "boardColumnId": "col-001",
  "priority": "medium"
}

响应：

{
  "source": {
    "id": "idea-uuid-001",
    "type": "idea",
    "status": "active"
  },
  "workItem": {
    "id": "wi-new-001",
    "taskId": "A-T-55",
    "title": "Implementar notificaciones push",
    "type": "task"
  },
  "link": {
    "id": "link-uuid-001",
    "ideaItemId": "idea-uuid-001",
    "workItemId": "wi-new-001",
    "linkType": "promoted_to",
    "createdAt": "2025-02-15T10:00:00.000Z"
  }
}

`get_idea_item_traceability`

获取 Idea Hub 项目的可追溯性链接（已提升的工作项、关联的反馈等）。

参数：

名称	类型	必填	描述
id	string (UUID)	是	创意项目 ID

示例：

{
  "id": "idea-uuid-001"
}

`link_feedback_to_idea_item`

在 Idea Hub 项目与反馈项目之间创建可追溯性链接。

参数：

名称	类型	必填	描述
ideaItemId	string (UUID)	是	创意项目 ID
feedbackItemId	string (UUID)	是	反馈项目 ID
metadata	object	否	链接元数据

示例：

{
  "ideaItemId": "idea-uuid-001",
  "feedbackItemId": "feedback-uuid-001"
}

`unlink_feedback_from_idea_item`

移除创意项目与反馈项目之间的可追溯性链接。

参数：

名称	类型	必填	描述
ideaItemId	string (UUID)	是	创意项目 ID
feedbackItemId	string (UUID)	是	反馈项目 ID

示例：

{
  "ideaItemId": "idea-uuid-001",
  "feedbackItemId": "feedback-uuid-001"
}

依赖项

`get_work_item_dependencies`

获取工作项的所有依赖项和依赖者。

依赖项 = 阻塞此项目的内容
依赖者 = 此项目所阻塞的内容

参数：

名称	类型	必填	描述
id	string (UUID)	是	工作项 ID

示例：

{
  "id": "wi-001"
}

响应：

{
  "dependencies": [
    {
      "workItemId": "wi-001",
      "blockedByWorkItemId": "wi-000",
      "createdAt": "2025-02-01T10:00:00.000Z"
    }
  ],
  "dependents": [
    {
      "workItemId": "wi-002",
      "blockedByWorkItemId": "wi-001",
      "createdAt": "2025-02-01T10:00:00.000Z"
    }
  ]
}

`add_work_item_dependency`

为工作项添加依赖项（将其标记为被另一项目阻塞）。不允许创建循环依赖项（项目不能依赖自身）。

参数：

名称	类型	必填	描述
workItemId	string (UUID)	是	被阻塞工作项的 ID
blockedByWorkItemId	string (UUID)	是	阻塞工作项的 ID

示例：

{
  "workItemId": "wi-002",
  "blockedByWorkItemId": "wi-001"
}

`remove_work_item_dependency`

从工作项中移除依赖项。

参数：

名称	类型	必填	描述
workItemId	string (UUID)	是	工作项 ID
blockedByWorkItemId	string (UUID)	是	要移除的阻塞工作项 ID

示例：

{
  "workItemId": "wi-002",
  "blockedByWorkItemId": "wi-001"
}

`get_dependencies_batch`

在一次调用中获取多个工作项的依赖项和依赖者。

参数：

名称	类型	必填	描述
workItemIds	string[] (UUID)	是	工作项 ID 列表

示例：

{
  "workItemIds": ["wi-001", "wi-002", "wi-003"]
}

响应：

{
  "items": [
    {
      "workItemId": "wi-001",
      "dependencies": [],
      "dependents": [{ "workItemId": "wi-002", "blockedByWorkItemId": "wi-001" }]
    },
    {
      "workItemId": "wi-002",
      "dependencies": [{ "workItemId": "wi-002", "blockedByWorkItemId": "wi-001" }],
      "dependents": []
    },
    {
      "workItemId": "wi-003",
      "dependencies": [],
      "dependents": []
    }
  ]
}

私有存储

私有存储工具操作属于已认证用户的文件。它们需要具有指定 MCP 权限的 API 密钥，且绝不会泄露对象存储中的原始密钥。有关 REST 负载、私有下载和限制，请参阅私有存储。

工具	权限	限制
`storage_usage`	`mcp:read`	返回字节和对象用量。
`storage_list`	`mcp:read`	最多 200 个条目。
`storage_read`	`mcp:read`	响应限制为 1 MiB；对于较大文件，请使用经过身份验证的 REST 下载。
`storage_write`	`mcp:write`	负载限制为 1 MiB；准确提供一个文本 `content` 或 `base64`。
`storage_delete`	`mcp:write`	按 ID 删除自己的文件。

AI 和会话

`record_ai_session`

记录与工作项关联的 AI 会话的令牌消耗量和成本。在完成任务工作时使用此工具，以跟踪 AI 资源用量。

参数：

名称	类型	必填	描述
workItemId	string (UUID)	是	关联工作项的 ID
model	string	是	使用的 AI 模型（例如：`claude-opus-4-6`、`claude-sonnet-4-5-20250929`）
provider	string	否	AI 提供商（默认值：`openai`）
inputTokens	number	是	消耗的输入令牌
outputTokens	number	是	消耗的输出令牌
totalTokens	number	是	令牌总数（输入 + 输出）
estimatedCost	number	否	以美元计的估算成本（如有可能则自动计算）
durationMs	number	否	会话持续时间（毫秒）
sessionType	string	否	会话类型（默认值：`implement`）
metadata	object	否	附加元数据（例如：`{ taskId: "A-T-48", skill: "implement" }`）

示例：

{
  "workItemId": "wi-001",
  "model": "claude-opus-4-6",
  "provider": "anthropic",
  "inputTokens": 50000,
  "outputTokens": 15000,
  "totalTokens": 65000,
  "durationMs": 180000,
  "sessionType": "implement"
}

`get_ai_sessions`

获取工作项的 AI 会话历史记录，并可选择提供令牌总数、成本和持续时间的汇总摘要。

参数：

名称	类型	必填	描述
workItemId	string (UUID)	是	工作项 ID
includeSummary	boolean	否	包含汇总摘要（默认值：`true`）

示例：

{
  "workItemId": "wi-001",
  "includeSummary": true
}

响应：

{
  "workItemId": "wi-001",
  "taskId": "A-T-37",
  "title": "Implementar login",
  "sessions": [
    {
      "id": "session-001",
      "model": "claude-opus-4-6",
      "provider": "anthropic",
      "inputTokens": 50000,
      "outputTokens": 15000,
      "totalTokens": 65000,
      "estimatedCost": "0.0975",
      "sessionType": "implement",
      "createdAt": "2025-02-15T10:00:00.000Z"
    }
  ],
  "summary": {
    "totalSessions": 1,
    "totalTokens": 65000,
    "totalCost": "0.0975"
  }
}

`check_quota`

检查 AI 提供商是否有可用配额（令牌、成本、请求）。返回是否允许使用以及剩余容量。

参数：

名称	类型	必填	描述
provider	string	是	AI 提供商（例如：`anthropic`、`openai`）

示例：

{
  "provider": "anthropic"
}

`get_quota_usage`

获取 AI 提供商当前的配额用量。返回每个活动周期（日、周、月）的用量数据，包括令牌、成本和请求。

参数：

名称	类型	必填	描述
provider	string	否	AI 提供商。如省略，则返回所有提供商的用量

示例：

{
  "provider": "anthropic"
}

成员

`list_members`

列出当前工作区的所有成员。返回每位成员的 userId、name、email、image 和 role。

参数：

此工具无需参数。

示例：

{}

响应：

[
  {
    "userId": "user-001",
    "name": "Javier Lopez",
    "email": "[email protected]",
    "image": "https://...",
    "role": "owner"
  },
  {
    "userId": "user-002",
    "name": "Ana Garcia",
    "email": "[email protected]",
    "image": null,
    "role": "member"
  }
]

查找用户 ID

在将工作项或创意项目分配给特定人员之前，使用此工具获取用户 ID。

里程碑（目标）

`list_milestones`

列出项目的所有里程碑，包括进度统计信息。如果未提供，则使用 MCP 会话的 projectId。

参数：

名称	类型	必填	描述
projectId	string (UUID)	否	项目 ID（回退到会话项目）

示例：

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

`get_milestone`

按 ID 获取里程碑，包括其关联的工作项和进度统计信息。

参数：

名称	类型	必填	描述
milestoneId	string (UUID)	是	里程碑 ID

示例：

{
  "milestoneId": "ms-uuid-001"
}

`get_milestone_progress`

获取里程碑的进度统计信息（项目总数、已完成项目数、百分比）。

参数：

名称	类型	必填	描述
milestoneId	string (UUID)	是	里程碑 ID

示例：

{
  "milestoneId": "ms-uuid-001"
}

`create_milestone`

在项目中创建新里程碑。创建时可选择关联工作项。如果未提供，则使用会话的 projectId。

参数：

名称	类型	必填	描述
projectId	string (UUID)	否	项目 ID（回退到会话项目）
title	string	是	里程碑标题
description	string	否	描述
priority	string	否	优先级：`low`、`medium`、`high`、`urgent`（默认值：`medium`）
targetDate	string	否	目标日期（ISO 8601，例如：`2026-03-15`）
workItemIds	string[] (UUID)	否	创建时要关联的工作项

示例：

{
  "title": "MVP Autenticacion",
  "description": "Login con Google + email/password funcionando",
  "priority": "high",
  "targetDate": "2025-03-31",
  "workItemIds": ["wi-001", "wi-002", "wi-003"]
}

响应：

{
  "id": "ms-uuid-001",
  "title": "MVP Autenticacion",
  "description": "Login con Google + email/password funcionando",
  "status": "planned",
  "priority": "high",
  "targetDate": "2025-03-31T00:00:00.000Z",
  "linkedWorkItems": 3,
  "createdAt": "2025-02-15T10:00:00.000Z"
}

`update_milestone`

更新现有里程碑。仅修改提供的字段。

参数：

名称	类型	必填	描述
milestoneId	string (UUID)	是	里程碑 ID
title	string	否	新标题
description	string 或 null	否	新描述（使用 `null` 清除）
status	string	否	新状态：`planned`、`in_progress`、`completed`、`on_hold`、`cancelled`
priority	string	否	新优先级：`low`、`medium`、`high`、`urgent`
targetDate	string 或 null	否	新目标日期（使用 `null` 清除）

示例：

{
  "milestoneId": "ms-uuid-001",
  "status": "in_progress"
}

`delete_milestone`

按 ID 删除里程碑。同时移除与工作项的所有关联。

参数：

名称	类型	必填	描述
milestoneId	string (UUID)	是	里程碑 ID

示例：

{
  "milestoneId": "ms-uuid-001"
}

`add_work_items_to_milestone`

将一个或多个工作项关联到里程碑。重复项会被静默忽略。

参数：

名称	类型	必填	描述
milestoneId	string (UUID)	是	里程碑 ID
workItemIds	string[] (UUID)	是	工作项 ID 列表（至少 1 个）

示例：

{
  "milestoneId": "ms-uuid-001",
  "workItemIds": ["wi-004", "wi-005"]
}

响应：

{
  "milestoneId": "ms-uuid-001",
  "linkedCount": 2
}

`remove_work_item_from_milestone`

取消工作项与里程碑的关联。

参数：

名称	类型	必填	描述
milestoneId	string (UUID)	是	里程碑 ID
workItemId	string (UUID)	是	要取消关联的工作项 ID

示例：

{
  "milestoneId": "ms-uuid-001",
  "workItemId": "wi-004"
}

响应：

{
  "removed": true,
  "milestoneId": "ms-uuid-001",
  "workItemId": "wi-004"
}

潜在客户（CRM）
文档
- list_documents
- list_document_categories
标签
漏斗
- list_funnels
- get_funnel
创意（Idea Hub）
依赖项
私有存储
AI 和会话
成员
- list_members
里程碑（目标）

潜在客户（CRM）​

list_leads​

get_lead​

create_lead​

update_lead​

delete_lead​

move_lead_stage​

文档​

list_documents​

list_document_categories​

标签​

list_tags​

create_tag​

delete_tag​

漏斗​

list_funnels​

get_funnel​

创意（Idea Hub）​

list_idea_items​

get_idea_item​

create_idea_item​

update_idea_item​

delete_idea_item​

set_idea_item_status​

assign_idea_item_owner​

set_idea_item_due_date​

toggle_idea_item_discussed​

promote_idea_item​

get_idea_item_traceability​

link_feedback_to_idea_item​

unlink_feedback_from_idea_item​

依赖项​

get_work_item_dependencies​

add_work_item_dependency​

remove_work_item_dependency​

get_dependencies_batch​

私有存储​

AI 和会话​

record_ai_session​

get_ai_sessions​

check_quota​

get_quota_usage​

成员​

list_members​

里程碑（目标）​

list_milestones​

get_milestone​

get_milestone_progress​

create_milestone​

update_milestone​

delete_milestone​

add_work_items_to_milestone​

remove_work_item_from_milestone​

潜在客户（CRM）

`list_leads`

`get_lead`

`create_lead`

`update_lead`

`delete_lead`

`move_lead_stage`

文档

`list_documents`

`list_document_categories`

标签

`list_tags`

`create_tag`

`delete_tag`

漏斗

`list_funnels`

`get_funnel`

创意（Idea Hub）

`list_idea_items`

`get_idea_item`

`create_idea_item`

`update_idea_item`

`delete_idea_item`

`set_idea_item_status`

`assign_idea_item_owner`

`set_idea_item_due_date`

`toggle_idea_item_discussed`

`promote_idea_item`

`get_idea_item_traceability`

`link_feedback_to_idea_item`

`unlink_feedback_from_idea_item`

依赖项

`get_work_item_dependencies`

`add_work_item_dependency`

`remove_work_item_dependency`

`get_dependencies_batch`

私有存储

AI 和会话

`record_ai_session`

`get_ai_sessions`

`check_quota`

`get_quota_usage`

成员

`list_members`

里程碑（目标）

`list_milestones`

`get_milestone`

`get_milestone_progress`

`create_milestone`

`update_milestone`

`delete_milestone`

`add_work_items_to_milestone`

`remove_work_item_from_milestone`