BrowserStack MCP Server

chính thức

Mang toàn bộ sức mạnh của Nền tảng Kiểm thử BrowserStack đến các công cụ AI của bạn, giúp việc kiểm thử trở nên nhanh hơn và dễ dàng hơn cho mọi nhà phát triển và người kiểm thử trong nhóm của bạn.

Tài liệu

BrowserStack MCP Server

BrowserStack Logo MCP Server Logo

Nền tảng Kiểm thử Toàn diện

Quản lý ca kiểm thử, thực thi kiểm thử thủ công hoặc tự động, gỡ lỗi sự cố và thậm chí sửa mã — trực tiếp trong các công cụ như Cursor, Claude hoặc bất kỳ client hỗ trợ MCP nào, sử dụng tiếng Anh thông thường.

Kiểm thử từ mọi nơi:

Dễ dàng kết nối Nền tảng Kiểm thử BrowserStack với các công cụ AI yêu thích của bạn, chẳng hạn như IDE, LLM hoặc quy trình tác tử.

Kiểm thử bằng ngôn ngữ tự nhiên:

Quản lý, thực thi, gỡ lỗi kiểm thử và thậm chí sửa mã bằng các lời nhắc tiếng Anh thông thường.

Giảm chuyển đổi ngữ cảnh:

Giữ luồng công việc — giữ tất cả ngữ cảnh dự án ở một nơi và kích hoạt hành động trực tiếp từ IDE hoặc LLM của bạn.

⚡️ Thiết lập MCP Một cú nhấp

Nhấp vào các nút bên dưới để cài đặt MCP trong IDE tương ứng của bạn:

Install in VS Code   Install in Cursor

Lưu ý : Đảm bảo bạn đang sử dụng phiên bản Node >= 18.0

  • Kiểm tra phiên bản node của bạn bằng node --version. Phiên bản khuyến nghị: v22.15.0 (LTS)
  • Để nâng cấp Node :
    1. Trên macOS (Homebrew) - brew update && brew upgrade node or if using (nvm) - nvm install 22.15.0 && nvm use 22.15.0 && nvm alias default 22.15.0
    1. Trên Windows (nvm-windows) : nvm install 22.15.0 && nvm use 22.15.0
  • 👉 Hoặc tải trực tiếp Trình cài đặt Node.js LTS

.

💡 Ví dụ Sử dụng

📱 Kiểm thử Ứng dụng Thủ công

Kiểm thử ứng dụng di động trên thiết bị thực với các phiên bản hệ điều hành mới nhất. Tái tạo lỗi và gỡ lỗi sự cố mà không gặp rắc rối thiết lập. Dưới đây là một số lời nhắc mẫu để sử dụng ứng dụng di động của bạn trên đám mây thiết bị thực rộng lớn của BrowserStack

# Open app on specific device
"open my app on a iPhone 15 Pro Max"

# Debug app crashes
"My app crashed on Android 14 device, can you help me debug?"
  • Không giống như trình giả lập, kiểm thử hiệu suất thực tế của ứng dụng trên thiết bị thực. Với các tính năng Lập hồ sơ Ứng dụng tiên tiến, bạn có thể gỡ lỗi sự cố và vấn đề hiệu suất trong thời gian thực.
  • Truy cập tất cả các thiết bị và phiên bản hệ điều hành chính từ lưới thiết bị của chúng tôi, Chúng tôi có SLA nghiêm ngặt để cung cấp các trung tâm dữ liệu toàn cầu với các thiết bị mới phát hành vào ngày ra mắt.

🌐 Kiểm thử Web Thủ công

Tương tự như kiểm thử ứng dụng, bạn có thể sử dụng các lời nhắc sau để kiểm thử trang web của mình trên đám mây trình duyệt và thiết bị thực rộng lớn của BrowserStack. Không có trình duyệt Edge được cài đặt trên máy của bạn? Chúng tôi đã lo liệu!

