信息征集 - MCP 中文文档

模型上下文协议（MCP）为服务器提供了一种标准化方式，使其能够在交互过程中通过客户端向用户请求额外信息。此流程使客户端能够在保持对用户交互和数据共享控制的同时，让服务器动态地收集所需信息。信息征集支持两种模式：

表单模式：服务器可以使用可选的 JSON Schema 向用户请求结构化数据以验证响应
URL 模式：服务器可以将用户引导至外部 URL 进行敏感交互，这些交互不得通过 MCP 客户端传递

用户交互模型

MCP 中的信息征集允许服务器通过启用用户输入请求嵌套在其他 MCP 服务器功能内来实现交互式工作流。实现可以自由暴露信息征集通过任何适合其需求的界面模式——协议本身不强制任何特定的用户交互模型。

为了信任、安全和安全性：

服务器不得使用表单模式信息征集来请求敏感信息，例如密码、API 密钥、访问令牌或支付凭证
服务器必须使用 URL 模式进行涉及此类敏感信息的交互

此上下文中的“敏感信息”指的是授予访问权限或授权交易的秘密和凭证。一般联系或个人资料信息（例如姓名、电子邮件地址或用户名）并非明确禁止；是否通过表单模式请求此类数据由服务器自行决定，并取决于用户审查和拒绝的能力。MCP 客户端必须：

提供 UI 以明确哪个服务器正在请求信息
尊重用户隐私并提供明确的拒绝和取消选项
对于表单模式，允许用户在发送前审查和修改其响应
对于 URL 模式，清晰显示目标域名/主机并在导航到目标 URL 之前获取用户同意

请求关联要求服务器必须仅在关联原始客户端请求时发送服务器到客户端的请求（例如 roots/list、sampling/createMessage 或 elicitation/create）（例如，在 tools/call、resources/read 或 prompts/get 处理期间）。不支持在独立通信流上（与任何客户端请求无关）独立发起的此类类型的服务器请求，并且不得实现。未来的传输实现不需要支持此模式。

能力

支持信息征集的客户端必须在每次请求中于 _meta.io.modelcontextprotocol/clientCapabilities 声明 elicitation 能力：

{
  "capabilities": {
    "elicitation": {
      "form": {},
      "url": {}
    }
  }
}

为了向后兼容，空能力对象等同于仅声明支持 form 模式：

{
  "capabilities": {
    "elicitation": {}, // 等同于 { "form": {} }
  },
}

声明 elicitation 能力的客户端必须支持至少一种模式（form 或 url）。服务器不得发送客户端不支持的模式的信息征集请求。

协议消息

信息征集请求

服务器可以在处理客户端请求期间，通过发送包含 elicitation/create 请求的 InputRequiredResult 来向用户请求信息。所有信息征集请求必须包含以下参数：

名称	类型	选项	描述
`mode`	string	`form`, `url`	信息征集的模式。对于表单模式为可选（如果省略则默认为 `"form"`）。
`message`	string		人类可读的消息，解释为什么需要此交互。

mode 参数指定信息征集的类型：

"form"：带内结构化数据收集，带有可选的 Schema 验证。数据暴露给客户端。
"url"：通过 URL 导航的带外交互。数据（URL 本身除外）不暴露给客户端。

为了向后兼容，服务器可以省略表单模式信息征集请求的 mode 字段。客户端必须将没有 mode 字段的请求视为表单模式。

表单模式信息征集请求

表单模式信息征集允许服务器通过 MCP 客户端直接收集结构化数据。表单模式信息征集请求必须指定 mode: "form" 或省略 mode 字段，并包含这些附加参数：

名称	类型	描述
`requestedSchema`	object	定义预期响应结构的 JSON Schema。

请求的 Schema

requestedSchema 参数允许服务器使用 JSON Schema 的受限子集来定义预期响应的结构。为了简化客户端用户体验，表单模式信息征集 Schema 仅限于具有原始属性的扁平对象。 Schema 仅限于这些原始类型：

字符串 Schema

{
  "type": "string",
  "title": "显示名称",
  "description": "描述文本",
  "minLength": 3,
  "maxLength": 50,
  "pattern": "^[A-Za-z]+$",
  "format": "email",
  "default": "user@example.com"
}

支持的格式：email, uri, date, date-time

