Configuration

Environment Variables

Using .env File

Create a .env file in your project:

cp .env.example .env

Example .env contents:

JIRA_BASE_URL=https://your-instance.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token

API Token Generation

Jira Cloud

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
2. Click "Create API token"
3. Give it a descriptive label
4. Copy the generated token

Jira Server/Data Center

For Jira Server, you can use:

• Username and password
• Personal Access Token (PAT)
• Application password

Troubleshooting

Authentication Failed

• Verify your API token is correct
• Check that your email matches your Jira account
• Ensure your Jira base URL is correct (no trailing slash)

Connection Failed

• Verify your Jira instance is accessible
• Check network connectivity
• Ensure Jira REST API is enabled

Permission Denied

• Verify your account has the necessary permissions
• Check project permissions in Jira
• Ensure you're using the correct Jira instance

Debug Commands

# Test Jira connection
task jira:test

# List projects (test API connectivity)
task jira:projects

# Run MCP inspector for debugging
task inspector:dev