用途：引导完成该插件内置 ClickHouse Cloud Remote MCP 服务器（https://mcp.clickhouse.cloud/mcp）的连接配置，提供对 ClickHouse Cloud 集群的安全只读访问。
主要能力：服务器提供组织与服务管理（get_organizations、get_organization_details、get_services_list、get_service_details）、数据库探索（list_databases、list_tables 支持 like/notLike 过滤、run_select_query）、ClickPipes（list_clickpipes、get_clickpipe）、备份（list_service_backups、get_service_backup_details、get_service_backup_configuration）、计费（get_organization_cost，最大 31 天窗口）。所有工具均为只读。插件还包含 clickhouse-best-practices 技能，含 28 条规则，覆盖模式设计、查询优化与插入策略，处理 ClickHouse 时自动激活，无需配置。
使用方式：先确认 ClickHouse MCP 服务器出现在可用工具中；通过 OAuth 使用 ClickHouse Cloud 凭据认证，首次连接时按提示授权；随后尝试列出数据库或运行简单 SELECT 验证。
限制：Claude Code 对所有 MCP 工具调用强制 30 秒超时，用户与 MCP 服务器都无法更改；run_select_query 的 timeoutSeconds 参数（默认 300 秒，最大 3600 秒）也无法绕过该限制。建议保持查询简单快速、使用 LIMIT 限制结果集、优先查询物化视图或预聚合表，超时则拆分为更小的查询。服务器为远程 HTTP 端点，需要可访问对应地址的网络。
故障排查：服务器未出现时运行 /reload-plugins 重新加载插件 MCP 服务器；出现认证错误时按提示重新走 OAuth 流程；连接超时则确认网络可访问 https://mcp.clickhouse.cloud。