BrowserStack MCP Server

resmi

Hadirkan kekuatan penuh Platform Pengujian BrowserStack ke alat AI Anda, membuat pengujian lebih cepat dan mudah bagi setiap pengembang dan penguji di tim Anda.

Dokumentasi

Server MCP BrowserStack

BrowserStack Logo MCP Server Logo

Platform Uji Komprehensif

Kelola kasus uji, jalankan uji manual atau otomatis, debug masalah, dan bahkan perbaiki kode—langsung dalam alat seperti Cursor, Claude, atau klien berkemampuan MCP lainnya, menggunakan bahasa Inggris sederhana.

Uji dari mana saja:

Hubungkan Platform Uji BrowserStack dengan mudah ke alat AI favorit Anda, seperti IDE, LLM, atau alur kerja agentik.

Uji dengan bahasa alami:

Kelola, jalankan, debug uji, dan bahkan perbaiki kode menggunakan perintah bahasa Inggris sederhana.

Pengalihan konteks yang berkurang:

Tetap dalam alur—simpan semua konteks proyek di satu tempat dan picu tindakan langsung dari IDE atau LLM Anda.

⚡️ Penyiapan MCP Satu Klik

Klik tombol di bawah ini untuk menginstal MCP di IDE Anda masing-masing:

Install in VS Code   Install in Cursor

Catatan : Pastikan Anda menggunakan Node versi >= 18.0

  • Periksa versi node Anda menggunakan node --version. Versi yang direkomendasikan: v22.15.0 (LTS)
  • Untuk Meningkatkan Node :
    1. Di 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. Di Windows (nvm-windows) : nvm install 22.15.0 && nvm use 22.15.0
  • 👉 Atau unduh langsung Penginstal Node.js LTS

.

💡 Contoh Penggunaan

📱 Pengujian Aplikasi Manual

Uji aplikasi seluler di perangkat nyata dengan versi OS terbaru. Reproduksi bug dan debug kerusakan tanpa repot penyiapan. Di bawah ini adalah beberapa contoh perintah untuk menggunakan aplikasi seluler Anda di cloud perangkat nyata BrowserStack yang luas

# 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?"
  • Tidak seperti emulator, uji kinerja dunia nyata aplikasi Anda di perangkat sebenarnya. Dengan fitur App-Profiling canggih, Anda dapat men-debug kerusakan dan masalah kinerja secara real-time.
  • Akses semua perangkat dan versi OS utama dari grid perangkat kami, Kami memiliki SLA ketat untuk menyediakan pusat data global kami dengan perangkat yang baru dirilis pada hari peluncuran.

🌐 Pengujian Web Manual

Mirip dengan pengujian aplikasi, Anda dapat menggunakan perintah berikut untuk menguji situs web Anda di cloud browser dan perangkat nyata BrowserStack yang luas. Tidak punya browser Edge terinstal di mesin Anda? Kami siap membantu!

# Test your websites
"open my website hosted on localhost:3001 on Edge"
"open browserstack.com on latest version of Chrome"
  • Uji situs web di berbagai browser dan perangkat. Kami mendukung setiap browser utama di setiap OS utama.
  • Uji situs web yang dihosting secara lokal di mesin Anda dengan mulus, tidak perlu deploy ke server jarak jauh!

🧪 Pengujian Otomatis (Playwright, Selenium, A11y, dan lainnya..)

Analisis otomatis, diagnosis, dan bahkan perbaiki skrip uji yang rusak langsung di IDE atau LLM Anda. Ambil log secara instan, identifikasi akar penyebab, dan terapkan perbaikan yang sadar konteks. Tidak ada lagi putaran debugging. Di bawah ini adalah beberapa contoh perintah untuk menjalankan/mendebug/memperbaiki uji otomatis Anda di Platform Uji BrowserStack.

Catatan: Saat mengambil Analisis Akar Penyebab (RCA) untuk suatu uji, server mengembalikan perbaikan yang disarankan hanya sebagai proposal. Server tidak pernah menerapkan perubahan kode secara otomatis — asisten Anda harus menyajikan saran dan menunggu persetujuan eksplisit Anda sebelum mengedit file apa pun.

