---
title: "Xây dựng với Claude Code, Codex hoặc Cursor"
description: "Cài đặt Agent Skills của ThunderPhone, kết nối máy chủ MCP của ThunderPhone và cung cấp cho tác nhân lập trình tài liệu sản phẩm mới nhất."
---

ThunderPhone cung cấp ba lớp cho tác nhân lập trình:

| Lớp | Những gì lớp này cung cấp cho tác nhân |
| --- | --- |
| [Kỹ năng tác nhân](https://github.com/thunderphone/skills) | Quy trình chuyên biệt cho tác nhân, prompt, số điện thoại, cuộc gọi, công cụ, webhook, kiến thức, kiểm thử, chiến dịch, widget, khung realtime và di chuyển. |
| MCP | Các công cụ đã xác thực hỗ trợ tác nhân, số điện thoại, cuộc gọi, kiểm thử, kiến thức, công cụ/webhook, chiến dịch, giọng nói, nhập dữ liệu và tài liệu khi được triển khai; gọi `tools/list` để xem danh mục hiện tại. |
| [Tài liệu thô](https://thunderphone.com/docs/llms.txt) | Nguồn Markdown hiện tại về hành vi sản phẩm và chi tiết API. |

Kỹ năng giải thích cách thực hiện công việc. MCP cho phép tác nhân lập trình kiểm tra và thao tác trên tổ chức của bạn. Tài liệu thô cung cấp tài liệu nguồn cho các câu hỏi ngoài phạm vi của một kỹ năng đã tải.

## Cài đặt trong dự án

Khối này cài đặt các kỹ năng, cung cấp khóa cho shell hiện tại và thêm máy chủ MCP theo phạm vi dự án vào Claude Code. Thay thế phần giữ chỗ bằng cách đọc giá trị thực từ trình quản lý bí mật của bạn; không dán khóa vào kho lưu trữ hoặc cuộc trò chuyện.

```bash
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
  --header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
  thunderphone https://api.thunderphone.com/v1/mcp
```

Đối với Codex, thay lệnh cuối bằng:

```bash
codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY
```

Cursor đọc cấu hình dự án từ `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

VS Code sử dụng cùng máy chủ dưới khóa `servers` trong `.vscode/mcp.json`:

```json
{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

<Warning>
  Khóa API của tổ chức có thể đọc dữ liệu tổ chức và thực hiện các hành động đã bật.
  Lưu khóa trong trình quản lý bí mật, giới hạn quyền truy cập cho dự án dự kiến,
  và xem xét các lệnh gọi công cụ có thay đổi dữ liệu trước khi phê duyệt.
</Warning>

## Ví dụ phiên làm việc: lễ tân nha khoa song ngữ

1. Yêu cầu tác nhân lập trình tải `create-agent`,
   `thunderphone-prompt-builder`, `build-tool-integration`, `add-knowledge` và
   `test-agent`. Yêu cầu tác nhân lập kế hoạch trước và chưa tạo tài nguyên.
2. Cung cấp thông tin phòng khám đã được xác thực, các tác vụ được hỗ trợ, quy tắc chuyển cấp và
   hai ngôn ngữ bắt buộc. Yêu cầu tác nhân kiểm tra danh mục giọng nói đang hoạt động và các ngôn ngữ được hỗ trợ thay vì tự đặt ra giọng nói hoặc ngôn ngữ.
3. Yêu cầu một prompt production được xây dựng từ các nguyên tắc chung và thông tin thực tế. Tác nhân
   phải chuyển sang ngôn ngữ được hỗ trợ của người gọi, giữ lời nói ngắn gọn,
   hỏi từng câu một và tránh kịch bản phản hồi của người gọi.
4. Yêu cầu tác nhân xác định một công cụ đặt lịch phạm vi hẹp và chỉ đính kèm kiến thức mà
   lễ tân cần. Kiểm thử công cụ thành công, không có lịch trống, dữ liệu đầu vào không hợp lệ,
   hết thời gian chờ và chuyển giao cho người trước khi triển khai.
5. Tạo kịch bản cho cả hai ngôn ngữ, các lần ngắt lời, chỉnh sửa, thiếu
   thông tin, câu hỏi kiến thức, lỗi đặt lịch và chuyển cấp. Chạy các kịch bản,
   kiểm tra bản chép lời và bằng chứng công cụ, sửa quy tắc chung nhỏ nhất,
   rồi chạy lại cùng tập kịch bản đó.
6. Xem xét bản nháp chính xác và bằng chứng kiểm thử, sau đó ủy quyền rõ ràng cho việc triển khai
   và gắn số điện thoại. Thực hiện một cuộc gọi âm thanh có kiểm soát bằng từng ngôn ngữ trước
   khi chuyển lưu lượng thực.

Sử dụng [SDK Python hoặc TypeScript](/api-reference/sdks) cho các yêu cầu REST có kiểu dữ liệu.

Sử dụng REST thay vì MCP khi một bản dựng cần payload xác định, fixture được phiên bản hóa, điều phối hàng loạt hoặc một thao tác không có trong danh sách công cụ MCP hiện tại. API bắt đầu tại `https://api.thunderphone.com/v1`; xem phần
[giới thiệu API](/api-reference/introduction) và
[hướng dẫn MCP](/vi/guides/thunderphone-mcp-server).