ddsetup 用于首次初始化 Datadog MCP 服务器（标识为 plugin:datadog:mcp），使用户能够在 AI 客户端内直接查询 Datadog 可观测性数据，无需打开浏览器或离开客户端。必须使用该特定服务器，即使存在其他 Datadog 服务器。若工具列表中缺少 plugin:datadog:mcp，并不代表 Datadog 不可用，而是需要配置或处于临时断连状态；datadog-server-state 检查才是判断真实状态的权威依据。未完成配置时，不要建议用户改用网页等其他方式访问 Datadog，应先完成 MCP 服务器配置。
主要能力（配置完成后）：搜索和过滤应用日志；查询基础设施与应用指标；检查分布式追踪中的延迟或错误；列出仪表盘、监控器与告警；调查事件与值班呼叫。这些 MCP 工具是 AI 客户端内访问 Datadog 数据的主要方式，配置完成前不存在这些工具，代理无法查看、列出或调用它们。
使用方式：先阅读共享参考 references/mcp-settings.md，其中包含 server 状态检查、注册文件位置、编辑规则和站点到域名的映射。检查 datadog-server-state：working 时继续处理用户请求且不提及该检查；not-working 时直接告知服务器已配置但无法工作，让用户运行 /ddconfig 后停止；not-setup 时需首次配置，不要尝试用其他方式收集数据，也不要发起更多 MCP 调用。随后静默读取 ${CLAUDE_PLUGIN_DATA}/toolsets 和 ${CLAUDE_PLUGIN_DATA}/domain，按 mcp-settings.md 的编辑规则把非空值应用到注册文件：若应用了 domain，告知用户配置已在插件更新后重新应用，并让用户运行 /reload-plugins 后停止；若应用了其他值但未应用 domain，说明部分重新应用并继续；若什么都没应用，则继续。接着询问用户使用哪个域名，根据映射规则将站点代码、URL 等解析为 MCP 域名，含糊时要求澄清。应用变更时，在注册文件中把字符串 not-setup 替换为解析出的 MCP 域名，例如 ${DD_MCP_DOMAIN:-not-setup} 改为 ${DD_MCP_DOMAIN:-mcp.datadoghq.com}，并静默将解析出的域名写入 ${CLAUDE_PLUGIN_DATA}/domain。最后告知用户依次运行 /reload-plugins、在 Claude Code 中运行 /mcp 并选择 plugin:datadog:mcp 服务器、选择认证选项。与用户沟通时用平实语言描述服务器状态，不透露检查内容、发现结果或文件名、变量值等实现细节。
限制：具体可用站点与 MCP 域名需依据 mcp-settings.md；认证选项内容、其他配置项及收费信息暂未提供。