Connectors (Jira + Google Docs)

Pulls user stories from Jira or Google Docs and pushes structured test cases to TestRail. Keeps tokens in memory. Syncs hourly. Setup requires Jira, Google, and TestRail credentials.

This page explains how to:

• Pull user stories and acceptance criteria from Jira Cloud or Jira Server and Google Docs.

• Generate structured test cases and push them into TestRail, preserving section hierarchy.

• Keep API tokens in memory only; nothing is written to disk.

Prerequisites

• Jira project admin rights and a personal access token (PAT).

• Google Workspace service account JSON (if Docs are used).

• TestRail user with an API key and add_cases permission.

1. Enable Jira Access

1. In Jira: Profile → Personal Access Tokens → Create Token.

2. Copy the Base URL (for example https://<<company>>.atlassian.net) and the PAT.

2. Enable Google Docs Access

1. Create a service account in Google Cloud IAM.

2. Download the service‑account.json.

3. Share each source document or parent folder with the service‑account email.

3. Configure GPT Driver

1. Settings → Integrations → Connectors → Requirements.

2. Paste the Jira Base URL and PAT.

3. Upload the service‑account.json if Google Docs is enabled.

4. Click Test Connection – a sample requirement is pulled and shown.

4. Configure TestRail Output

1. In TestRail: My Settings → API Keys → Add Key.

2. Note the Project ID or Suite ID to receive cases.

3. Back in GPT Driver: Settings → Integrations → Connectors → TestRail.

4. Enter the TestRail URL, user email, and API key.

5. Click Test Connection – a dummy case is posted and then deleted.

5. Save Settings

All new or updated Jira issues labeled ready‑for‑qa are now synced hourly. Trigger an immediate run with Sync Now.

Good To Know

• Field mapping is fixed by default (see below) but custom maps can be added per project.

• Attachments larger than 5 MB are ignored.

• Connection errors generate an alert in Settings → Health.

Default Field Mapping

Jira / Docs Field	GPT Driver Field
summary	title
acceptanceCriteria	steps
priority	priority
component	tags[]
jiraKey	externalRef

---