Xây dựng với Claude Code, Codex hoặc Cursor

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:

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.

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:

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:

{
  "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:

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

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 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 và hướng dẫn MCP.