用 Sent MCP 工具管理联系人时，如何安全地查询…

当需要通过 Sent MCP 工具搜索、查看、批量导入或删除联系人时，按确认门控流程安全操作。

适用场景

解决思路

1. 使用客户端管理的 OAuth 2.1/PKCE 建立连接；绝不请求或暴露 token、API key、authorization header、client ID 或 secret。
2. 在执行任何变更操作前，从连接上下文中展示当前组织和 Sender Profile；若任一不可用，使用 `sent-account-readiness` 检查授权范围；如需更改范围，在客户端中重新授权。
3. 尽量对电话号码做掩码处理；只返回任务所需的联系人字段，联系人数据审核后不要重复展示；号码存在或消息历史不代表已获得同意。
4. 读取联系人：用 `contacts.list` 搜索或分页浏览联系人，应用最窄的可用过滤条件，不要不必要地导出整个通讯录。
5. 读取联系人：当已知确切联系人标识符时，或在删除前，使用 `contacts.get`。
6. 读取联系人：用 `contacts.message_summary` 获取联系人的消息摘要；区分摘要数据与同意证明或当前可达性。
7. 只读调用不需要变更确认。
8. 批量创建联系人：在本地验证并去重拟创建的记录，只保留用户实际提供的字段。
9. 批量创建联系人：在不调用工具的情况下构建精确的 `contacts.create_many` 参数。
10. 批量创建联系人：展示 payload 预览，包含所选组织、Sender Profile、记录数量、重复处理方式以及每个精确目标；在操作员仍可验证的前提下对电话号码做掩码，仅在需要精确验证时一次性展示完整值。
11. 批量创建联系人：针对这一精确批次请求明确确认；之前或笼统的批准不充分。
12. 批量创建联系人：确认后立即调用 `contacts.create_many`；对记录或范围的任何更改都会使确认失效。
13. 批量创建联系人：绝不在没有预览和调用前立即明确确认的情况下调用 `contacts.create_many`；每次重试都视为新的变更，需要新的预览和新的明确确认。
14. 删除联系人：将请求的联系人解析为唯一明确的标识符。
15. 删除联系人：先用 `contacts.get` 获取精确目标；绝不基于猜测的标识符、宽泛过滤或过期的列表结果进行删除。
16. 删除联系人：展示删除预览，包含所选组织、Sender Profile、精确联系人标识符、显示标签和掩码地址；说明删除是破坏性操作。
17. 删除联系人：请求明确确认删除该精确目标。
18. 删除联系人：确认后立即调用 `contacts.delete`；若目标、范围或记录发生变化，重新获取并重复预览。
19. 删除联系人：绝不在未获取目标并在调用前立即获得明确确认的情况下调用 `contacts.delete`；每次重试都需要重新获取、新的预览和新的明确确认。
20. 报告结果：报告数量和稳定标识符，而非完整联系人记录；若创建或删除结果不明确，不要假设成功，也不要自动重试；尽可能重新读取精确目标，说明不确定性，并在任何进一步变更前要求新的确认。

适用边界 · 注意事项

• 没有客户端管理的 OAuth 2.1/PKCE 授权连接或无法展示组织和 Sender Profile 时。
• 无法在变更前获得针对精确批次的明确确认时。
• 需要绕过掩码或暴露 token、API key、secret 等敏感凭据时。