数字 Schema

{
  "type": "number", // 或 "integer"
  "title": "显示名称",
  "description": "描述文本",
  "minimum": 0,
  "maximum": 100,
  "default": 50
}

布尔值 Schema

{
  "type": "boolean",
  "title": "显示名称",
  "description": "描述文本",
  "default": false
}

枚举 Schema 单选枚举（无标题）：

{
  "type": "string",
  "title": "颜色选择",
  "description": "选择您最喜欢的颜色",
  "enum": ["Red", "Green", "Blue"],
  "default": "Red"
}

单选枚举（带标题）：

{
  "type": "string",
  "title": "颜色选择",
  "description": "选择您最喜欢的颜色",
  "oneOf": [
    { "const": "#FF0000", "title": "红色" },
    { "const": "#00FF00", "title": "绿色" },
    { "const": "#0000FF", "title": "蓝色" }
  ],
  "default": "#FF0000"
}

多选枚举（无标题）：

{
  "type": "array",
  "title": "颜色选择",
  "description": "选择您最喜欢的颜色",
  "minItems": 1,
  "maxItems": 2,
  "items": {
    "type": "string",
    "enum": ["Red", "Green", "Blue"]
  },
  "default": ["Red", "Green"]
}

多选枚举（带标题）：

{
  "type": "array",
  "title": "颜色选择",
  "description": "选择您最喜欢的颜色",
  "minItems": 1,
  "maxItems": 2,
  "items": {
    "anyOf": [
      { "const": "#FF0000", "title": "红色" },
      { "const": "#00FF00", "title": "绿色" },
      { "const": "#0000FF", "title": "蓝色" }
    ]
  },
  "default": ["#FF0000", "#00FF00"]
}

客户端可以使用此 Schema 来：

生成适当的输入表单
在发送前验证用户输入
为用户提供更好的指导

所有原始类型都支持可选的默认值以提供合理的起点。支持默认值的客户端 SHOULD 使用这些值预填充表单字段。请注意，复杂的嵌套结构、对象数组（枚举除外）和其他高级 JSON Schema 功能故意不支持，以简化客户端用户体验。

示例：简单文本请求

请求：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "elicitation/create",
  "params": {
    "mode": "form",
    "message": "请提供您的 GitHub 用户名",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        }
      },
      "required": ["name"]
    }
  }
}

响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "action": "accept",
    "content": {
      "name": "octocat"
    }
  }
}

示例：结构化数据请求

请求：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "elicitation/create",
  "params": {
    "mode": "form",
    "message": "请提供您的联系信息",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "您的全名"
        },
        "email": {
          "type": "string",
          "format": "email",
          "description": "您的电子邮件地址"
        },
        "age": {
          "type": "number",
          "minimum": 18,
          "description": "您的年龄"
        }
      },
      "required": ["name", "email"]
    }
  }
}

响应：

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "action": "accept",
    "content": {
      "name": "Monalisa Octocat",
      "email": "octocat@github.com",
      "age": 30
    }
  }
}

URL 模式信息征集请求

新功能： URL 模式信息征集是在 2025-11-25 版本的 MCP 规范中引入的。其设计和实现可能会在未来的协议修订中更改。

URL 模式信息征集使服务器能够将用户引导至外部 URL 进行不得通过 MCP 客户端传递的带外交互。这对于认证流程、支付处理以及其他敏感或安全操作至关重要。 URL 模式信息征集请求必须指定 mode: "url"，message，并包含这些附加参数：

名称	类型	描述
`url`	string	用户应该导航到的 URL。
`elicitationId`	string	信息征集的唯一标识符。

url 参数必须包含有效的 URL。

重要：URL 模式信息征集不是用于授权 MCP 客户端访问 MCP 服务器（那由 MCP 授权处理）。相反，当 MCP 服务器需要代表用户获取敏感信息或第三方授权时使用它。客户端的持有者令牌保持不变。客户端的唯一责任是为用户提供关于服务器希望他们打开的信息征集 URL 的上下文。

示例：请求敏感数据

