bcs-mcp-atlassian 0.0.1.dev556

The Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification. This project enables secure, contextual AI interactions with Atlassian tools while maintaining data privacy and security. Key features include:

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

Confluence Demo

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

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": "[e-mail]",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[e-mail]",
        "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

Topic	Description
Installation	uvx, Docker, pip, from source
Authentication	API tokens, PAT, OAuth 2.0
Configuration	IDE setup, environment variables
HTTP Transport	SSE, streamable-http, multi-user
Tools Reference	All Jira & Confluence tools
Troubleshooting	Common issues & debugging

Compatibility

Product	Deployment	Support
Confluence	Cloud	Fully supported
Confluence	Server/Data Center	Supported (v6.0+)
Jira	Cloud	Fully supported
Jira	Server/Data Center	Supported (v8.14+)

Key Tools

Jira	Confluence
jira_search - Search with JQL	confluence_search - Search with CQL
jira_get_issue - Get issue details	confluence_get_page - Get page content
jira_create_issue - Create issues	confluence_create_page - Create pages
jira_update_issue - Update issues	confluence_update_page - Update pages
jira_transition_issue - Change status	confluence_add_comment - Add comments

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.