#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?"

  • Perbaiki kegagalan uji yang dilaporkan oleh pipeline CI/CD Anda dengan memanfaatkan fitur Test Observability terkemuka di industri kami. Temukan info lebih lanjut di sini.
  • Jalankan uji yang ditulis dalam Jest, Playwright, Selenium, dan lainnya di Platform Uji BrowserStack

🌐 Aksesibilitas

Tangkap masalah aksesibilitas lebih awal dengan pemindaian a11y lokal otomatis. Dapatkan perbaikan yang disarankan AI dalam satu klik. Tidak perlu mencari-cari dokumen, tidak ada kejutan CI. Pastikan kepatuhan WCAG dan ADA dengan alat Pengujian Aksesibilitas kami

#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”

📋 Manajemen Uji

Buat dan kelola kasus uji, buat rencana uji, dan picu eksekusi uji menggunakan bahasa alami. Di bawah ini adalah beberapa contoh perintah untuk memanfaatkan kemampuan Manajemen Uji BrowserStack dengan server 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"

🧪 Akses Agen AI BrowserStack

Hasilkan kasus uji dari PRD, konversi uji manual ke otomatisasi low-code, dan pulihkan otomatis skrip yang tidak stabil didukung oleh agen AI BrowserStack, terintegrasi mulus ke dalam alur kerja Anda. Di bawah ini adalah beberapa contoh perintah untuk mengakses agen AI 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”

🛠️ Instalasi

📋 Prasyarat untuk Penyiapan MCP

Catatan : Pastikan Anda menggunakan Node versi >= 18.0

  • Periksa versi node Anda menggunakan node --version. Versi yang direkomendasikan: v22.15.0 (LTS)

Penyiapan MCP Satu Klik

Klik tombol di bawah ini untuk menginstal MCP di IDE Anda masing-masing:

Install in VS Code   Install in Cursor

Cara alternatif untuk Menyiapkan server MCP

  1. Buat Akun BrowserStack

    • Daftar ke BrowserStack jika Anda belum memiliki akun.

    • ℹ️ Jika Anda memiliki proyek sumber terbuka, kami dapat menyediakan paket gratis untuk Anda.

    • Setelah Anda memiliki akun (dan membeli paket yang sesuai), catat username dan access_key Anda dari Pengaturan Akun.

  2. Catatan : Pastikan Anda menggunakan Node versi >= 18.0

    • Periksa versi node Anda menggunakan node --version. Versi yang direkomendasikan: v22.15.0 (LTS)
  3. Instal Server MCP

    • VSCode (Copilot - Mode Agen): .vscode/mcp.json:

      • Temukan atau Buat File Konfigurasi: Di direktori root proyek Anda, cari folder bernama .vscode. Folder ini biasanya tersembunyi sehingga Anda perlu menemukannya seperti yang disebutkan di bagian perluasan.

      • Jika folder ini tidak ada, buatlah.

      • Di dalam folder .vscode, buat file baru bernama mcp.json

      • Tambahkan Konfigurasi: Buka file mcp.json lalu tambahkan konten JSON berikut.

      • Ganti nama pengguna dan <access_key> dengan kredensial BrowserStack Anda.

    {
      "servers": {
        "browserstack": {
          "command": "npx",
          "args": ["-y", "@browserstack/mcp-server@latest"],
          "env": {
            "BROWSERSTACK_USERNAME": "<username>",
            "BROWSERSTACK_ACCESS_KEY": "<access_key>"
          }
        }
      }
    }
    
    • Di VSCode, pastikan untuk mengklik tombol Start di Server MCP untuk memulai server. Start MCP Server

    ** Cara alternatif untuk menyiapkan MCP di VSCode Copilot

    1.Klik ikon roda gigi untuk Memilih Alat

    Select Tools
    2. Menu alat akan muncul di tengah atas, gulir ke bawah pada menu di bagian atas lalu Klik Tambah Server MCP
    Add MCP Server
    3. Pilih opsi paket NPM (Instal dari paket NPM) - ke-3 dalam daftar
    Select NPM Package
    4. Masukkan Nama Paket NPM (@browserstack/mcp-server)
    Enter NPM Package
    5. Masukkan nama pengguna dan kunci akses browserstack
    • Untuk 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

Klik ikon “Server MCP” di bilah navigasi Pilih tab “Terinstal”. Klik tombol “Konfigurasi Server MCP” di bagian bawah panel.

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

💡 Daftar Alat MCP BrowserStack

Saat ini kami mendukung 20 alat.