# Test your websites
"open my website hosted on localhost:3001 on Edge"
"open browserstack.com on latest version of Chrome"
  • Kiểm thử trang web trên các trình duyệt và thiết bị khác nhau. Chúng tôi hỗ trợ mọi trình duyệt chính trên mọi hệ điều hành chính.
  • Kiểm thử liền mạch các trang web được lưu trữ cục bộ trên máy của bạn, không cần triển khai lên máy chủ từ xa!

🧪 Kiểm thử Tự động (Playwright, Selenium, A11y và hơn thế nữa..)

Tự động phân tích, chẩn đoán và thậm chí sửa các tập lệnh kiểm thử bị hỏng ngay trong IDE hoặc LLM của bạn. Lấy nhật ký ngay lập tức, xác định nguyên nhân gốc rễ và áp dụng các bản sửa lỗi theo ngữ cảnh. Không còn vòng lặp gỡ lỗi. Dưới đây là một vài lời nhắc ví dụ để chạy/gỡ lỗi/sửa các bài kiểm thử tự động của bạn trên Nền tảng Kiểm thử của BrowserStack.

Lưu ý: Khi lấy Phân tích Nguyên nhân Gốc rễ (RCA) cho một bài kiểm thử, máy chủ chỉ trả về bản sửa lỗi được đề xuất dưới dạng đề xuất. Nó không bao giờ tự động áp dụng thay đổi mã — trợ lý của bạn phải trình bày đề xuất và chờ sự chấp thuận rõ ràng của bạn trước khi chỉnh sửa bất kỳ tệp nào.

#Port test suite to BrowserStack
"Setup test suite to run on BrowserStack infra"

#Run tests on BrowserStack
“Run my tests on BrowserStack”

#AI powered debugging of test failures
"My App Automate tests have failed, can you help me fix the new failures?"

  • Sửa lỗi kiểm thử được báo cáo bởi pipeline CI/CD của bạn bằng cách sử dụng các tính năng Khả năng Quan sát Kiểm thử hàng đầu ngành của chúng tôi. Tìm thêm thông tin tại đây.
  • Chạy các bài kiểm thử được viết bằng Jest, Playwright, Selenium và hơn thế nữa trên Nền tảng Kiểm thử của BrowserStack

🌐 Trợ năng

Phát hiện sớm các vấn đề trợ năng với quét a11y cục bộ, tự động. Nhận các bản sửa lỗi do AI đề xuất chỉ với một cú nhấp. Không cần săn tìm tài liệu, không bất ngờ CI. Đảm bảo tuân thủ WCAG và ADA với công cụ Kiểm thử Trợ năng của chúng tôi

#Scan accessibility issues while development
"Scan & help fix accessibility issues for my website running locally on localhost:3000"

#Scan accessibility issues on production site
“Run accessibility scan & identify issues on my website - www.bstackdemo.com”

📋 Quản lý Kiểm thử

Tạo và quản lý ca kiểm thử, tạo kế hoạch kiểm thử và kích hoạt chạy kiểm thử bằng ngôn ngữ tự nhiên. Dưới đây là một vài lời nhắc ví dụ để sử dụng khả năng của Quản lý Kiểm thử của BrowserStack với máy chủ MCP.

# Create project & folder structure
"create new Test management project named My Demo Project with two sub folders - Login & Checkout"

# Add test cases
"add invalid login test case in Test Management project named My Demo Project"

# List added test cases 
"list high priority Login test cases from Test Management project - My Demo Project"

# Create test run
"create a test run for Login tests from Test Management project - My Demo Project"

# Update test results
"update test results as passed for Login tests test run from My Demo Project"

🧪 Truy cập Tác tử AI của BrowserStack

Tạo ca kiểm thử từ PRD, chuyển đổi kiểm thử thủ công sang tự động hóa low-code và tự động chữa lành các tập lệnh không ổn định được hỗ trợ bởi các tác tử AI của BrowserStack, tích hợp liền mạch vào quy trình làm việc của bạn. Dưới đây là một vài lời nhắc ví dụ để truy cập tác tử AI của Browserstack

