Setup¶
Get Your Atlassian Credentials¶
Atlassian Cloud¶
- Go to Atlassian Account Settings
- Create a new API token
- Note your email address (username)
- Note your Atlassian URL (e.g.,
https://example.atlassian.net)
Atlassian Data Center¶
Use your regular username and password, or configure an application link.
Configure Credentials¶
Option 1: Environment Variables¶
export ATLASSIAN_URL="https://example.atlassian.net"
export ATLASSIAN_USERNAME="user@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"
Option 2: Command-Line Flags¶
mcp-atlassian --base-url https://example.atlassian.net \
--username user@example.com \
--api-token your-api-token
Option 3: Vault-Backed Credentials¶
For production use, store credentials in a vault:
# 1Password
export OP_SERVICE_ACCOUNT_TOKEN="ops_..."
mcp-atlassian --vault op://MyVault --credentials-name atlassian \
--base-url https://example.atlassian.net
# Bitwarden
export BW_ACCESS_TOKEN="..."
export BW_ORGANIZATION_ID="..."
mcp-atlassian --vault bw://org-id --credentials-name atlassian \
--base-url https://example.atlassian.net
# Keeper
export KSM_TOKEN="US:..."
mcp-atlassian --vault keeper:// --credentials-name atlassian \
--base-url https://example.atlassian.net
See Credentials for detailed configuration options.