此示例显示了一个 URL 模式信息征集请求，将用户引导至一个安全 URL，他们可以在那里提供敏感信息（例如 API 密钥）。相同的请求可以将用户引导至 OAuth 授权流程或支付流程。唯一的区别是 URL 和消息。 请求：

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "elicitation/create",
  "params": {
    "mode": "url",
    "elicitationId": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://mcp.example.com/ui/set_api_key",
    "message": "请提供您的 API 密钥以继续。"
  }
}

响应：

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "action": "accept"
  }
}

带有 action: "accept" 的响应表示用户已同意该交互。这并不意味着交互已完成。交互发生在带外，客户端不知道结果，直到服务器发送指示完成的通知。

URL 模式信息征集的完成通知

当由 URL 模式信息征集启动的带外交互完成时，服务器可以发送 notifications/elicitation/complete 通知。这允许客户端在适当时以编程方式反应。发送通知的服务器：

必须仅将通知发送给发起信息征集请求的客户端。
必须包含原始 elicitation/create 请求中建立的 elicitationId。

客户端：

必须忽略引用未知或已完成 ID 的通知。
可以等待此通知以自动重试收到 URLElicitationRequiredError 的请求，更新用户界面，或以其他方式继续交互。
应该仍然提供手动控制，让用户重试或取消原始请求（或以其他方式恢复与客户端的交互），如果通知从未到达。

示例

