Polarion MCP Server

Instructions

Implementation Reference

• polarion_mcp/server.py:71-94 (handler)

  MCP tool handler for open_polarion_login, decorated with @mcp.tool() which also serves as registration. Calls the client helper to open the login page.
  @mcp.tool() def open_polarion_login() -> str: """ <purpose>Open Polarion login page in browser for manual authentication</purpose> <when_to_use> - When you need to authenticate with Polarion for the first time - When existing token has expired (401 errors) - When check_polarion_status() shows no valid token </when_to_use> <workflow_position> STEP 1: Use this tool first if you don't have authentication STEP 2: Complete login in browser and generate token STEP 3: Use set_polarion_token() with the generated token STEP 4: Use check_polarion_status() to verify authentication STEP 5: Begin exploring with get_polarion_projects() </workflow_position> <output>Instructions for manual authentication process</output> """ logger.info("Opening Polarion login page for manual authentication") return polarion_client.open_login_page()
• polarion_mcp/client.py:89-115 (helper)

  Core helper method in PolarionClient that opens the browser to the Polarion login URL and returns JSON instructions for token generation.
  def open_login_page(self) -> str: """Open Polarion login page in user's browser for manual authentication""" try: webbrowser.open(LOGIN_URL) return json.dumps({ "status": "success", "message": f"Polarion login page opened in your browser: {LOGIN_URL}", "instructions": [ "1. Complete the login form in your browser", "2. After successful login, navigate to: " + TOKEN_PAGE_URL, "3. Generate a new token manually", "4. Copy the token and use it with the 'set_polarion_token' command" ], "login_url": LOGIN_URL, "token_page_url": TOKEN_PAGE_URL, "note": "If you get an 'Internal server error', try refreshing the page or check if the Polarion instance is accessible" }, indent=2) except Exception as e: logger.error(f"Failed to open login page: {e}") return json.dumps({ "status": "error", "message": f"Failed to open login page: {e}", "manual_url": LOGIN_URL }, indent=2)