carto-manage-platform

carto-manage-platform

组织级运维：管理用户和邀请、监控配额、审计活动，以及由超级管理员对资源执行批量操作。其中大多数操作需要管理员或超级管理员角色；非管理员用户会看到权限错误。

访问路径路由。 将 CARTO MCP 服务通过 OAuth 接入后，交互式单项管理操作应路由到 MCP：manage_users（列出／邀请／更改角色／删除并移交）、manage_api_access_tokens、manage_oauth_clients、manage_connections、organize_projects、admin_carto / admin_carto_customizations（组织配置 + 统计数据）、export_activity_data、superadmin_carto_resources（跨用户资源列表），以及用于删除单个资源的 delete（kind: map|workflow|connection|token|oauth_client|project_item）。这些管理工具在使用令牌身份验证的 MCP 会话中不可见（仅提供读取／发现功能）——请通过 OAuth 重新连接，或改用 CLI。仍使用 CLI 的操作： 批量／脚本化删除（admin batch-delete）、所有权转移（admin transfer），以及对导出的活动数据进行本地 DuckDB 分析。检测信号：carto-basics/references/access-paths.md。

何时使用此技能

• 添加或移除团队成员。
• 审计操作记录（安全审查、排查意外变更）。
• 监控 API 和 LDS 配额用量。
• 用户离开后，将无人认领资源的所有权转移给他人。
• 批量删除测试资源。

若要交互式地查询活动数据（探索性分析），请使用 carto-query-datawarehouse/references/activity-queries.md。此技能用于处理活动数据相关的运维／管理任务。

快速参考

交互式单项管理（通过 OAuth 使用 MCP）：manage_users、manage_api_access_tokens、manage_oauth_clients、manage_connections、admin_carto、delete。以下所有操作均由 CLI 支持；在令牌会话或无头／脚本化运行时，可使用 CLI 作为备用方案。

# Org overview (users, resources, quotas, AI limits)
carto org stats

# User management
carto users list --all --json
carto users invite [email protected] --role Builder
carto users get [email protected]

# Activity audit (Enterprise Large+)
carto activity export \
  --start-date 2026-04-01 --end-date 2026-04-28 \
  --output-dir ./apr-2026

# Superadmin bulk (CLI-only)
carto admin list maps --all
carto admin batch-delete
carto admin transfer

此技能包含的内容

主题	参考文档
org stats 和配额监控	references/org-and-quotas.md
users 生命周期：列出、邀请、更改角色、删除并移交	references/users-and-invites.md
admin 超级管理员操作：批量列出、批量删除、资源转移	references/admin-bulk-ops.md
AI 提供商（BYOK 模型）：通过 admin settings / admin_carto 添加、验证、停用	references/ai-providers.md
活动事件类型目录（150 多种事件；完整参考）	references/activity-event-reference.md
高级活动分析（成功率、趋势、按类别分析）	references/advanced-analyses.md
活动数据故障排查（DuckDB 安装、套餐限制、TLS）	references/activity-troubleshooting.md

常驻指南

• 删除用户时必须指定接收者来继承其资源（地图、工作流、连接）——CARTO 不会让这些资源无人管理。先规划移交，再使用 manage_users（MCP）或 carto users delete <departing-user> <receiving-user>。请传入有效的邮箱/ID；先通过 manage_users / users get 检查，否则删除会因“permission denied”而失败。
• 活动导出受套餐限制，仅 Enterprise Large 及以上套餐支持。较低套餐会返回 403（MCP export_activity_data）或错误（CLI）；请礼貌说明，不要尝试绕过限制。
• org stats / admin_carto 显示的是你能看到的内容——AI 限额和账单信息仅对 Admin/Superadmin 显示。字段缺失不代表资源不存在。
• 批量删除不可撤销。 admin batch-delete 会删除列出的 ID，不会逐项确认——请核对列表，或先使用 admin list 进行试运行。
• 审计跟踪来自 activity 事件，而非工具返回值。要回答“谁删除了地图 X”，请查询 MapDeleted 事件——参见 activity 参考资料。