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→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→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 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→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→No matching content. Try a shorter or different keyword.