Prerequisites
- Active PlayerZero account with project access
- Editor or Owner permissions in that project
- An MCP-compatible AI assistant (VS Code, Copilot, Cursor, etc.)
Step 1: Create an MCP Token
-
Open Project Settings
- Log in at https://playerzero.ai
- Choose your organization & project
- Navigate to Settings → MCP Tokens
-
Generate Token
- Click New Token
- Give it a descriptive name, e.g.
Cursor MCP
orClaude Desktop
- Click Create Token
- Copy & store the token immediately – it won’t be shown again.
-
Token details
- Expires in 90 days
- Scoped to one project
- Create multiple tokens for different tools or teammates
Step 2: Configure Your MCP Client
Use the following syntax:Step 3: Available Tools
playerzero_status
: Tests your connection to PlayerZero.
- “true” if connection is successful
- Error message if there are authentication or connection issues
ask_playerzero
: Query your codebase using PlayerZero’s AI.
Parameters:
query
(required): Your question about the codebaseplayerId
(optional): Continue existing conversationlastMessageId
(optional): Resume from specific message Usage Examples:
Step 4: Best Practices
Conversation Continuity
Conversation Continuity
- The ask_playerzero tool returns playerId and lastMessageId in responses
- Use these values in subsequent queries to maintain conversation context
- This enables more accurate and contextual responses
Query Optimization
Query Optimization
- Be specific in your questions for better results
- Ask about particular files, functions, or architectural patterns
- Use follow-up questions to dive deeper into specific areas
- Visit our Prompting Guides for more tips!
Token Management
Token Management
Token Management
- Rotate tokens regularly (every 60-90 days)
- Use descriptive names to track token usage
- Delete unused tokens to maintain security
- Each team member should have their own token
Security Considerations
- Token Security: Store MCP tokens securely and never commit them to version control
- Project Scope: Tokens only provide access to the specific project they were created for
- Audit Trail: All MCP interactions are logged in your PlayerZero project
- Expiration: Tokens automatically expire after 90 days for security