Set up docs MCP前置条件
To successfully follow this guide, you’ll need the following:
- A running ClickHouse Cloud service. If you don’t have one yet, complete the ClickHouse Cloud quick start first.
你还应完成ClickHouse Cloud 快速入门，因为你需要一个现有的 ClickHouse Cloud 服务来获取连接信息。
你将完成的内容
在本快速入门中，你将学习如何找到 ClickHouse Cloud 服务的连接信息——也就是从任何外部客户端、命令行客户端工具或应用连接时所需的主机名、端口号、用户名和密码。
完成后，你将知道如何在 Cloud 控制台中找到这些信息，以及如何使用简单的 curl 命令验证连通性，从而可以通过 clickhouse-local、clickhouse-client 或任何 ClickHouse 驱动进行连接。
打开 Cloud 控制台
前往 ClickHouse Cloud 控制台 并登录你的账户。
在主仪表板中，找到你要连接的服务。如果该服务处于休眠状态，点击它并等待其唤醒后再继续——你需要让它保持运行，以便在后续步骤中验证连通性。
查找连接信息
点击你的服务以打开详情页，然后点击左侧边栏中的 Connect 按钮：
第一次点击此按钮时，你会看到一个显示凭据的对话框：
| 详细信息 | 说明 |
|---|---|
| Username | 你的用户名 (通常为 default) |
| Password | 为你的服务生成的密码 |
此外，还有一个下拉菜单，提供适用于不同协议和接口的预格式化示例连接字符串 (例如 clickhouse-client、HTTPS、JDBC 等) ，你可以直接复制。
你还可以在服务详情页找到服务的 主机名 (例如 abc123.us-east-1.aws.clickhouse.cloud) 。请将它与凭据一起保存——在后续步骤以及之后的快速入门中都会用到。
了解连接协议
ClickHouse Cloud 提供两种主要网络协议，每种协议各自使用一个端口：
- Native protocol (端口 9440) -
clickhouse-client、clickhouse-local以及大多数特定语言驱动使用的二进制协议。这是最快的选项，并支持所有 ClickHouse 功能。在 Cloud 上必须使用 TLS。 - HTTPS protocol (端口 8443) - 基于 HTTP 的接口，适用于 REST 客户端、
curl、基于 Web 的工具，以及偏好 HTTP 的驱动。在 Cloud 上同样需要 TLS。
连接到 ClickHouse Cloud 时，这两种协议都要求使用 TLS 加密——你不能通过明文连接。大多数工具在你指定正确端口时会自动处理这一点，但具体取决于客户端，你可能需要传递 --secure 标志或设置 ssl=true。
在本系列的大多数快速入门和命令行客户端工作流中，你将使用 9440 端口上的 native protocol。
保存连接信息以便重复使用
在各个快速入门中，你会频繁用到这些连接信息。为了避免每次都重新输入，你可以在终端会话中将它们导出为环境变量：
export CLICKHOUSE_HOST=YOUR_HOST.clickhouse.cloud
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=YOUR_PASSWORD将这些值替换为你的实际主机名、用户名和密码。
如果你要使用 clickhouse-client 或 clickhouse-local 连接到 Cloud 服务，请从 “Connect with:” 旁边的下拉菜单中选择 'Native' 以获取主机名。
复制显示的连接示例中 --host 后面的主机名。
后续步骤
现在，您已经具备了从任何外部工具连接到 ClickHouse Cloud 服务所需的全部连接信息。您在此处找到的主机名、端口、用户名 和 密码，将在本快速入门系列的后续内容中持续使用。
接下来可查看以下快速入门：
或者通过参考文档进一步深入了解：
