Skip to main content
Use the Jira Connector to ingest issues from Jira into the mAItion knowledge base.

​
What It Does

  • fetches issues from one or more Jira projects using a JQL query
  • converts issue content (summary, description) to Markdown for indexing
  • optionally ingests issue comments as separate indexed content
  • runs ingestion on configurable schedules

​
Authentication

Two authentication methods are supported:
  • Basic auth (auth_type: basic): uses an email address and an API token. Suitable for Jira Cloud. Generate a token at id.atlassian.com/manage-profile/security/api-tokens.
  • Personal Access Token (auth_type: token): uses a PAT as a Bearer token. Suitable for Jira Server, Data Center, and Jira Cloud.

​
Required Environment Variables

Set these in .env.rag:
  • JIRA1_SERVER_URL: base URL of your Jira instance (example: https://yourorg.atlassian.net)
  • JIRA1_API_TOKEN: API token (basic auth) or Personal Access Token (PAT auth)
  • JIRA1_EMAIL: Jira account email — required only when auth_type is basic
  • JIRA1_JQL: JQL query to select issues (example: project = MYPROJECT ORDER BY updated DESC)
  • JIRA1_SCHEDULES: ingestion interval in seconds (default: 3600)

​
config.yaml Example

​
Basic auth (Jira Cloud)

sources:
  - type: "jira"
    name: "jira1"
    config:
      server_url: "${JIRA1_SERVER_URL}"
      auth_type: "basic"
      email: "${JIRA1_EMAIL}"
      api_token: "${JIRA1_API_TOKEN}"
      jql: "${JIRA1_JQL}"
      max_results: 50           # optional, default 50
      load_comments: true
      max_comments: 10          # optional, default 10
      schedules: "${JIRA1_SCHEDULES}"

​
PAT auth (Jira Server / Data Center)

sources:
  - type: "jira"
    name: "jira1"
    config:
      server_url: "${JIRA1_SERVER_URL}"
      auth_type: "token"
      api_token: "${JIRA1_API_TOKEN}"
      jql: "${JIRA1_JQL}"
      max_results: 50           # optional, default 50
      load_comments: true
      max_comments: 10          # optional, default 10
      schedules: "${JIRA1_SCHEDULES}"

​
Configuration Reference

FieldRequiredDefaultDescription
server_urlyes—Base URL of your Jira instance
auth_typeyes—basic or token
emailwhen auth_type=basic—Jira account email
api_tokenyes—API token or Personal Access Token
jqlyes—JQL query to select issues
max_resultsno50Maximum number of issues to fetch
load_commentsnofalseWhether to ingest issue comments
max_commentsno10Maximum comments to include per issue
schedulesno3600Ingestion interval in seconds
request_delayno0Seconds to wait between API requests. Increase to avoid rate-limiting (e.g. 0.1)

​
Multiple Jira Sources

Add more sources entries (jira2, jira3, etc) with separate env vars per source.