---
title: "AI 集成快速开始"
language: "zh"
url: "https://docs.testany.io/zh/docs/ai-integration-quick-start/"
markdown_url: "https://docs.testany.io/zh/docs/ai-integration-quick-start.md"
translation: "https://docs.testany.io/en/docs/ai-integration-quick-start.md"
last_updated: "2026-02-07T18:19:37+08:00"
---

# 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`）


> **警告**
>
> 请妥善保管 API Token，不要提交到代码仓库或公开分享。


---

### 步骤 2：安装 Testany MCP


> **提示**
>
> Testany MCP 工具集约占用 6000 tokens 的上下文。建议：
> - **项目级安装（推荐）**：只在需要的项目中启用，避免在不相关的项目中浪费 token
> - **用户级安装**：如果你在多个项目中都需要使用 Testany，可选择全局安装


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

**Testany MCP 端点：**
| 环境 | URL |
|------|-----|
| 中国 | `https://<tenant_name>.testany.com.cn/mcp` |
| 国际版 | 即将推出 |

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

---

#### Claude Code

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

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

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

验证安装：

```bash
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)：

```json
{
  "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`：

```toml
[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 仅支持用户级配置）：

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

---

#### VS Code (GitHub Copilot)

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

```json
{
  "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
    }
  ]
}
```


> **备注**
>
> **Token 输入机制**：配置中的 `${input:testany-token}` 是 VS Code 的安全输入变量。首次使用 MCP 时，VS Code 会弹窗提示你输入 Token。输入后会安全存储在 VS Code 中，后续使用无需重复输入。


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

---

#### Cursor

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

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

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

---

#### TRAE

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

```json
{
  "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（可选）


> **说明**
>
> Skills 是 AI 助手的专业指令集，帮助 AI 更好地理解和执行 Testany 相关任务。安装 Skills 后可使用 `/case`、`/pipeline`、`/tests` 等快捷命令。
>
> 这是可选步骤。即使不安装 Skills，你仍可通过自然语言使用 Testany MCP 工具。


#### 选择你的插件

[testany-agent-skills](https://github.com/TestAny-io/testany-agent-skills) 仓库包含 **testany-bot** 插件用于测试平台集成：

| 插件 | 架构 | 适用平台 |
|------|------|---------|
| **testany-bot** | 自包含 Skills | 所有平台（Claude Code, Codex, Gemini CLI, VS Code Copilot, Cursor, TRAE） |

---

#### Claude Code

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

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

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

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

**方法 B：手动配置**

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

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

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

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

---

#### OpenAI Codex

```bash
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


> **备注**
>
> Agent Skills 是实验性功能（v0.23.0+）。需要在 `/settings` 中启用 `experimental.skills`。


```bash
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)


> **备注**
>
> Agent Skills 是实验性功能。需要在 VS Code 设置中启用 `chat.useAgentSkills`。


```bash
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

```bash
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

```bash
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

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

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

#### 其他平台

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

---

### 步骤 5：试一试

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

或使用自然语言：

```
显示我的测试流水线
```

---

## 快速参考

### 可用的 Skills

| Skill | 描述 | 示例 |
|-------|------|------|
| `/case` | 管理测试用例 | `/case 创建一个 API 测试` |
| `/pipeline` | 管理流水线 | `/pipeline 创建回归测试套件` |
| `/tests` | 执行和监控 | `/tests Y2K-0001A` |
| `/debug` | 分析故障 | `/debug Y2K-0001A-0000B` |
| `/orchestrator` | 测试编排 | `/orchestrator 创建质量门禁` |
| `/workspace` | 工作空间管理 | `/workspace 添加成员` |

---

## 常见问题

| 问题 | 解决方案 |
|------|---------|
| "连接失败" | 检查 API Token 和域名是否正确 |
| MCP 工具不显示 | 配置后重启 AI 助手 |
| Skills 不可用 | 检查配置中的插件路径 |
| "未授权"错误 | 重新生成 API Token |

---

## 下一步

- 查看 [资源链接](https://docs.testany.io/zh/docs/ai-integration-resources.md) 获取详细文档
- 访问 GitHub 仓库了解最新更新

## 本页术语

- [用户 (User)](https://docs.testany.io/zh/docs/glossary.md#user)
- [环境 (Environment)](https://docs.testany.io/zh/docs/glossary.md#environment)
- [执行 (Execution)](https://docs.testany.io/zh/docs/glossary.md#execution)
- [命令 (Command)](https://docs.testany.io/zh/docs/glossary.md#command)
- [路径（Path）](https://docs.testany.io/zh/docs/glossary.md#path)
- [测试用例 (Test Case)](https://docs.testany.io/zh/docs/glossary.md#test-case)