MaskPilot Documentation
Start with a question. Find a clear answer.
Follow clear steps to use MaskPilot and quickly find a solution when something goes wrong.
Type a keyword to filter guides and answers
Topic
Explore by topic
Browser Profiles and Fingerprint Settings
Learn how MaskPilot isolates cookies and site data, keeps browser fingerprints stable, assigns proxies and extensions, and applies profile changes after a full restart.
Proxy Management and Multi-Hop Routes
Learn how MaskPilot adds, imports, groups, assigns, and checks proxies, including authentication failures, upstream proxies, and multi-hop route troubleshooting.
Team Profile Sharing and Permissions
Learn how MaskPilot member setup, profile assignment, visibility, feature permissions, activity logs, and one-time sharing define secure team access.
Browser Extension Setup and Versions
Learn how MaskPilot installs, enables, and updates extensions per profile, checks browser compatibility, and manages store or local extension versions safely.
Profile Sync, Backup, and Recovery
Learn how MaskPilot handles local encrypted sync, cross-device recovery, device upload settings, version conflicts, the recycle bin, and updates.
Local AI Automation and Permissions
Learn how MaskPilot configures local MCP connections, bearer tokens, AI assistant permissions, operating boundaries, and ordered troubleshooting for failed calls.
Guide
Guides
Create your first browser profile
Configure the browser version, core fingerprint settings, proxy, and extensions for an isolated browser profile.
Read guide→Configure a Stable Browser Fingerprint
Choose fingerprint settings for the profile, keep them stable, and fully restart the browser so saved changes take effect.
Read guide→Share a Browser Profile Configuration
Create a one-time share of the browser version, entry proxy, and fingerprint settings while keeping browser data and extensions separate.
Read guide→Add, import, and assign proxies
Add HTTP, HTTPS, or SOCKS5 proxies, import a list of nodes, and choose a dedicated network exit for a browser profile.
Read guide→Organize Browser Profiles with Tags
Use MaskPilot profile tags, name search, and status filters to organize browser profiles, then safely start, stop, retag, or delete selected profiles in bulk.
Read guide→Add Team Members and Set Permissions
Add a member, assign visible profiles, and set profile, proxy, and AI automation permissions for the member's role.
Read guide→HTTP vs HTTPS vs SOCKS5 Proxy
Compare HTTP, HTTPS, and SOCKS5 proxy endpoints, choose the scheme supplied by your provider, and verify it before assigning it to a MaskPilot browser profile.
Read guide→Advanced proxies and multi-hop routes
Import third-party JSON or YAML proxy configurations, choose upstream proxies, and verify a complete route hop by hop.
Read guide→Install and manage browser extensions
Select a compatible extension version, attach it to profiles, and handle update or removal notices safely.
Read guide→Import a Local Browser Extension
Import a Manifest V3 extension from a folder or ZIP, review permissions and compatibility, and understand its device-only boundary.
Read guide→Manage and test proxies
Organize proxies with groups and notes, understand connection states, and safely edit, check, or delete nodes.
Read guide→Sync and recover browser profile data
Understand local encryption, cross-device recovery, version conflicts, device upload settings, and recovery after accidental deletion.
Read guide→Disable Profile Sync on One Device
Stop profile uploads from the current device, understand retained local and remote data, and turn synchronization back on safely.
Read guide→Connect local MCP to Codex
Enable MaskPilot local MCP, configure a bearer token, connect it to Codex, and verify local access and the available browser tools.
Read guide→Set up IPFoxy proxies
Get static or rotating IPFoxy connection details, then add, bulk import, check, and assign the proxies to browser profiles in MaskPilot.
Read guide→Manage AI Permissions and Tokens
Keep local MCP calls within account permissions, store the bearer token safely, and verify the tool list for the installed client version.
Read guide→Set up Bright Data proxies
Get a Bright Data zone host, protocol-specific port, and credentials, then add, check, and assign the connection in MaskPilot.
Read guide→Update the desktop client safely
Review release notes, verify and install an update, and respond correctly to staged or required upgrades.
Read guide→Set up Oxylabs proxies
Generate Oxylabs location and session endpoints, then add, bulk import, check, and assign the connections to profiles in MaskPilot.
Read guide→Set up kookeey proxies
Extract static or rotating kookeey connection details, then add, bulk import, check, and assign the proxies in MaskPilot.
Read guide→Set up Proxy302 proxies
Generate a region- and protocol-specific Proxy302 connection, then import its host, port, and credentials and assign it in MaskPilot.
Read guide→Set up QuarkIP proxies
Get QuarkIP static or rotating residential connection details, then import, check, and assign the correct protocol in MaskPilot.
Read guide→Q&A
Q&A
Why does a profile say it is in use?
Distinguish local running processes, remote run records, and data-version conflicts when launching or switching devices.
View answer→Why Didn’t My Profile Settings Apply?
Confirm a complete shutdown, the correct profile, and which fingerprint, proxy, or extension changes require a relaunch.
View answer→Why did the proxy check fail?
Use authentication, timeout, refused port, unsupported configuration, or failing-hop results to locate the problem.
View answer→Prevent WebRTC IP Leaks Through a Proxy
Keep WebRTC traffic on the assigned proxy route, understand MaskPilot's recommended network policy, restart the profile, and verify the result safely.
View answer→Why a Proxy Changes the Browser Time Zone
Learn how MaskPilot selects the browser time zone from the current proxy exit and troubleshoot overridden settings, route changes, or failed detection.
View answer→Why a Website Shows the Wrong Language
Troubleshoot differences between browser locale, request language order, and saved site preferences when a website keeps selecting the wrong language.
View answer→Extension Disabled After Browser Update
Separate browser-level disabling, permission changes, and version incompatibility, then restore the extension safely in MaskPilot.
View answer→Fix a profile that won’t start with a proxy
Troubleshoot a proxy that passed an earlier check but fails during launch, exit detection, or a changed multi-hop route.
View answer→Why a Website Shows the Wrong Location
Separate public-IP location, browser geolocation, and saved site preferences when a proxy exit is correct but a webpage still shows another place.
View answer→Use an Extension in One Profile Only
Separate installation, default scope, per-profile overrides, and the local device switch so an extension starts only in the browser profiles that need it.
View answer→Why Browser Screen Resolution Looks Wrong
Separate CSS screen size, device pixel ratio, available area, and browser viewport when a website reports a resolution that differs from the display.
View answer→Why Extension Settings Differ by Profile
Separate extension installation, profile selection, and runtime data to understand different settings and sign-in states across browser profiles.
View answer→Why the Canvas Fingerprint Changes
Understand the stability boundaries of profile-level canvas protection, then check the browser version, profile, test method, and launch state when results differ.
View answer→Why Font Fingerprints Stay Stable or Change
Understand font detection, profile-stable protection, and the visible-font allowlist when test hashes change, characters disappear, or webpages use fallback fonts.
View answer→Why Websites Ask You to Sign In Again
Separate site session expiry, cookie clearing, profile recovery, and the wrong browser profile when websites ask you to sign in again after a relaunch.
View answer→Fix a Failed or Corrupted Extension Install
Separate download, package verification, old installation data, and browser compatibility problems, then safely clear and redownload an extension in MaskPilot.
View answer→Why Is My WebGL GPU Different?
Check why a website reports an unexpected WebGL vendor or renderer, review MaskPilot's graphics-information setting, and verify changes after a full restart.
View answer→Why Is the Running Browser Version Newer?
Understand why MaskPilot may run a verified local browser version newer than the profile requirement and how to compare both labels safely.
View answer→Why Are Website Media Devices Different?
Understand why a website may list unexpected cameras, microphones, or speakers, then verify permissions and MaskPilot's media device profile safely.
View answer→Why Do CPU and Memory Values Differ?
Learn why websites may report CPU core and memory values that differ from the physical device, and how to verify MaskPilot profile settings safely.
View answer→Why Does Website Storage Differ from Disk?
Learn why a website's storage quota can differ from free disk space, then verify MaskPilot storage settings and browser storage behavior safely.
View answer→Fix a Stuck or Failed Browser Download
Identify the preparation, download, verification, installation, or launch stage that failed, then retry the browser version safely in MaskPilot.
View answer→Recover a deleted browser profile
Restore a profile from the MaskPilot recycle bin, then check primary-account access, plan capacity, proxy conflicts, and unsynced data.
View answer→Why Did the Web Audio Fingerprint Change?
Learn why Web Audio fingerprint results can change, how MaskPilot keeps one profile stable, and how to verify the same browser environment safely.
View answer→Fix a Failed Profile Preflight Check
Use the sign-in, browser, fingerprint, extension, proxy, and local-data results to fix a profile that MaskPilot blocks before launch.
View answer→Why Can’t a Team Member See a Profile?
Separate member status, profile assignment, and edit permissions to troubleshoot a profile missing from a team member's list.
View answer→Why Does the System Voice List Differ?
Learn why speechSynthesis voice lists can differ, how MaskPilot handles common platform voice aliases, and how to verify a profile after restart.
View answer→What Does a Browser Profile Copy Keep?
Learn which fingerprint, tag, and extension settings a MaskPilot profile copy keeps, and why it excludes proxies, cookies, sign-in state, and browser data.
View answer→Why Can’t a Team Member Edit a Profile?
Check profile assignment, profile editing, and proxy permissions when a team member can see a profile but cannot save changes.
View answer→Why Is a Team Action Pending Approval?
Understand a pending team action and check notifications, approval history, duplicate requests, runtime state, and review results.
View answer→How to See Who Changed a Browser Profile
Filter MaskPilot activity records by browser profile and action, identify the operator and time, and understand what the history does not prove.
View answer→Does Failed Restore Overwrite Local Data?
Learn when MaskPilot keeps usable local browser profile data after remote read, download, validation, or restore failures, and when launch stops.
View answer→Fix a Local MCP Connection Refused Error
Use the health endpoint, loopback address, caller environment, and access token to diagnose a refused or failed local MaskPilot MCP connection.
View answer→Fix Local Extension Manifest Import Errors
Diagnose a failed local extension import by checking the folder or ZIP structure, manifest format, required metadata, permissions, and browser compatibility.
View answer→Restore a Previous Local Profile Backup
Use the previous local backup shown in data backup status to roll browser data back before the next launch, with clear queue, sync, and failure boundaries.
View answer→Why a Website Cannot Reach a Local Port
Learn why a website may fail to reach localhost, how MaskPilot local port protection works, and how to separate profile settings from browser permissions.
View answer→Why Do Touch and Hover Signals Differ?
Learn how websites compare touch points with CSS pointer and hover signals, then verify the MaskPilot input-device setting after a full restart.
View answer→Why Is a Profile Still Saving After Close?
Understand why MaskPilot shows Saving while it finalizes, encrypts, or uploads profile data after browser exit, and when it is safe to relaunch or switch devices.
View answer→Keep Local or Cloud Data in a Conflict?
Decide whether to keep local or cloud profile data after a MaskPilot sync conflict, queue the safe resolution, and cancel a mistaken choice before it runs.
View answer→Keep Extension ID Stable on Reimport
Understand why an unpacked extension ID can change, how MaskPilot preserves the existing identity during reimport, and when a new ID is expected.
View answer→Fix an “Invalid token” MCP response
Verify the current token, environment variable, and caller process without exposing credentials in logs.
View answer→How to Review Local Extension Permissions
Learn how MaskPilot separates website access, browser capabilities, minimum browser requirements, and newly added access when you import or replace a local extension.
View answer→What does “Unknown tool” mean in MCP?
Use the list returned by the current client, verify the tool name and version, and separate a missing tool from a denied call.
View answer→Fix a failed client update or download
Keep the working client, check network and disk conditions, and never run an installer that failed verification.
View answer→Fix an “MCP permission required” Error
Separate MaskPilot MCP account access, sign-in state, bearer-token authentication, and resource permissions to recover a rejected local AI automation call safely.
View answer→Free Space Used by Browser Kernels
Review local browser-kernel storage in MaskPilot and safely remove unused old versions without deleting profile data or the latest usable kernel.
View answer→No matching content. Try a shorter or different keyword.