I don’t see the Atlassian MCP being enabled for my Katalon Studio (Version : 10.4.3) . There are not tools showing up as well under this MCP. Has anybody experienced this issue?
Yes, this is a known issue that affects Katalon Studio users, particularly on macOS machines. The Atlassian MCP server fails to enable and tools don’t appear after upgrading Katalon Studio to version 10.4.3 or later. This occurs because the application signature changes during the upgrade, preventing access to the cached MCP authentication token stored in the OS secure storage.
Solution
Follow these steps to resolve the issue:
Step 1: Delete the Cached MCP Token
-
Locate the
.katalonfolder on your machine:- Path:
/Users/<user_name>/.katalon - Tip: Since
.katalonis a hidden folder, use Command+Shift+. (period) in Finder to view hidden folders
- Path:
-
Navigate to the
studioassistsubfolder within.katalon -
Delete the
session.propertiesfile — This file contains the cached MCP token causing the connection issue
Step 2: Re-add the Atlassian MCP Server
-
Restart Katalon Studio after deleting the file
-
Click the setup panel for MCP servers icon next to Agent Mode in StudioAssist
-
Click “Add MCP Server” and fill in these details:
- Transport Type:
HTTP - Server URL:
https://mcp.atlassian.com/v1/mcp - Name:
atlassian-mcp-server(no spaces or special characters) - Title (Optional):
Atlassian MCP Server
- Transport Type:
-
Click OK — The server will load and display an authorization prompt
-
Click “Authorize” and complete the OAuth authentication when redirected to Atlassian’s authentication site
Step 3: Reload the MCP Server
Once authentication is complete, return to Katalon Studio and click the Reload button next to the Atlassian MCP Server to fetch its tools. The tools should now appear in your MCP tool list.
Key Considerations
- macOS-specific issue: This problem is primarily documented for macOS machines due to how the OS secure storage handles application signatures.
- Version 10.4.0+: Starting from Katalon Studio 10.4.0, support for authentication-required MCP servers (like Atlassian) was introduced, which is why this issue may appear after upgrading.
- Token expiration: If the server’s token expires in the future, Katalon Studio will remind you to re-grant authorization — simply click Authorize again.
- Connection issues: If the server doesn’t load properly, use the Reload button to retry the connection.
References
You can watch this free course to see how to connect with Atlassian MCP servers: Katalon Studio AI agent: Expanding with external MCP server
Hope this helps.
Enable Steps
- Open StudioAssist (Ctrl/Cmd + K or sidebar icon).
- Switch to Agent Mode (toggle in chat interface).
- Click + Add MCP Server > Search/enter “Atlassian” or URL (e.g., your Jira MCP endpoint).
- Authorize via OAuth (redirects to Atlassian login; grant permissions).
Troubleshooting
- No tools showing: Ensure Enterprise license (free lacks full Agent mode). Restart Studio; check Help > Check for Updates (10.4.0+ required).
- Not listed: Use custom HTTP MCP: Paste Atlassian SSE MCP URL from dashboard. Test connection; if fails, verify Jira API token perms
this course is the most straightforward path to try the atlassian mcp integration