{
  "jsonrpc": "2.0",
  "method": "notifications/elicitation/complete",
  "params": {
    "elicitationId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

消息流程

表单模式流程

URL 模式流程

响应操作

信息收集响应使用三操作模型来清楚地区分不同的用户操作。这些操作适用于表单和 URL 信息收集模式。

"result": {
  "action": "accept", // 或 "decline" 或 "cancel"
  "content": {
    "propertyName": "value",
    "anotherProperty": 42
  }
}

三种响应操作是：

接受 (action: "accept"): 用户明确批准并提交数据
- 对于表单模式：content 字段包含与请求模式匹配的提交数据
- 对于 URL 模式：content 字段被省略
- 示例：用户点击了“提交”、“确定”、“确认”等。
拒绝 (action: "decline"): 用户明确拒绝请求
- content 字段通常被省略
- 示例：用户点击了“拒绝”、“谢绝”、“否”等。
取消 (action: "cancel"): 用户解散而未做出明确选择
- content 字段通常被省略
- 示例：用户关闭了对话框、点击了外部、按了 Escape 键、浏览器加载失败等。

服务器应适当处理每种状态：

接受：处理提交的数据
拒绝：处理明确拒绝（例如，提供替代方案）
取消：处理解散（例如，稍后再次提示）

实现注意事项

状态性

Elicitations 不要求服务器使用 multi round-trip requests 机制维护有关用户的状态。然而，如果存储了状态，实现 elicitation 的服务器必须按照 security best practices 文档中的指南，将此状态与单个用户安全关联。具体而言：

状态存储必须防止未经授权的访问
对于远程 MCP 服务器，用户身份必须尽可能从通过 MCP 授权获取的凭证中派生（例如 sub 声明）

本节中的示例是非规范性的，并说明了信息收集的潜在用途。实现者应在保持安全最佳实践的同时，将这些模式适应其特定需求。

用于敏感数据的 URL 模式信息收集

对于与需要敏感信息的外部 API 交互的服务器（例如，凭证、支付信息），URL 模式信息收集提供了一种安全机制，让用户提供此信息而不将其暴露给 MCP 客户端。在此模式中：

服务器将用户引导至安全网页（通过 HTTPS 服务）
页面在用户信任的域上展示品牌化的表单界面
用户直接将敏感凭证输入到安全表单中
服务器安全地存储凭证，绑定到用户身份
后续的 MCP 请求使用这些存储的凭证进行 API 访问

这种方法确保敏感凭证永远不会通过 LLM 上下文、MCP 客户端或任何中间 MCP 服务器，减少通过客户端日志记录或其他攻击向量暴露的风险。

用于 OAuth 流程的 URL 模式信息收集

URL 模式信息收集启用了一种模式，其中 MCP 服务器充当第三方资源服务器的 OAuth 客户端。通过 URL 模式信息收集启用的外部 API 授权与 MCP 授权是分开的。MCP 服务器不得依赖 URL 模式信息收集来为用户授权自身。

理解区别

MCP 授权：MCP 客户端和 MCP 服务器之间所需的 OAuth 流程（在授权规范中涵盖）
外部（第三方）授权：MCP 服务器和第三方资源服务器之间的可选授权，通过 URL 模式信息收集发起

在外部授权中，服务器同时充当：

OAuth 资源服务器（对于 MCP 客户端）
OAuth 客户端（对于第三方资源服务器）

示例场景：

MCP 客户端连接到 MCP 服务器
MCP 服务器集成各种不同的第三方服务
当 MCP 客户端调用需要访问第三方服务的工具时，MCP 服务器需要该服务的凭证

关键安全要求是：

第三方凭证不得通过 MCP 客户端传输：客户端绝不能看到第三方凭证以保护安全边界
MCP 服务器不得将客户端的凭证用于第三方服务：那将是令牌透传，这是禁止的
用户必须直接授权 MCP 服务器：交互发生在 MCP 协议之外，不涉及 MCP 客户端
MCP 服务器负责令牌：MCP 服务器负责存储和管理通过 URL 模式信息收集获得的第三方令牌（换句话说，MCP 服务器必须是有状态的）。

通过 URL 模式信息收集获得的凭证不同于 MCP 客户端使用的 MCP 服务器凭证。MCP 服务器不得将通过 URL 模式信息收集获得的凭证传输给 MCP 客户端。

有关更多背景信息，请参阅安全最佳实践文档的令牌透传部分以了解为什么 MCP 服务器不能充当透传代理。

实现模式

当通过 URL 模式信息收集实现外部授权时：

MCP 服务器生成一个授权 URL，充当第三方服务的 OAuth 客户端
MCP 服务器存储内部状态，将 elicitation 请求与用户身份关联（绑定）
MCP 服务器向客户端发送一个 URL 模式 elicitation 请求，其中包含可启动授权流程的 URL，以及一个可选的 requestState，用于编码关于 elicitation 请求和用户的信息（如有需要）
用户直接与第三方授权服务器完成 OAuth 流程
第三方授权服务器重定向回 MCP 服务器
MCP 服务器安全地存储第三方令牌，并将其绑定到用户身份
未来的 MCP 请求可以利用这些已存储的令牌访问第三方资源服务器

以下是如何实现此模式的非规范性示例：此模式在保持清晰安全边界的同时，启用了与需要用户授权的第三方服务的丰富集成。

错误处理

Servers SHOULD NOT 假设 elicitation 请求总是会成功，并且 MUST 处理用户拒绝或取消 elicitation，或客户端无法处理请求的情况。

安全考虑

Servers MUST 将 elicitation 请求绑定到客户端和用户身份
Clients MUST 明确指示哪个服务器正在请求信息
Clients SHOULD 实现用户批准控制
Clients SHOULD 允许用户随时拒绝 elicitation 请求
Clients SHOULD 以清楚说明所请求信息及其原因的方式呈现 elicitation 请求

安全 URL 处理

请求诱导的 MCP 服务器：

MUST NOT 在发送给客户端的 URL elicitation 请求中的 URL 里包含关于最终用户的敏感信息，包括凭证、个人可识别信息等。
MUST NOT 提供一个已预先认证、可访问受保护资源的 URL，因为恶意客户端可能使用该 URL 冒充用户。
SHOULD NOT 在表单模式 elicitation 请求的任何字段中包含旨在可点击的 URL。
SHOULD 在非开发环境中使用 HTTPS URL。

这些服务器要求确保客户端实现有关于何时向用户展示 URL 的明确规则，以便一致地应用客户端规则（如下所述）。实现 URL 模式诱导的客户端必须小心处理 URL，以防止用户在不知情的情况下点击恶意链接。处理 URL 模式诱导请求时，MCP 客户端：

不得自动预取 URL 或其任何元数据。
不得在未经用户明确同意的情况下打开 URL。
必须在同意前向用户显示完整 URL 以供检查。
必须以安全的方式打开服务器提供的 URL，使得客户端或 LLM 无法检查内容或用户输入。例如，在 iOS 上，SFSafariViewController 是合适的，但 WkWebView 不合适。
应当突出显示 URL 的域名以减轻子域名欺骗。
应当对模糊/可疑的 URI（即包含 Punycode 的）发出警告。
不应当 在诱导请求的任何字段中将 URL 渲染为可点击，除非是 URL 诱导请求中的 url 字段（受上述限制约束）。

识别用户

服务器不得依赖未经服务器验证的客户端提供的用户身份识别，因为这可能被伪造。相反，服务器应当遵循安全最佳实践。非规范性示例：

错误：将用户输入（如 “I am joe@example.com”）视为权威
正确：依赖授权来识别用户

表单模式安全

服务器不得通过表单模式请求敏感信息（密码、API 密钥等）
客户端应当针对提供的模式验证所有响应
服务器应当验证接收到的数据是否符合请求的模式

网络钓鱼

URL 模式诱导返回一个攻击者可用于发送给受害者的 URL。MCP 服务器必须在接受信息之前验证打开 URL 的用户身份。通常身份验证是通过利用 MCP 授权服务器来识别用户，通过浏览器中的会话 cookie 或等效机制完成。例如，URL 模式诱导可用于执行 OAuth 流程，其中服务器充当另一个资源服务器的 OAuth 客户端。如果没有适当的缓解措施，可能发生以下网络钓鱼攻击：

连接到良性服务器的恶意用户（Alice）触发诱导请求
良性服务器生成授权 URL，充当第三方授权服务器的 OAuth 客户端
Alice 的客户端显示 URL 并请求同意
Alice 没有点击链接，而是诱骗同一良性服务器的受害用户（Bob）点击它
Bob 打开链接并完成授权，认为他们正在授权自己与良性服务器的连接
良性服务器收到来自第三方授权服务器的回调/重定向，并假设这是 Alice 的请求
第三方服务器的令牌绑定到 Alice 的会话和身份，而不是 Bob 的，导致账户接管

为了防止此攻击，服务器必须确保启动诱导请求的用户（通过 MCP 客户端访问服务器的最终用户）与完成授权流程的用户是同一人。有很多方法可以实现这一点，最佳方法将取决于具体实现。作为一个常见的非规范性示例，考虑 MCP 服务器可通过 Web 访问并希望执行第三方授权码流程的情况。为防止网络钓鱼攻击，服务器会创建一个 URL 模式 elicitation，指向 https://mcp.example.com/connect?elicitationId=...，而不是第三方授权端点。此“connect URL”必须确保打开页面的用户与生成该 elicitation 的用户是同一人。例如，它会检查用户是否具有有效的会话 cookie，以及该会话 cookie 是否属于用于生成 URL 模式 elicitation 的同一用户。这可以通过将 MCP 服务器授权服务器中的权威主体（sub 声明）与会话 cookie 中的主体进行比较来完成。一旦该页面确认是同一用户，它就可以将用户送往第三方授权服务器 https://example.com/authorize?...，在那里可以完成正常的 OAuth 流程。在其他情况下，服务器可能无法通过 Web 访问，也可能无法使用会话 cookie 来识别用户。在这种情况下，服务器必须使用不同的机制来识别打开 elicitation URL 的用户与生成该 elicitation 的用户是同一人。在所有实现中，服务器必须确保确定用户身份的机制能够抵御攻击者可以修改诱导 URL 的攻击。

Documentation Index

​用户交互模型

​能力

​协议消息

​信息征集请求

​表单模式信息征集请求

​请求的 Schema

​示例：简单文本请求

​示例：结构化数据请求

​URL 模式信息征集请求

​示例：请求敏感数据

​URL 模式信息征集的完成通知

​示例

​消息流程

​表单模式流程

​URL 模式流程

​响应操作

​实现注意事项

​状态性

​用于敏感数据的 URL 模式信息收集

​用于 OAuth 流程的 URL 模式信息收集

​理解区别

​实现模式

​错误处理

​安全考虑

​安全 URL 处理

​识别用户

​表单模式安全

​网络钓鱼

用户交互模型

能力

协议消息

信息征集请求

表单模式信息征集请求

请求的 Schema

示例：简单文本请求

示例：结构化数据请求

URL 模式信息征集请求

示例：请求敏感数据

URL 模式信息征集的完成通知

示例

消息流程

表单模式流程

URL 模式流程

响应操作

实现注意事项

状态性

用于敏感数据的 URL 模式信息收集

用于 OAuth 流程的 URL 模式信息收集

理解区别

实现模式

错误处理

安全考虑

安全 URL 处理

识别用户

表单模式安全

网络钓鱼