mcpXmcpXDocs

mcpX product documentation

Connect the Chrome extension

Install mcpX from the Chrome Web Store and pair it with the local server.

The extension receives browser requests from the mcpX server and performs them in the tab you or your MCP client selects.

Install from the Chrome Web Store

  1. Open the mcpX Chrome Web Store listing.
  2. Select Add to Chrome and approve the requested permissions.
  3. Open Chrome's extensions menu and pin mcpX to the toolbar.

Connect to the local server

  1. Make sure your AI client has started the mcpX MCP server.
  2. Open the mcpX extension popup.
  3. Select Connect browser.

The mcpX extension showing the Connect browser control

The official extension discovers the active loopback port and receives a local pairing credential automatically. Normal setup does not require copying a token or choosing a port. Later server launches can reconnect with the saved pairing.

Connection states

StateMeaning
ConnectedThe extension is paired and ready to receive browser tools.
SearchingThe extension is checking the local discovery ports.
DisconnectedNo active local server connection exists. Start mcpX in your AI client and retry.

Unpacked development extension

If you intentionally loaded an unpacked extension, copy its ID from chrome://extensions and start the server with that explicit trust setting:

MCPX_EXTENSION_ID=<unpacked-extension-id> npx @rpx_/mcpx@latest

Manual token and port controls are recovery options under Advanced options; they are not part of normal installation.

Disconnect or forget pairing

  • Disconnect ends the current connection but keeps the local pairing.
  • Forget pairing removes the saved credential and requires a new pairing.
  • Disabling or uninstalling the extension prevents further browser access.

Continue to Run your first workflow.