Jira Connector
Connect to Atlassian Jira to index issues, comments, and project data.
Overview
The Jira connector supports:
- Jira Cloud and Server/Data Center
- Issues with full field content
- Comments and worklogs
- JQL-based filtering
Prerequisites
- Jira Cloud or Server instance
- User account with browse project access
- API token (Cloud) or credentials (Server)
Authentication
Jira Cloud
- Create API token at Atlassian Account
- Use email + API token
Jira Server
Use username and password authentication.
Configuration
| Setting | Description |
|---|---|
| Instance URL | Jira instance URL |
| Account email | |
| API Token | Generated token |
| JQL Filter | Query to filter issues |
Setup Steps
- Add Connector: Knowledge → Add Data Source → Jira
- Enter Credentials: Instance URL and API token
- Set JQL Filter: Define which issues to sync
- Configure Options: Comments, attachments
- Test & Create: Verify and save
JQL Filtering
Use JQL to filter issues:
project = "ENGINEERING" AND status != Closed
project in (ENG, PROD) AND created >= -90d
labels = documentation
Content Indexed
| Content | Included |
|---|---|
| Issue summary/description | Yes |
| Comments | Optional |
| Attachments | Optional |
| Custom fields | Yes |
| Worklogs | Optional |
Best Practices
- Use JQL to filter relevant issues
- Exclude closed/archived issues
- Include comments for context
- Focus on documentation-related issues
Troubleshooting
Authentication failed: Verify API token and email
No issues found: Check JQL filter syntax
Missing fields: Verify field-level permissions