MCP Atlassian

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). Supports both Cloud and Server/Data Center deployments.

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

Quick Start

1. Get Your API Token

Go to https://id.atlassian.com/manage-profile/security/api-tokens and create a token.

For Server/Data Center, use a Personal Access Token instead. See Authentication.

2. Configure Your IDE

Add to your Claude Desktop or Cursor MCP configuration:

{
  "mcpServers": {
    "bcs-mcp-atlassian": {
      "command": "uvx",
      "args": ["bcs-mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Server/Data Center users: Use JIRA_PERSONAL_TOKEN instead of JIRA_USERNAME + JIRA_API_TOKEN. See Authentication for details.

Optional — content masking: To send Jira/Confluence text content through an external mask/verification service before returning it to the client, set CONTENT_MASK_SERVICE_URL to the service endpoint (e.g. https://apis.tusvc.bcs.ru/mai-ms-masking-it-proxy/mask/chat). If unset, content is returned as-is.

Optional — log file: To write server logs to a file (e.g. to view them in Cursor when the MCP client panel does not show server stderr), set MCP_LOG_FILE to a file path (e.g. bcs-mcp-atlassian.log). Logs are appended to the file in UTF-8.

Running with local code (e.g. in Cursor): To avoid "program not found" when Cursor spawns the process (wrong working directory or uv not in PATH), use the wrapper script as command with the full path to this repo:

"bcs-mcp-atlassian": {
  "command": "C:\\Users\\Anton\\Downloads\\atlassian\\bcs-mcp-atlassian-bcs\\run-bcs-mcp-atlassian.bat",
  "args": [],
  "env": {
    "JIRA_URL": "https://jira.bcs.ru",
    "JIRA_PERSONAL_TOKEN": "<your-token>",
    "CONFLUENCE_URL": "https://confluence.bcs.ru",
    "CONFLUENCE_PERSONAL_TOKEN": "<your-token>",
    "CONTENT_MASK_SERVICE_URL": "https://apis.tusvc.bcs.ru/mai-ms-masking-it-proxy/mask/chat"
  }
}

Replace the path with your actual clone path. The script run-bcs-mcp-atlassian.bat switches to the project directory and runs uv run bcs-mcp-atlassian there. If your workspace root is this folder and uv is in PATH, you can instead use "command": "uv" and "args": ["run", "bcs-mcp-atlassian"].

3. Start Using

Ask your AI assistant to:

• "Find issues assigned to me in PROJ project"
• "Search Confluence for onboarding docs"
• "Create a bug ticket for the login issue"
• "Update the status of PROJ-123 to Done"

Documentation

Full documentation is available at bcs-mcp-atlassian.soomiles.com.

Documentation is also available in llms.txt format, which LLMs can consume easily:

• llms.txt — documentation sitemap
• llms-full.txt — complete documentation

Compatibility

Key Tools

72 tools total — See Tools Reference for the complete list.

Security

Never share API tokens. Keep .env files secure. See SECURITY.md.

Contributing

See CONTRIBUTING.md for development setup.

License

MIT - See LICENSE. Not an official Atlassian product.