mcpField
C
carto-manage-platform

carto-manage-platform

github.com/cartodbクラウド・DevOps652 回インストール1 週間前に更新
リポジトリ

carto-manage-platform について

CARTOの組織をCLIと、条件を満たす対話セッションではCARTO MCPツールで管理するスキルです。ユーザーやリソースの操作、クォータ監視、アクティビティ監査を扱い、権限とアクセス経路の制約も示します。

主な機能

  1. 01ユーザーと招待の管理
  2. 02組織クォータの監視
  3. 03アクティビティイベントの監査
  4. 04スーパー管理者向け一括リソース操作
  5. 05アクティビティデータのエクスポート
  6. 06MCPとCLIの操作経路の選択

活用シーン

  1. 01チームメンバーの登録や削除
  2. 02セキュリティ調査での操作履歴の確認
  3. 03APIとLDSのクォータ使用量の確認
  4. 04リソースの移管や一括削除

MCP 対応

CARTO MCPサーバーをOAuthで接続すると、対応する単一項目の管理操作をMCPツールに振り分けます。トークン認証セッションでは利用可能な機能が限られるため、一括・スクリプト操作や代替経路にはCLIを使います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cartodb/agent-skills --skill carto-manage-platform

インストール後、Claude Code で/carto-manage-platformを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
activity-event-reference.md
activity-troubleshooting.md
admin-bulk-ops.md
advanced-analyses.md
ai-providers.md
org-and-quotas.md
users-and-invites.md

詳細

carto-manage-platform

組織レベルの運用：ユーザーや招待の管理、クォータの監視、アクティビティの監査、リソースに対するスーパーユーザーの一括操作。これらのほとんどには、管理者またはスーパーユーザーのロールが必要です。管理者以外のユーザーには、権限エラーが表示されます。

アクセス経路の振り分け。 OAuth 経由で CARTO MCP サーバーに接続している場合、対話的な単一項目の管理には 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 で実行でき、トークンセッションまたはヘッドレス／スクリプト実行時の代替手段となります。

# 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 イベントを検索してください。アクティビティのリファレンスを参照してください。

コメント

Markdown 対応