🧾 Manajemen Uji

  1. createProjectOrFolder — Buat proyek Manajemen Uji dan/atau folder untuk mengatur kasus uji. Mengembalikan ID Folder, ID Proyek, dan Tautan Manajemen Uji untuk mengakses Dasbor Proyek TM. Contoh perintah
Create a new Test Management project named 'Shopping App' with two folders - Login and Checkout
  1. createTestCase — Tambahkan kasus uji manual di bawah proyek/folder tertentu (menggunakan pengenal proyek seperti PR-xxxxx dan ID folder). Contoh perintah
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 — Daftar kasus uji untuk suatu proyek (mendukung filter seperti prioritas, status, tag). Contoh perintah
List all high-priority test cases in the 'Shopping App' project with project_identifier: PR-59457
  1. createTestRun — Buat eksekusi uji (suite) untuk kasus uji yang dipilih dalam suatu proyek. Contoh perintah
Create a test run for the Login folder in the 'Shopping App' project and name it 'Release v1.0 Login Flow'
  1. listTestRuns — Daftar eksekusi uji untuk suatu proyek (filter berdasarkan tanggal, penerima tugas, status). Contoh perintah
List all test runs from the 'Shopping App' project that were executed last week and are currently marked in-progress
  1. updateTestRun — Perbarui sebagian eksekusi uji (status, tag, catatan, kasus uji terkait). Contoh perintah
Update test run ID 1043 in the 'Shopping App' project and mark it as complete with the note 'Regression cycle done'
  1. addTestResult — Tambahkan hasil eksekusi manual (lulus/gagal/diblokir/dilewati) untuk kasus uji dalam suatu eksekusi. Contoh perintah
Mark the test case 'Invalid Login Scenario' as passed in test run ID 1043 of the 'Shopping App' project
  1. createTestCasesFromFile — Buat massal kasus uji dari file yang diunggah (misalnya, PDF). Contoh perintah
Upload test cases from '/Users/xyz/testcases.pdf' to the 'Shopping App' project in Test Management

⚙️ Penyiapan SDK BrowserStack / Uji Otomatis

  1. setupBrowserStackAutomateTests — Integrasikan SDK BrowserStack dan jalankan uji web di BrowserStack (opsional aktifkan Percy). Contoh perintah
Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox. Enable Percy for visual testing.
  1. fetchAutomationScreenshots — Ambil tangkapan layar yang diambil selama sesi Automate/App Automate tertentu. Contoh perintah
Get screenshots from Automate session ID abc123xyz for my desktop test run

🔍 Observabilitas

  1. getFailureLogs — Ambil log kesalahan untuk sesi Automate/App Automate (opsional berdasarkan ID Build untuk App Automate). Contoh perintah
Get the error logs from the session ID: 21a864032a7459f1e7634222249b316759d6827f, Build ID: dt7ung4wmjittzff8kksrjadjax9gzvbscoyf9qn of App Automate test session

📱 App Live

  1. runAppLiveSession — Mulai sesi pengujian aplikasi manual di perangkat nyata di cloud. Contoh perintah
Open my app on iPhone 15 Pro Max with iOS 17. App path is /Users/xyz/app.ipa

💻 Live

  1. runBrowserLiveSession — Mulai sesi Live untuk pengujian situs web di browser desktop atau seluler. Contoh perintah
Open www.google.com on the latest version of Microsoft Edge on Windows 11

📲 App Automate

  1. takeAppScreenshot — Luncurkan aplikasi di perangkat yang ditentukan dan ambil tangkapan layar verifikasi cepat. Alat ini hanya untuk memverifikasi apakah aplikasi Anda telah diluncurkan. Contoh perintah
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 — Jalankan uji seluler otomatis (Espresso/XCUITest, dll.) di perangkat nyata. Contoh perintah
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'

♿ Aksesibilitas

  1. accessibilityExpert — Tanya Pakar A11y (WCAG 2.0/2.1/2.2, kegunaan seluler/web, praktik terbaik). Contoh perintah
What WCAG guidelines apply to form field error messages on mobile web?
  1. startAccessibilityScan — Mulai pemindaian aksesibilitas web dan kembalikan tautan hasil. Contoh perintah
Run accessibility scan for "www.example.com"