#Test case generator agent
"With Browserstack AI, create relevant test cases for my PRD located at /usr/file/location"


#Low code authoring agent
“With Browserstack AI, automate my manual test case X, added in Test Management”


#Self healing agent
“Help fix flaky tests in my test script with Browserstack AI self healing”

🛠️ Cài đặt

📋 Điều kiện tiên quyết để Thiết lập MCP

Lưu ý : Đảm bảo bạn đang sử dụng phiên bản Node >= 18.0

  • Kiểm tra phiên bản node của bạn bằng node --version. Phiên bản khuyến nghị: v22.15.0 (LTS)

Thiết lập MCP Một cú nhấp

Nhấp vào các nút bên dưới để cài đặt MCP trong IDE tương ứng của bạn:

Install in VS Code   Install in Cursor

Các cách thay thế để Thiết lập máy chủ MCP

  1. Tạo Tài khoản BrowserStack

    • Đăng ký BrowserStack nếu bạn chưa có tài khoản.

    • ℹ️ Nếu bạn có dự án mã nguồn mở, chúng tôi có thể cung cấp cho bạn gói miễn phí.

    • Khi bạn đã có tài khoản (và mua gói phù hợp), hãy ghi lại usernameaccess_key của bạn từ Cài đặt Tài khoản.

  2. Lưu ý : Đảm bảo bạn đang sử dụng phiên bản Node >= 18.0

    • Kiểm tra phiên bản node của bạn bằng node --version. Phiên bản khuyến nghị: v22.15.0 (LTS)
  3. Cài đặt Máy chủ MCP

    • VSCode (Copilot - Chế độ Tác tử): .vscode/mcp.json:

      • Định vị hoặc Tạo Tệp Cấu hình: Trong thư mục gốc của dự án, tìm một thư mục có tên .vscode. Thư mục này thường bị ẩn nên bạn sẽ cần tìm nó như đã đề cập trong phần mở rộng.

      • Nếu thư mục này không tồn tại, hãy tạo nó.

      • Bên trong thư mục .vscode, tạo một tệp mới có tên mcp.json

      • Thêm Cấu hình: Mở tệp mcp.json và sau đó thêm nội dung JSON sau.

      • Thay thế tên người dùng và <access_key> bằng thông tin đăng nhập BrowserStack của bạn.

    {
      "servers": {
        "browserstack": {
          "command": "npx",
          "args": ["-y", "@browserstack/mcp-server@latest"],
          "env": {
            "BROWSERSTACK_USERNAME": "<username>",
            "BROWSERSTACK_ACCESS_KEY": "<access_key>"
          }
        }
      }
    }
    
    • Trong VSCode, đảm bảo nhấp vào nút Start trong Máy chủ MCP để khởi động máy chủ. Start MCP Server

    ** Cách thay thế để thiết lập MCP trên VSCode Copilot

    1.Nhấp vào biểu tượng bánh răng để Chọn Công cụ

    Select Tools
    2. Một menu công cụ sẽ xuất hiện ở trên cùng giữa, cuộn xuống menu ở trên cùng và sau đó Nhấp vào Thêm Máy chủ MCP
    Add MCP Server
    3. Chọn tùy chọn gói NPM (Cài đặt từ gói NPM) - thứ 3 trong danh sách
    Select NPM Package
    4. Nhập Tên Gói NPM (@browserstack/mcp-server)
    Enter NPM Package
    5. Nhập tên người dùng browserstack và khóa truy cập
    • Cho Cursor: .cursor/mcp.json:
    {
      "mcpServers": {
        "browserstack": {
          "command": "npx",
          "args": ["-y", "@browserstack/mcp-server@latest"],
          "env": {
            "BROWSERSTACK_USERNAME": "<username>",
            "BROWSERSTACK_ACCESS_KEY": "<access_key>"
          }
        }
      }
    }
    
    • Claude Desktop: ~/claude_desktop_config.json:
    {
      "mcpServers": {
        "browserstack": {
          "command": "npx",
          "args": ["-y", "@browserstack/mcp-server@latest"],
          "env": {
            "BROWSERSTACK_USERNAME": "<username>",
            "BROWSERSTACK_ACCESS_KEY": "<access_key>"
          }
        }
      }
    }
    
    • Cline

