一、为什么需要了解工具注释
在 添加 MCP Server 和 工具搜索 中，Claude 对不同工具的调用方式有明显差异——某些工具直接执行，另一些每次都要求权限确认。
这种差异的来源之一是工具注释（Tool Annotations）。MCP Server 作者在注册工具时附加一组元数据，声明工具是只读还是会修改数据、操作是否可逆、是否涉及外部网络。
Claude 读取这些声明后调整自身行为。
二、工具注释的工作方式
5 个注解属性
MCP 协议（2025-03-26 版本引入）定义了 5 个注解属性：
title 是字符串类型，影响 UI 显示但不影响 Claude 的调用决策。后四个 hint 是布尔值，直接影响 Claude 的行为。
默认值与保守假设
四个 hint 的默认值遵循同一设计原则——保守假设。当 MCP Server 未提供注释时，Claude 按最安全的方式处理：