tool-usage

# 在命令和智能体中使用 MCP 工具 关于在 Claude Code 插件命令和智能体中有效使用 MCP 工具的完整指南。 ## 概述 一旦配置了 MCP 服务器，其工具即可通过前缀 `mcp__plugin____` 使用。在命令和智能体中使用这些工具的方式与内置的 Claude Code 工具相同。 ## 工具命名约定 ### 格式 mcp__plugin____ ### 示例 **带有 asana 服务器的 Asana 插件：** - `mcp__plugin_asana_asana__asana_create_task` - `mcp__plugin_asana_asana__asana_search_tasks` - `mcp__plugin_asana_asana__asana_get_project` **带有数据库服务器的自定义插件：** - `mcp__plugin_myplug_database__query` - `mcp__plugin_myplug_database__execute` - `mcp__plugin_myplug_database__list_tables` ### 发现工具名称 **使用 `/mcp` 命令：** bash /mcp 这将显示： - 所有可用的 MCP 服务器 - 每个服务器提供的工具 - 工具架构和描述 - 用于配置的完整工具名称 ## 在命令中使用工具 ### 预先允许工具 在命令的元数据（frontmatter）中指定 MCP 工具： markdown --- description: 创建一个新的 Asana 任务 allowed-tools: [ "mcp__plugin_asana_asana__asana_create_task" ] --- # 创建任务命令 要创建任务： 1. 从用户处收集任务详情 2. 使用 mcp__plugin_asana_asana__asana_create_task 并传入详情 3. 向用户确认创建结果 ### 多个工具 markdown --- allowed-tools: [ "mcp__plugin_asana_asana__asana_create_task", "mcp__plugin_asana_asana__asana_search_tasks", "mcp__plugin_asana_asana__asana_get_project" ] --- ### 通配符（请谨慎使用） markdown --- allowed-tools: ["mcp__plugin_asana_asana__*"] --- **注意：** 仅当命令确实需要访问服务器中的所有工具时才使用通配符。 ### 在命令指令中使用工具 **示例命令：** markdown --- description: 搜索并创建 Asana 任务 allowed-tools: [ "mcp__plugin_asana_asana__asana_search_tasks", "mcp__plugin_asana_asana__asana_create_task" ] --- # Asana 任务管理 ## 搜索任务 要搜索任务： 1. 使用 mcp__plugin_asana_asana__asana_search_tasks 2. 提供搜索过滤器（经办人、项目等） 3. 向用户显示结果 ## 创建任务 要创建任务： 1. 收集任务详情： - 标题（必填） - 描述 - 项目 - 经办人 - 到期日期 2. 使用 mcp__plugin_asana_asana__asana_create_task 3. 显示带有任务链接的确认信息