SuperAPI AI 工具集

connect-ai-onboarding-claude-code

智能体与模型

查看项目

更新于 10-15 20:11

技能介绍

用途:帮助已安装并登录 Claude Code 的用户首次接入 CData Connect AI。Connect AI 是托管 MCP 服务器,为 Claude 提供对数百种业务数据源(如 Salesforce、HubSpot、Jira、NetSuite、SAP、Snowflake、Google Analytics 等)的实时、受治理的 SQL 访问。技能假定用户已装好 Claude Code,不涉及安装 CLI 或创建 Claude 账户。

流程顺序:注册 → 将 Claude Code 接入 Connect AI → 连接数据源 → 验证。认证识别的是用户而非具体数据集,因此注册后即可接入,无需先有数据源。

主要步骤:

  1. 注册:打开 https://www.cdata.com/ai/signup/ ,可用邮箱+姓名+密码或 SSO(LinkedIn、Microsoft、Google),需完成邮箱验证,然后登录 https://cloud.cdata.com/ 。已有 CData Cloud / Connect Cloud 账户可直接登录。
  2. 接入 Claude Code:默认 PAT + Basic 认证。在 Integrations → Claude Code → Connect 或 Settings → Personal Access Tokens 生成 PAT,PAT 不进入 AI 会话,由用户在本地终端运行注册命令。Windows PowerShell 示例:$cred = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("you@example.com:YOUR_PAT")) 后接 claude mcp add --scope user --transport http connectmcp https://mcp.cloud.cdata.com/mcp --header "Authorization: Basic $cred";macOS/Linux 使用 CRED=$(printf '%s' 'you@example.com:YOUR_PAT' | base64 | tr -d '\n') 后接同样命令。--scope user 使服务器对全账户可用。命令应输出 Added http MCP server connectmcp,随后重启 Claude Code。
  3. OAuth 备选:需交互式浏览器,不支持无头环境。先运行 claude --version 确认可达 CLI,再运行 claude mcp add --scope user --transport http connectmcp https://mcp.cloud.cdata.com/mcp,重启后在 /mcp 中选择 connectmcp 并 Authenticate。若出现 Callback URL mismatch,可改用 PAT 路径,或用 --callback-port <port> 指定已注册端口。
  4. 连接数据源:打开 https://cloud.cdata.com/connections/SelectConnection ,选择连接器,完成授权并 Save & Test,确认状态为已连接。
  5. 验证:由 Claude 调用 Connect AI MCP 的 getCatalogs 工具执行检查并以表格展示结果。

限制:PAT 会留在 shell 历史与 Claude Code 的 MCP 配置中(明文),泄露后应在 Settings → Personal Access Tokens 撤销并重新注册;OAuth 依赖回调地址白名单;按连接器深链暂不支持,SelectConnection 为最深稳定链接。资料未提供收费、价格与具体耗时信息。