用途:在 CARTO 与用户自有数据仓库之间建立并管理连接。连接承载凭证、目标项目/数据库范围,下游的查询、导入、建图、工作流等操作都依赖已有连接。
主要能力:列出与查看连接、创建和更新连接(含轮换凭证、更换项目/数据库范围)、删除连接;并提供各引擎的选型指导(BigQuery、Snowflake、Redshift、Postgres、Databricks、Oracle)。
使用方式:挂载 MCP 服务器时,列出走 explore_data(list_connections);创建/更新走 manage_connections;删除走 delete。仅 token 会话只能 list_connections,get_connection 与写操作需 OAuth,可回退到 CLI。未挂载服务器或脚本化场景也用 CLI:carto connections list --json、carto connections get <id>、carto connections create、carto connections update <id>、carto connections delete <id>。删除不可逆。
适用场景:接入新仓库、调试连接(认证失败、缺表、权限错误)、下游技能需要连接名而尚不知引擎类型、轮换凭证或迁移项目/数据库。连接建立后查看仓库内容应使用 carto-explore-datawarehouse,执行 SQL 用 carto-query-datawarehouse,导入文件用 carto-import-export-data。
限制与注意:认证模式需一致(BigQuery 的 OAuth 与 service-account JSON 混用会破坏共享连接);部分引擎需同时提供账户/项目与区域(Snowflake、Redshift),缺区域通常报 endpoint not found;确认 CARTO 可写入的 dataset/schema;describe 和读表权限取决于 CARTO 持有的凭证而非用户的 CARTO 角色。本技能不涵盖浏览表结构、运行 SQL 和导入文件。各引擎具体参考文件与官方资料细节暂未提供。