Nhấp vào biểu tượng “Máy chủ MCP” trong thanh điều hướng Chọn tab “Đã cài đặt”. Nhấp vào nút “Cấu hình Máy chủ MCP” ở cuối ngăn.

{
  "mcpServers": {
    "browserstack": {
      "command": "npx",
      "args": ["-y", "@browserstack/mcp-server@latest"],
      "env": {
        "BROWSERSTACK_USERNAME": "<username>",
        "BROWSERSTACK_ACCESS_KEY": "<access_key>"
      }
    }
  }
}

💡 Danh sách Công cụ MCP của BrowserStack

Hiện tại chúng tôi hỗ trợ 20 công cụ.


🧾 Quản lý Kiểm thử

  1. createProjectOrFolder — Tạo dự án Quản lý Kiểm thử và/hoặc thư mục để tổ chức ca kiểm thử. Trả về ID Thư mục, ID Dự án và Liên kết Quản lý Kiểm thử để truy cập Bảng điều khiển Dự án TM. Ví dụ lời nhắc
Create a new Test Management project named 'Shopping App' with two folders - Login and Checkout
  1. createTestCase — Thêm ca kiểm thử thủ công vào một dự án/thư mục cụ thể (sử dụng định danh dự án như PR-xxxxx và ID thư mục). Ví dụ lời nhắc
Add a test case named 'Invalid Login Scenario' to the Login folder in the 'Shopping App' project with PR-53617, Folder ID: 117869
  1. listTestCases — Liệt kê ca kiểm thử cho một dự án (hỗ trợ bộ lọc như mức độ ưu tiên, trạng thái, thẻ). Ví dụ lời nhắc
List all high-priority test cases in the 'Shopping App' project with project_identifier: PR-59457
  1. createTestRun — Tạo một lần chạy kiểm thử (bộ) cho các ca kiểm thử đã chọn trong một dự án. Ví dụ lời nhắc
Create a test run for the Login folder in the 'Shopping App' project and name it 'Release v1.0 Login Flow'
  1. listTestRuns — Liệt kê các lần chạy kiểm thử cho một dự án (lọc theo ngày, người được giao, trạng thái). Ví dụ lời nhắc
List all test runs from the 'Shopping App' project that were executed last week and are currently marked in-progress
  1. updateTestRun — Cập nhật một phần lần chạy kiểm thử (trạng thái, thẻ, ghi chú, ca kiểm thử liên quan). Ví dụ lời nhắc
Update test run ID 1043 in the 'Shopping App' project and mark it as complete with the note 'Regression cycle done'
  1. addTestResult — Thêm kết quả thực thi thủ công (đạt/không đạt/bị chặn/bỏ qua) cho một ca kiểm thử trong một lần chạy. Ví dụ lời nhắc
Mark the test case 'Invalid Login Scenario' as passed in test run ID 1043 of the 'Shopping App' project
  1. createTestCasesFromFile — Tạo hàng loạt ca kiểm thử từ tệp đã tải lên (ví dụ: PDF). Ví dụ lời nhắc
Upload test cases from '/Users/xyz/testcases.pdf' to the 'Shopping App' project in Test Management

⚙️ Thiết lập BrowserStack SDK / Kiểm thử Tự động

  1. setupBrowserStackAutomateTests — Tích hợp BrowserStack SDK và chạy kiểm thử web trên BrowserStack (tùy chọn bật Percy). Ví dụ lời nhắc
Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox. Enable Percy for visual testing.
  1. fetchAutomationScreenshots — Lấy ảnh chụp màn hình được chụp trong một phiên Automate/App Automate nhất định. Ví dụ lời nhắc
