mcpField
C
connection-manager

connection-manager

github.com/lytics数据与数据库456 次安装3 周前更新
代码仓库

关于 connection-manager

Connection Manager 是用于浏览和管理 Lytics 外部系统连接及认证提供方的技能,面向需要配置集成的用户。它通过 Lytics API 查询连接、认证和可用提供方,并要求写操作经过确认。

主要功能

  1. 01列出并查看连接
  2. 02列出并查看认证提供方
  3. 03查询可用集成类型
  4. 04按流程发现连接数据与架构
  5. 05写操作前要求确认并保护凭据

适用场景

  1. 01检查现有外部系统连接
  2. 02查找集成提供方并配置认证
  3. 03扫描连接以查看可用数据和架构

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/lytics/agent-skills --skill connection-manager

安装后在 Claude Code 中输入/connection-manager确认已加载。

详细介绍

连接管理器

用途

浏览和管理连接(外部系统配置)及身份验证提供方(凭据/令牌)。连接定义了 Lytics 如何与外部平台通信。

环境

需要经过身份验证的 API 访问权限。凭据解析方式请参阅 ../references/auth.md。

API 端点

连接
# List all connections
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Get connection
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Create connection
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection" \
  -H "Authorization: ${LYTICS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ ... connection config ... }'

# Update connection
curl -s -X PUT "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ ... updated config ... }'

# Delete connection
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Scan connection (discover available data)
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}/scan" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Get connection schema
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}/schema" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Get connection table schema
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}/schema/${TABLE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
身份验证提供方
# List all auth providers
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Get auth by ID
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${AUTH_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Get auth by type and ID
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${TYPE}/${AUTH_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

# Create auth
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${TYPE}" \
  -H "Authorization: ${LYTICS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ ... auth credentials ... }'

# Update auth
curl -s -X PUT "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${TYPE}/${AUTH_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ ... updated credentials ... }'

# Delete auth
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${AUTH_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
提供方(可用的集成类型)
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/provider" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

行为

读取操作(list、get、scan)

立即执行。以表格形式显示连接,包含:

  • 连接 ID、名称、类型、状态、上次使用时间
写入操作(create、update、delete)

使用确认门控模式。身份验证凭据属于敏感信息——切勿记录或显示完整的凭据值。

连接发现流程

设置新集成时:

  1. 列出可用的提供方(GET /v2/provider)
  2. 为选定的提供方创建身份验证
  3. 使用该身份验证创建连接
  4. 扫描连接以发现可用数据
  5. 查看连接架构

错误处理

  • 身份验证已过期:建议重新创建身份验证提供方
  • 连接测试失败:检查身份验证凭据和网络访问权限
  • 未找到提供方:列出可用的提供方

依赖项

  • 使用:../references/auth.md、../references/api-client.md、../references/confirmation-gate.md

评论

支持 Markdown