若你只需要通过控制台创建和管理集群，请参见 快速创建一个标准集群。
一、适用场景
在以下场景中，建议使用这篇路径：
·需要用命令行批量查询、创建或变更 TKE 资源，而不是在控制台逐项点击。
·需要让 AI Agent 根据文档生成可执行的 tccli 命令，并在你确认后执行。
·已熟悉 Kubernetes，希望用云厂商 CLI 完成集群、节点池、网络、凭证等云侧操作。
二、能力边界
| 你要做什么 | 阅读哪里 |
| 理解产品概念、计费、控制台操作 | 容器服务产品文档 |
| 查阅 API 入参、出参与错误码 | 容器服务 API 文档 |
| 安装、配置通用 TCCLI | 腾讯云命令行工具 |
| 获取可复制的 tccli tke / tccli tcr 操作步骤 | TCCLI Agent 文档站（下文简称 “Agent 文档”） |
说明：
·Agent 文档覆盖的是 TCCLI 可达的 TKE / TCR 操作，每条命令附带可验证的预期输出与常见故障处理思路。
·部分能力仅存在于控制台或独立产品面（例如部分可视化运维、部分计费运营能力），没有对应的 tccli 接口。此类能力请继续使用本产品文档与控制台，勿在 Agent 文档中查找对应命令。
·API 契约以本站 API 文档与线上接口为准；Agent 文档侧重可执行命令路径，二者互补，不互相替代。
三、准备工作
1. 已注册腾讯云账号并完成实名认证。
2. 已开通容器服务，并完成服务授权（若控制台首次进入时提示授权）。
3. 已准备具备所需权限的 CAM 密钥或角色（建议使用子用户 + 最小权限）。
4. 已在本地或 CI 环境安装 TCCLI，并完成凭证配置。安装与配置请参见 腾讯云命令行工具。
5. （可选）已安装支持 MCP 的 AI 编程助手或 Agent 运行时。
完成凭证配置后，可用下列命令做快速检查（将地域替换为你的实际地域）：
tccli tke DescribeClusters –region ap-guangzhou –Limit 1
·预期：返回 JSON，包含 TotalCount 与 Clusters 字段（TCCLI 默认会剥离外层 Response 包装）。
·若返回 AuthFailure：请先检查密钥、权限与默认地域配置，再继续后续步骤。
四、方式一：MCP 接入 AI Agent（推荐）
Agent 文档站点提供只读 MCP（Model Context Protocol）服务。将 MCP 接入 Agent 后，Agent 可检索文档、拉取整页内容、按自然语言提问，文档站页面菜单中提供 Connect with MCP。
五、MCP 地址
https://tccli-agent.gitbook.io/tccli/~gitbook/mcp
六、MCP 可提供的能力
| 能力 | 说明 |
| 搜索文档 | 按关键词检索 TKE / TCR 的 TCCLI 操作说明。 |
| 读取页面 | 按 URL 获取完整 Markdown 页面。 |
| 智能问答 | 用自然语言提问，返回带出处的答案。 |
注意：安全提示：MCP 服务仅用于读取文档，不会代替你调用腾讯云 API。执行 tccli 写操作（创建、删除、变更）仍须在你自己的终端或受控环境中进行，并使用你本人的凭证。请勿将密钥粘贴到不可信对话中。
七、在 Claude Code 中接入
claude mcp add –transport http tccli-agent-docs \\ https://tccli-agent.gitbook.io/tccli/~gitbook/mcp
接入后，在会话中执行 /mcp 确认连接状态，然后可让 Agent 列出工具并查询文档。
八、在 Cursor 中接入
在用户级或项目级 mcp.json 中增加：
{ "mcpServers": { "tccli-agent-docs": { "url": "https://tccli-agent.gitbook.io/tccli/~gitbook/mcp" } }}
保存后在 Cursor 的 MCP 设置中确认服务已启用。
九、在 Codex 中接入
codex mcp add tccli-agent-docs \\ https://tccli-agent.gitbook.io/tccli/~gitbook/mcp
十、在 VS Code 中接入
在 mcp.json 中配置：
{ "mcpServers": { "tccli-agent-docs": { "type": "http", "url": "https://tccli-agent.gitbook.io/tccli/~gitbook/mcp" } }}
十一、接入后如何验证
可向 Agent 发送如下提示词（仅查询，不执行写操作）：
请列出 tccli-agent-docs MCP 提供的工具。然后查询：如何使用 tccli 在 ap-guangzhou 创建一个托管集群？请只返回可复制命令与预期输出说明，不要执行任何会变更云资源的命令。
若工具列表可见，且回答中包含可定位的文档来源与 tccli 命令示例，则说明接入成功。
十二、方式二：供自定义 Agent / 自动化系统消费
若你自建 Agent 或知识库，可使用下列机器可读入口：
| 入口 | 地址 | 用途 |
| 站点索引 | https://tccli-agent.gitbook.io/tccli/llms.txt | 获取全站页面清单 |
| 全量快照 | https://tccli-agent.gitbook.io/tccli/llms-full.txt | 获取已发布文档的 Markdown 汇总 |
| 单页 Markdown | 任意文档页 URL 末尾增加 .md | 拉取单页原文 |
示例：
# 拉取首页 Markdowncurl -sL "https://tccli-agent.gitbook.io/tccli/zong-lan/readme.md"
注意：说明：
注意：具体页面路径以文档站目录为准；若路径调整，请以 llms.txt 中的链接为准。
十三、使用建议与注意事项
1. 先只读、后写入：建议 Agent 与脚本默认使用 Describe* / List* 类查询验证环境，确认地域与权限后再执行创建、删除等写操作。
2. 最小权限：为自动化与 Agent 使用的子用户配置完成任务所需的最小 CAM 策略，避免使用主账号密钥。
3. 确认目标资源：删除集群、缩容节点池等操作具有业务影响，执行前请二次确认集群 ID、地域与保护开关。
4. 版本与字段：TKE 存在多 API 版本差异时，以 Agent 文档中的版本说明与 tccli … help –detail 为准。
5. 费用：通过 CLI 或 Agent 创建的资源同样会产生费用，计费规则请参见本产品 购买指南。
十四、反馈与支持
| 问题类型 | 建议反馈渠道 |
| Agent 文档中的命令过时、字段错误、步骤缺失 | 让 Agent 按照 skill 中的 Issues Schema 对 仓库 进行反馈。 |
| 产品功能、控制台行为、计费与 SLA | 本页底部“文档是否有帮助/我的反馈”，或 联系我们。 |
| TCCLI 通用安装与配置问题 | 腾讯云命令行工具 文档与对应反馈入口。 |
如果你在使用过程中发现本页描述与线上产品不一致，请向仓库提交 ISSUES 告知我们，以便持续改进。
十五、相关文档
·快速创建一个标准集群
·容器服务 API 概览
·腾讯云命令行工具
·TCCLI Agent 文档站
·联系我们