Skip to main content

​
Prerequisites

  • Active PlayerZero account with project access
  • Editor or Owner permissions in that project
  • Google Chrome browser (version 88 or later)

​
Step 1: Install the Extension

  1. Open Google Chrome
  2. Visit the Chrome Web Store and search for PlayerZero
  3. Click Add to Chrome
  4. Click Add Extension when prompted
  5. The PlayerZero icon will appear in your Chrome toolbar

​
Step 2: Create a Personal Access Token

The Chrome extension authenticates with a Personal Access Token. When you create it, select the Chrome Extension permission. The same token type also authenticates the PlayerZero MCP server, so you can select MCP instead when you set up that access.
  1. Open Token Settings
    • Log in at playerzero.ai
    • Navigate to Settings → User Settings → Personal Access Tokens
  2. Create a New Token
    • Click New Token
    • Choose how you will use it: Chrome Extension or MCP
    • Give it a descriptive name
  3. Set the Project Scope
    • For a Chrome Extension token, choose all of your projects or select specific projects where the token is accepted
    • For an MCP token, scope it to the single project it can reach
  4. Copy the Token
    • Click Create Token
    • Copy and store the token immediately. It won’t be shown again.
    • Personal Access Tokens start with pz_pat
Each team member should create their own token.

​
Step 3: Connect the Extension

  1. Open the side panel
    • Click the PlayerZero icon in your Chrome toolbar to open the side panel
  2. Enter your token
    • You’ll land on the Settings screen
    • Paste your Personal Access Token into the token field
    • Click Save
  3. Select a project
    • After saving your token, the extension loads your available projects
    • Use the project dropdown at the top to select which project you’re working in
    • Your selection is saved and persists across browser sessions
  4. Verify connection
    • Navigate to any webpage
    • The floating toolbar should appear near the bottom of the page when the side panel is open
    • The extension badge may show a number if you have active Threads needing input

​
Step 4: Verify It’s Working

Try a quick test to confirm everything is connected:
  1. Open any webpage you’d like to analyze
  2. Open the side panel (click the PlayerZero icon)
  3. Click the full page capture button on the floating toolbar (page icon with a plus)
  4. Type a question like “What does this page do?” in the side panel
  5. Click Submit — a new Channel will be created
If the Channel starts successfully, you’re all set.

​
Best Practices

  • If you lose your token, you can regenerate it from the kebab menu in the PAT table
  • Use descriptive names to track which token is used where
  • Each team member should have their own token
  • Delete unused tokens from Settings → User Settings → Personal Access Tokens
  • Capture before asking: Attach page context to give the AI Player more to work with
  • Use partial capture to focus on a specific error message, component, or section rather than the full page
  • Check the badge — the orange badge count tells you how many Threads need your input
  • The extension needs access to all URLs to render the floating toolbar and capture page content
  • It communicates only with playerzero.ai — no data is sent to third parties
  • Page content is converted to a readable format locally in the browser before being sent to the API

​
Troubleshooting

The toolbar only appears when the side panel is open. Click the PlayerZero icon in your Chrome toolbar to open it. If the side panel is already open and you still don’t see the toolbar, try refreshing the page.
  • Ensure the token starts with pz_pat — tokens without this prefix will be rejected
  • Check that the token hasn’t expired
  • Verify you have Editor or Owner permissions on the project
  • Generate a new token if needed from Settings → User Settings → Personal Access Tokens in the web app
You’re in partial capture mode. Press Escape to exit and return to normal browsing.
Some websites have strict Content Security Policies that may interfere with the extension’s ability to read page content. This is a browser-level restriction. Try using full page capture instead of partial capture, or manually describe the page content in your question.
The badge updates every 30 seconds and requires a valid token. If your token has expired or been removed, the badge will clear. Re-enter a valid token in the extension settings.

​
Security

  • Token security: Store your Personal Access Token securely and never share it
  • Project scope: Tokens only provide access to the specific project they were created for
  • Data handling: Captured page content is processed locally in the browser and sent to PlayerZero over HTTPS
  • Expiration: Tokens automatically expire after 90 days

​
Learn More

👉 Chrome Extension features 👉 AI Player overview 👉 Jump to the app