Troubleshooting and verifying your setup
← Back to the getting started guide
Once you've completed the setup for your MCP client, it's important to confirm that your connection is working correctly. This guide walks you through validation steps, common symptoms of problems, and how to resolve them.
Quick checks
Try these simple actions to verify your setup:
Claude: Open a new chat, go to Search & Tools, and ask “List my Jira issues.”
IDE: Use the command palette or sidebar to access Jira or Confluence.
If the connection is successful, you should receive content back from your Atlassian site, based on your access permissions.
Expected results
When things are working properly, you should observe the following:
Claude: Displays AI-generated responses referencing live Jira or Confluence data.
IDE: Shows file tree integration or in-editor search tools.
If nothing happens, you likely have a permissions issue or authentication failure.
Common setup problems
Symptom | Likely cause | How to fix it |
|---|---|---|
No response in Claude or IDE | Tools not enabled or session not authorized | Re-run the connection flow and enable Jira/Confluence tools |
Access denied or errors | Insufficient site or product permissions | Confirm you have access to Jira or Confluence in Atlassian Admin |
Empty or partial results | Token expired or missing scopes | Re-authenticate and check scope approval during login |
OAuth loop or redirect error | Browser blocking pop-ups or blocked redirect URI | Allow |
Re-authenticating
If your token expires, your session will silently fail. You may need to:
Re-run the setup command (for example,
npx mcp-remote) to trigger a new loginClose and reopen your Claude chat to restart the flow
Review the scopes you’ve approved and ensure they match your intended use
Still stuck?
Check the logs from your MCP client or CLI terminal for additional error messages.
Verify that your Atlassian Cloud site is accessible and not restricted by VPN or network filters.
Ask your site admin to verify your user access.
Need help? Contact Atlassian Support or return to the getting started guide.
Was this helpful?