Get screenshots from Automate session ID abc123xyz for my desktop test run

🔍 Khả năng Quan sát

  1. getFailureLogs — Truy xuất nhật ký lỗi cho các phiên Automate/App Automate (tùy chọn theo ID Bản dựng cho App Automate). Ví dụ lời nhắc
Get the error logs from the session ID: 21a864032a7459f1e7634222249b316759d6827f, Build ID: dt7ung4wmjittzff8kksrjadjax9gzvbscoyf9qn of App Automate test session

📱 App Live

  1. runAppLiveSession — Bắt đầu phiên kiểm thử ứng dụng thủ công trên thiết bị thực trên đám mây. Ví dụ lời nhắc
Open my app on iPhone 15 Pro Max with iOS 17. App path is /Users/xyz/app.ipa

💻 Live

  1. runBrowserLiveSession — Bắt đầu phiên Live để kiểm thử trang web trên trình duyệt máy tính để bàn hoặc di động. Ví dụ lời nhắc
Open www.google.com on the latest version of Microsoft Edge on Windows 11

📲 App Automate

  1. takeAppScreenshot — Khởi chạy ứng dụng trên thiết bị được chỉ định và chụp ảnh màn hình xác minh nhanh. Công cụ này chỉ để xác minh xem ứng dụng của bạn đã được khởi chạy chưa. Ví dụ lời nhắc
Take a screenshot of my app on Google Pixel 6 with Android 12 while testing on App Automate. App file path: /Users/xyz/app-debug.apk
  1. runAppTestsOnBrowserStack — Chạy kiểm thử di động tự động (Espresso/XCUITest, v.v.) trên thiết bị thực. Ví dụ lời nhắc
Run Espresso tests from /tests/checkout.zip on Galaxy S21 and Pixel 6 with Android 12. App path is /apps/beta-release.apk under project 'Checkout Flow'

♿ Trợ năng

  1. accessibilityExpert — Hỏi Chuyên gia A11y (WCAG 2.0/2.1/2.2, khả năng sử dụng di động/web, thực tiễn tốt nhất). Ví dụ lời nhắc
What WCAG guidelines apply to form field error messages on mobile web?
  1. startAccessibilityScan — Bắt đầu quét trợ năng web và trả về liên kết kết quả. Ví dụ lời nhắc
Run accessibility scan for "www.example.com"

🤖 Tác tử AI của BrowserStack

  1. fetchSelfHealedSelectors — Truy xuất bộ chọn tự động chữa lành bằng AI để sửa các bài kiểm thử không ổn định do thay đổi DOM. Ví dụ lời nhắc
Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP
  1. createLCASteps — Tạo các bước Tự động hóa Low Code từ ca kiểm thử thủ công trong Quản lý Kiểm thử. Ví dụ lời nhắc
Convert the manual test case 'Add to Cart' in the 'Shopping App' project into LCA steps
  1. uploadProductRequirementFile — Tải lên PRD/ảnh chụp màn hình/PDF và nhận ID ánh xạ tệp (được sử dụng với createTestCasesFromFile). Ví dụ lời nhắc
Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases

🚀 Máy chủ MCP Từ xa

MCP Từ xa đi kèm với tất cả các chức năng của máy chủ MCP mà không gặp rắc rối về thiết lập phức tạp hoặc cài đặt cục bộ.

Lợi ích chính:

  • ✅ Hoạt động liền mạch trong mạng doanh nghiệp mà không lo lắng về tường lửa hoặc tệp nhị phân hoặc nơi không cho phép cài đặt cục bộ.

  • ✅ Tích hợp OAuth an toàn – không chia sẻ mật khẩu hoặc xử lý thông tin đăng nhập thủ công.

