Skip to main content
Browser Testing Push a PR → Morph tests your preview → posts video to PR.

​
Setup

1

Connect GitHub

Install the GitHub App and select your repositories.
2

Connect Vercel

If you’re on Vercel Pro/Enterprise, Deployment Protection blocks external access to previews by default.
  1. Connect Vercel
  2. Select projects to grant access
  3. Click Get Bypass Secret for each project
A token that lets automation access protected previews. Generate one in Vercel: Project → Settings → Deployment Protection → Protection Bypass for Automation.

​
Options

OptionDescription
Site authTest credentials for previews behind login. Use x_user/x_pass in prompts.
Path filtersOnly test PRs touching specific paths
Check runsBlock merges until tests pass
Configure in the integrations dashboard.

​
FAQ

Two options:Credentials — Add username/password in integrations page. Reference as x_user and x_pass in prompts.Cookies — For complex auth (SSO, MFA), export session cookies from DevTools and paste as JSON in the integrations page.
Vercel Deployment Protection is blocking access. Connect Vercel and add the bypass secret for your project.
Yes. Use the GitHub Action for custom deployments:
- uses: morphllm/preview-test-action@v1
  with:
    api-key: ${{ secrets.MORPH_API_KEY }}
    preview-url: ${{ steps.deploy.outputs.url }}
See full action docs below.

​
GitHub Action

For non-Vercel deployments: 
name: Preview Test
on: pull_request

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Deploy
        id: deploy
        run: echo "url=https://pr-${{ github.event.number }}.example.com" >> $GITHUB_OUTPUT

      - uses: morphllm/preview-test-action@v1
        with:
          api-key: ${{ secrets.MORPH_API_KEY }}
          preview-url: ${{ steps.deploy.outputs.url }}
          instructions: Test login and checkout flow  # optional
Requires the GitHub App installed and MORPH_API_KEY in repo secrets.

Browser Automation

Direct control, live sessions, recordings

Browser as Agent Tool

Add browser to your AI agents