AI 集成快速开始

快速开始

5 分钟完成 Testany AI 集成配置。

前置条件

• AI 助手（Claude Code、GitHub Copilot、VS Code Copilot 等）
• 拥有 Testany 账号并有 API 访问权限

---

步骤 1：获取 API Token

1. 登录 Testany 平台
2. 点击右上角的头像
3. 选择 Settings
4. 找到 Developer Settings 部分
5. 点击 Create Token 创建新 Token
6. 复制 Token（格式：ta_live_xxxxxxxxxxxx）

---

步骤 2：安装 Testany MCP

选择你使用的 AI 助手，按照对应平台的说明进行配置。

Testany MCP 端点：

将 <tenant_name> 替换为你组织的租户名称。

---

Claude Code

项目级安装（在项目目录下执行）：

BashCopy
claude mcp add --transport http testany https://<tenant_name>.testany.com.cn/mcp \
  --header "Authorization: Bearer ta_live_你的TOKEN"

用户级安装：添加 --scope user 参数即可全局启用。

验证安装：

BashCopy
claude mcp list

---

Claude Desktop

方法 A：使用 Settings > Connectors（推荐）

1. 打开 Claude Desktop
2. 进入 Settings → Connectors
3. 添加新连接器，填写 Testany MCP URL 和凭证

方法 B：使用 mcp-remote 桥接（传统方法）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)：

JSONCopy
{
  "mcpServers": {
    "testany": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<tenant_name>.testany.com.cn/mcp",
        "--header",
        "Authorization: Bearer ta_live_你的TOKEN"
      ]
    }
  }
}

---

OpenAI Codex

在项目目录下创建 .codex/config.toml：

TOMLCopy
[mcp_servers.testany]
url = "https://<tenant_name>.testany.com.cn/mcp"

[mcp_servers.testany.http_headers]
Authorization = "Bearer ta_live_你的TOKEN"

用户级安装：将配置文件放在 ~/.codex/config.toml。

也可使用环境变量：将 http_headers 部分替换为 bearer_token_env_var = "TESTANY_API_KEY"，然后设置 export TESTANY_API_KEY="ta_live_你的TOKEN"。

---

Google Gemini CLI

编辑 ~/.gemini/settings.json（Gemini CLI 仅支持用户级配置）：

JSONCopy
{
  "mcpServers": {
    "testany": {
      "url": "https://<tenant_name>.testany.com.cn/mcp",
      "headers": {
        "Authorization": "Bearer ta_live_你的TOKEN"
      }
    }
  }
}

---

VS Code (GitHub Copilot)

在项目目录下创建 .vscode/mcp.json：

JSONCopy
{
  "servers": {
    "testany": {
      "type": "http",
      "url": "https://<tenant_name>.testany.com.cn/mcp",
      "headers": {
        "Authorization": "Bearer ${input:testany-token}"
      }
    }
  },
  "inputs": [
    {
      "id": "testany-token",
      "type": "promptString",
      "description": "Testany API Token",
      "password": true
    }
  ]
}

用户级安装：通过命令面板 Cmd+Shift+P → 搜索 "MCP: Open User Configuration" 打开用户级配置文件。

---

Cursor

在项目目录下创建 .cursor/mcp.json：

JSONCopy
{
  "mcpServers": {
    "testany": {
      "url": "https://<tenant_name>.testany.com.cn/mcp",
      "headers": {
        "Authorization": "Bearer ta_live_你的TOKEN"
      }
    }
  }
}

用户级安装：将配置文件放在 ~/.cursor/mcp.json。

---

TRAE

在项目目录下创建 .trae/mcp.json：

JSONCopy
{
  "mcpServers": {
    "testany": {
      "url": "https://<tenant_name>.testany.com.cn/mcp",
      "headers": {
        "Authorization": "Bearer ta_live_你的TOKEN"
      }
    }
  }
}

用户级安装：通过 TRAE 的 "Add MCP Servers" UI 添加，或将配置放在全局配置文件中。

---

替换 ta_live_你的TOKEN 为步骤 1 中获取的实际 Token

---

步骤 3：安装 Testany Skills（可选）

选择你的插件

testany-agent-skills ↗ 仓库包含 testany-bot 插件用于测试平台集成：

---

Claude Code

方法 A：从 Marketplace 安装（推荐）

BashCopy
# 1. 添加 Marketplace
/plugin marketplace add TestAny-io/testany-agent-skills

# 2. 打开插件管理器，选择 testany-bot 安装
/plugin

在插件管理器中选择 testany-bot，然后选择安装范围（项目级或用户级）。

方法 B：手动配置

BashCopy
git clone https://github.com/TestAny-io/testany-agent-skills.git

编辑 .claude/settings.json（项目级）：

JSONCopy
{
  "plugins": ["./testany-agent-skills/plugins/testany-bot"]
}

用户级安装：编辑 ~/.claude/settings.json，使用绝对路径。

---

OpenAI Codex

BashCopy
git clone https://github.com/TestAny-io/testany-agent-skills.git
mkdir -p .codex/skills
cp -r testany-agent-skills/plugins/testany-bot/skills/* .codex/skills/

用户级安装：复制到 ~/.codex/skills/。

---

Google Gemini CLI

BashCopy
git clone https://github.com/TestAny-io/testany-agent-skills.git
mkdir -p .gemini/skills
cp -r testany-agent-skills/plugins/testany-bot/skills/* .gemini/skills/

用户级安装：复制到 ~/.gemini/skills/。

---

VS Code (GitHub Copilot)

BashCopy
git clone https://github.com/TestAny-io/testany-agent-skills.git
mkdir -p .github/skills
cp -r testany-agent-skills/plugins/testany-bot/skills/* .github/skills/

---

Cursor

BashCopy
git clone https://github.com/TestAny-io/testany-agent-skills.git
mkdir -p .cursor/rules
cp -r testany-agent-skills/plugins/testany-bot/skills/* .cursor/rules/

用户级安装：复制到 ~/.cursor/rules/。

---

TRAE

BashCopy
git clone https://github.com/TestAny-io/testany-agent-skills.git
mkdir -p .trae/skills
cp -r testany-agent-skills/plugins/testany-bot/skills/* .trae/skills/

---

Claude Desktop

Claude Desktop 支持 Skills，但需要通过 UI 上传 .zip 文件：

1. 将 testany-agent-skills/plugins/testany-bot/skills 目录打包为 .zip 文件
2. 在 Claude Desktop 中进入 Settings → Skills
3. 点击 Upload 上传 .zip 文件

---

步骤 4：验证配置

Claude Code

BashCopy
# 查看 MCP 工具（应显示 59 个 testany_* 工具）
/mcp

# 查看 Skills（应显示 /case, /pipeline, /tests 等）
/skills

其他平台

根据平台文档检查 MCP 和 Skills 状态。

---

步骤 5：试一试

/case 创建一个健康检查 API 测试

或使用自然语言：

显示我的测试流水线

---

快速参考

可用的 Skills

---

常见问题

---

下一步

• 查看 资源链接 获取详细文档
• 访问 GitHub 仓库了解最新更新