Hạn chế:

  • ❌ Không hỗ trợ Kiểm thử Cục bộ (không thể kiểm thử ứng dụng sau VPN, tường lửa hoặc localhost). Nếu bạn phải thực hiện Kiểm thử Cục bộ, bạn sẽ phải sử dụng máy chủ MCP Cục bộ của BrowserStack.
  • ❌ Độ trễ có thể cao hơn một chút, nhưng không đáng kể — bạn thường sẽ không nhận thấy nó trong sử dụng bình thường.

Các bước Cài đặt:

  • Trên VSCode (Copilot - Chế độ Tác tử): .vscode/mcp.json:

    • Định vị hoặc Tạo Tệp Cấu hình:

    • Trong thư mục gốc của dự án, tìm một thư mục có tên .vscode. Thư mục này thường bị ẩn nên bạn sẽ cần tìm nó như đã đề cập trong phần mở rộng.

    • Nếu thư mục này không tồn tại, hãy tạo nó.

    • Bên trong thư mục .vscode, tạo một tệp mới có tên mcp.json

    • Để thiết lập MCP Từ xa của BrowserStack thay vì MCP Cục bộ của BrowserStack, bạn có thể thêm nội dung JSON sau :

      Remote MCP JSON file

      Cách thay thế để Thiết lập MCP Từ xa

  • Bước 1. Nhấp vào biểu tượng bánh răng để Chọn Công cụ

    Select Tools
  • Bước 2. Một menu công cụ sẽ xuất hiện ở phía trên cùng chính giữa, cuộn xuống menu ở phía trên rồi Nhấp vào Thêm MCP Server

    Add MCP Server
  • Bước 3. Nhấp vào tùy chọn HTTP

    HTTP Option
  • Bước 4. Dán URL MCP Server Từ xa: https://mcp.browserstack.com/mcp

    Remote MCP Server URL
  • Bước 5. Đặt id máy chủ là: browserstack

    Remote MCP Server ID
  • Bước 6. Trong VSCode, Nhấp vào khởi động MCP Server rồi nhấp vào "Cho phép"

    authentication1
    authentication2
    Sign_in_success

🤝 Các Ứng Dụng Khách MCP Được Khuyến Nghị

  • Chúng tôi khuyến nghị sử dụng Github Copilot hoặc Cursor cho các trường hợp kiểm thử tự động và gỡ lỗi.
  • Đối với các trường hợp kiểm thử thủ công (Kiểm thử Trực tiếp), chúng tôi khuyến nghị sử dụng Claude Desktop.

⚠️ Lưu Ý Quan Trọng

  • BrowserStack MCP Server đang trong quá trình phát triển tích cực và hiện hỗ trợ một tập hợp con của đặc tả MCP. Nhiều tính năng hơn sẽ sớm được bổ sung.
  • Việc gọi công cụ phụ thuộc vào Ứng Dụng Khách MCP, vốn lại phụ thuộc vào một LLM, do đó có thể có một số hành vi không xác định dẫn đến kết quả không mong muốn. Nếu bạn có bất kỳ đề xuất hoặc phản hồi nào, vui lòng mở một issue để thảo luận.

📝 Đóng Góp

Chúng tôi hoan nghênh các đóng góp! Vui lòng mở một issue để thảo luận về bất kỳ thay đổi nào bạn muốn thực hiện. 👉 Nhấp vào đây để xem Hướng dẫn Đóng góp của chúng tôi

📞 Hỗ Trợ

Để được hỗ trợ, vui lòng:

  • Mở một issue trong kho lưu trữ GitHub của chúng tôi nếu bạn gặp bất kỳ vấn đề nào liên quan đến MCP Server.
  • Liên hệ với đội ngũ hỗ trợ của chúng tôi cho bất kỳ thắc mắc nào khác.

🚀 Nhiều Tính Năng Hơn Sắp Ra Mắt

Hãy đón chờ những cập nhật thú vị! Có đề xuất nào không? Vui lòng mở một issue để thảo luận.