328 lines
12 KiB
Markdown
328 lines
12 KiB
Markdown
|
---
|
||
|
|
name: jira
|
||
|
|
description: Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
|
||
|
|
---
|
||
|
|
|
||
|
|
# Atlassian / JIRA Reference
|
||
|
|
|
||
|
|
## Domain
|
||
|
|
`reltio.jira.com` — use for all browse links, e.g. `https://reltio.jira.com/browse/RP-XXXXX`
|
||
|
|
|
||
|
|
## Cloud ID
|
||
|
|
`444c13e0-0faa-4055-b053-501700bae7b0`
|
||
|
|
|
||
|
|
## Current User (Brian Galura)
|
||
|
|
- account_id: `712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b`
|
||
|
|
- email: brian.galura@reltio.com
|
||
|
|
|
||
|
|
## Project
|
||
|
|
- key: `RP` (Reltio Platform), id: `10041`
|
||
|
|
- key: `ICR` (Infrastructure Change Request), id: `12890`
|
||
|
|
|
||
|
|
## Issue Types (RP project)
|
||
|
|
| Name | ID | Hierarchy | Notes |
|
||
|
|
|----------------|-------|-----------|------------------------------|
|
||
|
|
| Epic | 5 | 1 | Parent of stories |
|
||
|
|
| Story | 6 | 0 | Standard work item |
|
||
|
|
| Rollout Story | 10535 | 0 | Feature enablement per env |
|
||
|
|
| Task | 3 | 0 | |
|
||
|
|
| Bug | 1 | 0 | |
|
||
|
|
| Sub-Task | 9 | -1 | Child of other issue types |
|
||
|
|
|
||
|
|
## Required Fields by Issue Type
|
||
|
|
|
||
|
|
### Epic (required)
|
||
|
|
| Field | Key | Type |
|
||
|
|
|------------------------|--------------------|-------------------|
|
||
|
|
| Assignee | `assignee` | user |
|
||
|
|
| Type of Effort | `customfield_15815`| option (select) |
|
||
|
|
|
||
|
|
### Story (required)
|
||
|
|
| Field | Key | Type |
|
||
|
|
|------------------------|--------------------|-------------------|
|
||
|
|
| Assignee | `assignee` | user |
|
||
|
|
| Found/Requested By | `customfield_11922`| option (select) |
|
||
|
|
| Affected Documentation | `customfield_12429`| array of options |
|
||
|
|
| Acceptance Criteria | `customfield_15956`| **ADF** (rich text, must use Atlassian Document Format) |
|
||
|
|
| Type of Effort | `customfield_15815`| option (select) |
|
||
|
|
|
||
|
|
### Task (required)
|
||
|
|
| Field | Key | Type |
|
||
|
|
|------------------------|--------------------|-------------------|
|
||
|
|
| Assignee | `assignee` | user |
|
||
|
|
| Components | `components` | array of component (`[{"id": "..."}]`) |
|
||
|
|
| Found/Requested By | `customfield_11922`| option (select) |
|
||
|
|
| Type of Effort | `customfield_15815`| option (select) |
|
||
|
|
|
||
|
|
### Rollout Story (required)
|
||
|
|
| Field | Key | Type |
|
||
|
|
|------------------------|--------------------|-------------------|
|
||
|
|
| Assignee | `assignee` | user |
|
||
|
|
| Found/Requested By | `customfield_11922`| option (select) |
|
||
|
|
| Affected Documentation | `customfield_12429`| array of options |
|
||
|
|
| Execution team | `customfield_13020`| option (select) |
|
||
|
|
| Type of Effort | `customfield_15815`| option (select) |
|
||
|
|
|
||
|
|
### Change Request (ICR project, required)
|
||
|
|
| Field | Key | Type |
|
||
|
|
|------------------------|--------------------|-------------------|
|
||
|
|
| Assignee | `assignee` | user (has default; still set explicitly when possible) |
|
||
|
|
| Change Start Date/Time | `customfield_15856`| datetime (`YYYY-MM-DDTHH:mm:ss.SSS-0800`) |
|
||
|
|
| Change End Date/Time | `customfield_15857`| datetime (`YYYY-MM-DDTHH:mm:ss.SSS-0800`) |
|
||
|
|
| Manager/Peer Reviewer | `customfield_15862`| user |
|
||
|
|
| Procedure | `customfield_15863`| option (select) |
|
||
|
|
| Change Category | `customfield_15864`| option (select) |
|
||
|
|
| Can it be rolled back? | `customfield_16072`| array of options (checkbox) |
|
||
|
|
|
||
|
|
## Common Custom Fields (optional but useful)
|
||
|
|
| Field | Key | Type |
|
||
|
|
|--------------------|--------------------|-----------------|
|
||
|
|
| Fix Version | `fixVersions` | array of version|
|
||
|
|
| Reporter | `reporter` | user (`{"accountId": "..."}`) |
|
||
|
|
| Story Points | `customfield_10013`| number |
|
||
|
|
| Confidence Level | `customfield_12520`| option (select) |
|
||
|
|
| Product Lead | `customfield_15755`| user |
|
||
|
|
| Engineering Lead | `customfield_15756`| user |
|
||
|
|
| Start date | `customfield_15541`| date (YYYY-MM-DD) |
|
||
|
|
| End date | `customfield_15535`| date (YYYY-MM-DD) |
|
||
|
|
| Sprint | `customfield_10320`| sprint |
|
||
|
|
| Aha! Reference | `customfield_11820`| string (URL) |
|
||
|
|
| Security Review | `customfield_15826`| option (select) |
|
||
|
|
|
||
|
|
## Allowed Values for Required Select Fields
|
||
|
|
|
||
|
|
### Type of Effort (`customfield_15815`)
|
||
|
|
| Value | ID |
|
||
|
|
|-------------------------------------------|-------|
|
||
|
|
| Customer Feature | 18153 |
|
||
|
|
| Customer Support | 18156 |
|
||
|
|
| Innovation | 19074 |
|
||
|
|
| Platform Excellence | 18922 |
|
||
|
|
| Security Issues / Tech Debt / Maintenance | 18155 |
|
||
|
|
|
||
|
|
### Found/Requested By (`customfield_11922`)
|
||
|
|
| Value | ID |
|
||
|
|
|----------------------|-------|
|
||
|
|
| Alert | 18931 |
|
||
|
|
| Customer Engineering | 13609 |
|
||
|
|
| Engineering | 10114 |
|
||
|
|
| FDE | 24812 |
|
||
|
|
| Other | 17542 |
|
||
|
|
| Product Management | 10115 |
|
||
|
|
|
||
|
|
### Affected Documentation (`customfield_12429`)
|
||
|
|
| Value | ID |
|
||
|
|
|-------------------|-------|
|
||
|
|
| No | 16302 |
|
||
|
|
| Deprecation Notice| 11710 |
|
||
|
|
| Help Portal | 10438 |
|
||
|
|
| Internal Only | 12912 |
|
||
|
|
| Release Notes | 10437 |
|
||
|
|
|
||
|
|
### Execution team (`customfield_13020`) — partial list
|
||
|
|
| Value | ID |
|
||
|
|
|--------------------|-------|
|
||
|
|
| Cloud Platform (Portugal) | 19040 |
|
||
|
|
| DevOps | 16211 |
|
||
|
|
| Documentation | 18367 |
|
||
|
|
| Persistence | 16700 |
|
||
|
|
| Performance | 17629 |
|
||
|
|
| Data Unification | 12811 |
|
||
|
|
| Match | 15400 |
|
||
|
|
| IDP | 17906 |
|
||
|
|
| Console | 17845 |
|
||
|
|
| Architecture | 18930 |
|
||
|
|
| CI | 17656 |
|
||
|
|
|
||
|
|
### Procedure (`customfield_15863`) — ICR Change Request
|
||
|
|
| Value | ID |
|
||
|
|
|-------------|-------|
|
||
|
|
| Manual Step | 18226 |
|
||
|
|
| Automated | 18227 |
|
||
|
|
|
||
|
|
### Change Category (`customfield_15864`) — ICR Change Request
|
||
|
|
Default for ICR templates in this skill: `High Risk` (`18229`).
|
||
|
|
|
||
|
|
| Value | ID |
|
||
|
|
|-----------|-------|
|
||
|
|
| Low Risk | 18228 |
|
||
|
|
| High Risk | 18229 |
|
||
|
|
| Emergency | 18230 |
|
||
|
|
|
||
|
|
### Can it be rolled back? (`customfield_16072`) — ICR Change Request
|
||
|
|
| Value | ID |
|
||
|
|
|-------|-------|
|
||
|
|
| Yes | 18678 |
|
||
|
|
| No | 18679 |
|
||
|
|
|
||
|
|
### Risk Level (`customfield_16070`) — required when closing
|
||
|
|
| Value | ID |
|
||
|
|
|--------------------|-------|
|
||
|
|
| High-Risk Changes | 18676 |
|
||
|
|
| Low-Risk Changes | 18677 |
|
||
|
|
| Not applicable | 19049 |
|
||
|
|
|
||
|
|
### Confidence Level (`customfield_12520`)
|
||
|
|
| Value | ID |
|
||
|
|
|--------|-------|
|
||
|
|
| High | 10510 |
|
||
|
|
|
||
|
|
### Components (partial list)
|
||
|
|
| Value | ID |
|
||
|
|
|---------------|-------|
|
||
|
|
| Documentation | 10222 |
|
||
|
|
| QA | 11511 |
|
||
|
|
| DevOps | 11111 |
|
||
|
|
| DNS | 20020 |
|
||
|
|
|
||
|
|
## Fix Versions (known)
|
||
|
|
| Version | ID | Release Date |
|
||
|
|
|------------|-------|-------------|
|
||
|
|
| 2026.1.0.0 | 28439 | 2026-03-23 |
|
||
|
|
|
||
|
|
## ADF (Atlassian Document Format) Templates
|
||
|
|
|
||
|
|
### Acceptance Criteria — ordered list
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"type": "doc",
|
||
|
|
"version": 1,
|
||
|
|
"content": [
|
||
|
|
{"type": "orderedList", "attrs": {"order": 1}, "content": [
|
||
|
|
{"type": "listItem", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Criteria item 1"}]}]},
|
||
|
|
{"type": "listItem", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Criteria item 2"}]}]}
|
||
|
|
]}
|
||
|
|
]
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### Generic paragraph ADF (use for rich-text custom fields)
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"type": "doc",
|
||
|
|
"version": 1,
|
||
|
|
"content": [
|
||
|
|
{
|
||
|
|
"type": "paragraph",
|
||
|
|
"content": [
|
||
|
|
{"type": "text", "text": "No expected customer impact."}
|
||
|
|
]
|
||
|
|
}
|
||
|
|
]
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Common Transitions
|
||
|
|
| Name | ID | Target Status |
|
||
|
|
|--------------------------|-----|----------------|
|
||
|
|
| Selected for Development | 501 | Prioritized |
|
||
|
|
| Start Progress | 11 | In Progress |
|
||
|
|
| Resolve | 31 | Resolved |
|
||
|
|
| In Design | 471 | In Design |
|
||
|
|
| Close | 351 | Closed |
|
||
|
|
|
||
|
|
**Close transition requires:** `fixVersions` and `customfield_16070` (Risk Level).
|
||
|
|
|
||
|
|
### Example: Close a ticket
|
||
|
|
```bash
|
||
|
|
mcporter call atlassian.transitionJiraIssue --args '{
|
||
|
|
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||
|
|
"issueIdOrKey": "RP-XXXXX",
|
||
|
|
"transition": {"id": "351"},
|
||
|
|
"fields": {
|
||
|
|
"fixVersions": [{"id": "28439"}],
|
||
|
|
"customfield_16070": {"id": "19049"}
|
||
|
|
}
|
||
|
|
}'
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example: Create an Epic
|
||
|
|
```bash
|
||
|
|
mcporter call atlassian.createJiraIssue --args '{
|
||
|
|
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||
|
|
"projectKey": "RP",
|
||
|
|
"issueTypeName": "Epic",
|
||
|
|
"summary": "Epic Title",
|
||
|
|
"description": "Markdown description",
|
||
|
|
"assignee_account_id": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b",
|
||
|
|
"additional_fields": {
|
||
|
|
"reporter": {"accountId": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b"},
|
||
|
|
"fixVersions": [{"id": "28439"}],
|
||
|
|
"customfield_15815": {"id": "18153"}
|
||
|
|
}
|
||
|
|
}'
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example: Create a Task
|
||
|
|
```bash
|
||
|
|
mcporter call atlassian.createJiraIssue --args '{
|
||
|
|
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||
|
|
"projectKey": "RP",
|
||
|
|
"issueTypeName": "Task",
|
||
|
|
"summary": "Task Title",
|
||
|
|
"description": "Task description",
|
||
|
|
"assignee_account_id": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b",
|
||
|
|
"additional_fields": {
|
||
|
|
"components": [{"id": "10222"}],
|
||
|
|
"customfield_15815": {"id": "18922"},
|
||
|
|
"customfield_11922": {"id": "10115"}
|
||
|
|
}
|
||
|
|
}'
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example: Create a Story under an Epic
|
||
|
|
```bash
|
||
|
|
mcporter call atlassian.createJiraIssue --args '{
|
||
|
|
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||
|
|
"projectKey": "RP",
|
||
|
|
"issueTypeName": "Story",
|
||
|
|
"summary": "Story Title",
|
||
|
|
"description": "Markdown description with ## Why / ## What / ## How",
|
||
|
|
"assignee_account_id": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b",
|
||
|
|
"parent": "RP-XXXXX",
|
||
|
|
"additional_fields": {
|
||
|
|
"reporter": {"accountId": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b"},
|
||
|
|
"fixVersions": [{"id": "28439"}],
|
||
|
|
"customfield_15815": {"id": "18153"},
|
||
|
|
"customfield_11922": {"id": "10114"},
|
||
|
|
"customfield_12429": [{"id": "16302"}],
|
||
|
|
"customfield_15956": {"type":"doc","version":1,"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"AC item"}]}]}]}]}
|
||
|
|
}
|
||
|
|
}'
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example: Create an ICR Change Request
|
||
|
|
```bash
|
||
|
|
mcporter call atlassian.createJiraIssue --args '{
|
||
|
|
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||
|
|
"projectKey": "ICR",
|
||
|
|
"issueTypeName": "Change Request",
|
||
|
|
"summary": "Re-add na11 IP 34.36.175.121 to na07 latency-based Cloud DNS records (na07-compute)",
|
||
|
|
"description": "Implementation, verification, impact, and rollback details",
|
||
|
|
"assignee_account_id": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b",
|
||
|
|
"additional_fields": {
|
||
|
|
"components": [{"id": "20020"}],
|
||
|
|
"customfield_15856": "2026-02-26T17:00:00.000-0800",
|
||
|
|
"customfield_15857": "2026-02-26T18:00:00.000-0800",
|
||
|
|
"customfield_15862": {"accountId": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b"},
|
||
|
|
"customfield_15863": {"id": "18226"},
|
||
|
|
"customfield_15864": {"id": "18229"},
|
||
|
|
"customfield_16072": [{"id": "18678"}],
|
||
|
|
"customfield_15858": {
|
||
|
|
"type": "doc",
|
||
|
|
"version": 1,
|
||
|
|
"content": [
|
||
|
|
{"type": "paragraph", "content": [{"type": "text", "text": "No expected customer impact."}]}
|
||
|
|
]
|
||
|
|
},
|
||
|
|
"customfield_15859": {
|
||
|
|
"type": "doc",
|
||
|
|
"version": 1,
|
||
|
|
"content": [
|
||
|
|
{"type": "paragraph", "content": [{"type": "text", "text": "Remove na11 IP 34.36.175.121 from affected latency-based record sets."}]}
|
||
|
|
]
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}'
|
||
|
|
```
|