Setting up IDEs (desktop clients)
← Back to the getting started guide
If you're using a local development environment such as VS Code, Cursor, or another IDE that supports the Message Context Protocol (MCP), this guide will walk you through connecting your editor to the Atlassian Remote MCP Server.
This setup uses a Node.js based proxy tool called mcp-remote
, which handles authentication and communication with the server.
Before you begin
Ensure the following are installed or accessible:
Node.js v18 or later
npx for installation
An Atlassian Cloud site with Jira, Compass, and/or Confluence
A supported IDE (for example, VS Code, Cursor)
A modern browser to complete the OAuth flow
Installation and configuration
VS Code
You can configure VS Code to use the Atlassian MCP server in two ways: using the integrated MCP extension UI or by manually editing your configuration file.
Option 1: From the MCP directory
Search for and install the Atlassian MCP provider from the marketplace
Option 2: Use the VS Code command palette
Open the command palette in VS Code
Run the command
MCP: Add Server
Select Http or Server-sent Events as the connection type
Enter the server URL:
https://mcp.atlassian.com/v1/sse
Provide a name for the server (for example,
atlassian-mcp-server
)
Option 3: Add a mcp.json
file manually
You can also create a mcp.json
file in your workspace or home directory:
{
"servers": {
"atlassian-mcp-server": {
"url": "https://mcp.atlassian.com/v1/sse",
"type": "http"
}
},
"inputs": []
}
For the most up-to-date instructions and options, including recent UI changes or advanced configuration tips, visit the official VS Code MCP documentation.
Cursor
To use Atlassian MCP with Cursor, follow these steps:
Open Cursor’s MCP settings panel
Add the following configuration:
"Atlassian-MCP-Server": { "url": "https://mcp.atlassian.com/v1/sse" }
For older version of Cursor, you may need to use the following configuration
"mcp-atlassian-api": { "command": "npx", "args": [ "mcp-remote", "https://mcp.atlassian.com/v1/sse" ] }
Save and restart Cursor’s AI assistant or tools pane.
Cursor updates frequently. Check the official Cursor MCP documentation for the latest supported features and setup advice.
Other desktop clients
If you're using a legacy or custom MCP-compatible IDE or tool, connect using the mcp-remote
proxy as follows:
Open your terminal
Run:
npx -y mcp-remote https://mcp.atlassian.com/v1/sse
Note: If this command doesn't work due to a version-related issue, try specifying an older version of mcp-remote. The example below uses version
0.1.13
, but you may use another version if needed:npx -y mcp-remote@0.1.13 https://mcp.atlassian.com/v1/sse
Configure your client's settings with this format:
"mcp.servers": { "atlassian": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/sse"] } }
Authenticate when prompted and leave your terminal session open
Follow your client’s documentation to trigger or test an MCP action
Tips for a successful setup
Keep your terminal session running while using the IDE
If your token expires, re-run the
mcp-remote
commandMake sure your IDE’s MCP tooling is installed and enabled
Example actions you can try
Search Jira: “Find all issues assigned to me in the last 7 days”
Create a Confluence page: “Create a page titled ‘Engineering Roadmap Q4’”
Cross-reference: “Link the two most recent bugs to the 'Sprint 45' page”
Need help? Contact Atlassian Support or return to the getting started guide.
Was this helpful?