用途：这是使用其他 CARTO 技能前应先阅读的入门技能，帮助判断并路由到 CARTO 的两条并行访问路径。
主要能力：CARTO MCP Server 是对话式智能体宿主（Claude.ai、Claude Desktop、ChatGPT 等 MCP 客户端）中的主路径，提供数据探索、创建与编辑 Builder 地图、编写与运行 Workflows、执行 SQL、导入导出及组织管理等整合工具面，并在支持 MCP Apps 的宿主内联渲染地图，还会把用户已发布的 Workflows 动态注册为 MCP 工具。CARTO CLI（@carto/carto-cli）用于脚本、CI/CD、无头环境、批量与跨组织操作、更深入的管理与审计（如对使用日志执行 SQL），命令面最完整，也是 MCP 未接入时的回退路径。
使用方式：CLI 操作前先做预检。运行 carto --version 检查是否安装，未安装则自行安装并告知用户；运行 carto auth status 检查认证，未认证时使用无头流程 carto auth login --no-launch-browser，不要打开或等待浏览器，也不要改用 M2M/API token。需要机器可读输出时始终加 --json。地图 URL 使用 auth status 中的租户域名：私有地图为 https://{tenant_domain}/builder/{map_id}，公开或共享地图为 https://{tenant_domain}/map/{map_id}，不要构造 workspace-{region}.app.carto.com。破坏性命令（如 maps delete）需输入 delete 确认，非交互场景传 --yes 或 --json。import 与 sql 作业默认轮询至完成，可用 --async 立即返回后另行轮询。
适用场景：新机器首次配置 CLI、认证报错或令牌过期、切换组织或环境，以及下游技能需要 --profile、--json、--token、--base-url 时。
限制：若安装或认证无法完成，应说明并停止，不要静默回退到 Python、SQL、deck.gl 等非 CARTO 工具。临时沙箱（如 Claude Code Cowork 任务）会在任务间清除 CLI，而 MCP 服务器在账户级持久存在。具体安装命令与 EACCES 回退细节见 references/installation.md，认证、配置、全局参数与路由表分别见对应参考文档。