jira-connector

jira-connector

Authenticates against Jira Cloud and validates that the configured board and project are accessible before any sprint data is fetched.

Required Environment Variables

Variable	Description
JIRA_BASE_URL	Jira Cloud base URL, e.g. https://your-org.atlassian.net
JIRA_EMAIL	Account email used for Basic Auth
JIRA_API_TOKEN	API token (not account password)

If any variable is missing, halt immediately:

ERROR: Jira authentication requires three environment variables:
  JIRA_BASE_URL   — e.g. https://your-org.atlassian.net
  JIRA_EMAIL      — your Jira account email
  JIRA_API_TOKEN  — create at: id.atlassian.com/manage-profile/security/api-tokens

Run /sprint-init to verify your setup.

Authentication Method

Jira Cloud uses HTTP Basic Auth with email + API token:

Authorization: Basic base64(JIRA_EMAIL:JIRA_API_TOKEN)
Content-Type: application/json

Validation Steps

1. Validate base URL — check JIRA_BASE_URL is a valid HTTPS URL ending with .atlassian.net
2. Test connectivity — GET {baseUrl}/rest/api/3/myself to verify credentials
3. Validate board access — GET {baseUrl}/rest/agile/1.0/board/{boardId} to confirm board exists and is accessible
4. Validate project access — GET {baseUrl}/rest/api/3/project/{projectKey} to confirm project exists

For each validation failure, emit a specific error message describing which check failed and what to verify.

Output

{
  "authenticated": true,
  "baseUrl": "https://your-org.atlassian.net",
  "boardId": 42,
  "projectKey": "PROJ",
  "boardName": "PROJ Sprint Board",
  "projectName": "My Project"
}