容器服务使用 Agent / TCCLI 管理容器服务（TKE

本文介绍如何在不依赖控制台逐步点击的情况下，使用腾讯云命令行工具（TCCLI）以及支持 MCP 的 AI Agent（如 Claude Code、Cursor、Codex、VS Code 等）查询与执行容器服务（TKE）相关操作。
若您只需要通过控制台创建和管理集群，请参见 快速创建一个标准集群。
适用场景
在以下场景中，建议使用本文路径：
需要用命令行批量查询、创建或变更 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
拉取单页原文
示例：
# 拉取首页 Markdown
curl -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 文档站  
﻿联系我们﻿
﻿

使用 Agent / TCCLI 管理容器服务（TKE）

本页目录：

适用场景

能力边界

准备工作

方式一：MCP 接入 AI Agent（推荐）

MCP 地址

MCP 可提供的能力

在 Claude Code 中接入

在 Cursor 中接入

在 Codex 中接入

在 VS Code 中接入

接入后如何验证

方式二：供自定义 Agent / 自动化系统消费

使用建议与注意事项

反馈与支持

相关文档

您要做什么	阅读哪里
理解产品概念、计费、控制台操作	容器服务产品文档
查阅 API 入参、出参与错误码	容器服务 API 文档
安装、配置通用 TCCLI	腾讯云命令行工具
获取可复制的 `tccli tke` / `tccli tcr` 操作步骤	TCCLI Agent 文档站（下文简称 “Agent 文档”）

能力	说明
搜索文档	按关键词检索 TKE / TCR 的 TCCLI 操作说明。
读取页面	按 URL 获取完整 Markdown 页面。
智能问答	用自然语言提问，返回带出处的答案。

入口	地址	用途
站点索引	https://tccli-agent.gitbook.io/tccli/llms.txt	获取全站页面清单
全量快照	https://tccli-agent.gitbook.io/tccli/llms-full.txt	获取已发布文档的 Markdown 汇总
单页 Markdown	任意文档页 URL 末尾增加 `.md`	拉取单页原文

问题类型	建议反馈渠道
Agent 文档中的命令过时、字段错误、步骤缺失	让 Agent 按照 skill 中的 Issues Schema 对仓库进行反馈。
产品功能、控制台行为、计费与 SLA	本页底部“文档是否有帮助/我的反馈”，或联系我们。
TCCLI 通用安装与配置问题	腾讯云命令行工具文档与对应反馈入口。