🤖 Agen AI BrowserStack

  1. fetchSelfHealedSelectors — Ambil pemilih yang dipulihkan otomatis oleh AI untuk memperbaiki uji yang tidak stabil karena perubahan DOM. Contoh perintah
Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP
  1. createLCASteps — Hasilkan langkah Otomatisasi Low Code dari kasus uji manual di Manajemen Uji. Contoh perintah
Convert the manual test case 'Add to Cart' in the 'Shopping App' project into LCA steps
  1. uploadProductRequirementFile — Unggah PRD/tangkapan layar/PDF dan dapatkan ID pemetaan file (digunakan dengan createTestCasesFromFile). Contoh perintah
Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases

🚀 Server MCP Jarak Jauh

MCP Jarak Jauh hadir dengan semua fungsionalitas server MCP tanpa repot penyiapan yang rumit atau instalasi lokal.

Manfaat utama:

  • ✅ Bekerja mulus di jaringan perusahaan tanpa khawatir tentang firewall atau biner atau di mana instalasi lokal tidak diizinkan.

  • ✅ Integrasi OAuth yang aman – tidak ada berbagi kata sandi atau penanganan kredensial manual.

Keterbatasan:

  • ❌ Tidak ada dukungan Pengujian Lokal (tidak dapat menguji aplikasi di belakang VPN, firewall, atau localhost). Jika Anda harus melakukan Pengujian Lokal, Anda harus menggunakan server MCP Lokal BrowserStack.
  • ❌ Latensi bisa sedikit lebih tinggi, tetapi tidak signifikan — Anda umumnya tidak akan menyadarinya dalam penggunaan normal.

Langkah Instalasi:

  • Di VSCode (Copilot - Mode Agen): .vscode/mcp.json:

    • Temukan atau Buat File Konfigurasi:

    • Di direktori root proyek Anda, cari folder bernama .vscode. Folder ini biasanya tersembunyi sehingga Anda perlu menemukannya seperti yang disebutkan di bagian perluasan.

    • Jika folder ini tidak ada, buatlah.

    • Di dalam folder .vscode, buat file baru bernama mcp.json

    • Untuk menyiapkan MCP Jarak Jauh BrowserStack alih-alih MCP Lokal BrowserStack, Anda dapat menambahkan konten JSON berikut :

      Remote MCP JSON file

      Cara Alternatif untuk Menyiapkan MCP Jarak Jauh

  • Langkah 1. Klik ikon roda gigi untuk Memilih Alat

    Select Tools
  • Langkah 2. Menu alat akan muncul di bagian tengah atas, gulir ke bawah pada menu di bagian atas lalu klik Tambah Server MCP

    Add MCP Server
  • Langkah 3. Klik opsi HTTP

    HTTP Option
  • Langkah 4. Tempel URL Server MCP Jarak Jauh: https://mcp.browserstack.com/mcp

    Remote MCP Server URL
  • Langkah 5. Berikan id server sebagai: browserstack

    Remote MCP Server ID
  • Langkah 6. Di VSCode, klik mulai Server MCP lalu klik "Izinkan"

    authentication1
    authentication2
    Sign_in_success

🤝 Klien MCP yang Direkomendasikan

  • Kami merekomendasikan penggunaan Github Copilot atau Cursor untuk kasus penggunaan pengujian + debugging otomatis.
  • Untuk kasus penggunaan pengujian manual (Pengujian Langsung), kami merekomendasikan penggunaan Claude Desktop.

⚠️ Catatan Penting

  • Server MCP BrowserStack sedang dalam pengembangan aktif dan saat ini mendukung sebagian dari spesifikasi MCP. Fitur lainnya akan segera ditambahkan.
  • Pemanggilan alat bergantung pada Klien MCP yang pada gilirannya bergantung pada LLM, sehingga mungkin ada beberapa perilaku non-deterministik yang dapat menyebabkan hasil yang tidak terduga. Jika Anda memiliki saran atau masukan, silakan buka isu untuk berdiskusi.

📝 Berkontribusi

Kami menyambut kontribusi! Silakan buka isu untuk mendiskusikan perubahan apa pun yang ingin Anda lakukan. 👉 Klik di sini untuk melihat Panduan Berkontribusi kami

📞 Dukungan

Untuk dukungan, silakan:

🚀 Fitur Lainnya Segera Hadir

Nantikan pembaruan menarik! Punya saran? Silakan buka isu untuk berdiskusi.