docs(cli): fix Jira CLI card to reflect direct Atlassian REST API access#1364
docs(cli): fix Jira CLI card to reflect direct Atlassian REST API access#1364kovtcharov-amd wants to merge 1 commit into
Conversation
The Jira CLI card claimed gaia jira works "via the MCP bridge," but
handle_jira_command runs gaia.apps.jira.app directly ("no MCP needed")
and the Jira guide states it talks to the Atlassian REST API with no
bridge required. The --mcp-host/--mcp-port options remain valid for the
optional MCP integration, so they stay in the options table.
|
One-line change, correctly targeted: the Jira card description was factually wrong, and this fixes it to match both the code path ( SummaryA single-character-budget fix that removes a misleading "via the MCP bridge" claim that would have sent users down a needless MCP setup path. The replacement — "using your Atlassian credentials (REST API)" — matches the Jira guide verbatim and reflects the actual Issues FoundNone. Strengths
VerdictApprove. No blocking issues. The fix is correct, minimal, and consistent with |
Why this matters
A review comment on the merged #1337 (review) flagged a docs-accuracy bug: the new Jira CLI card said
gaia jiraworks "via the MCP bridge." That's wrong and could send users down a needless setup path. The code path (handle_jira_command→ importsgaia.apps.jira.appdirectly, comment: "no MCP needed") and the Jira guide ("communicates directly with the Atlassian REST API — no intermediary services or MCP bridge required") both contradict the card. This aligns the card with the code and the guide.The
--mcp-host/--mcp-portflags are a real optional integration (they exist in thejirasubparser), so they remain in the options table — only the high-level description changed.Test plan
docs/reference/cli.mdxJira section now reads "using your Atlassian credentials (REST API)" and matchesdocs/guides/jira.mdx.gaia jira -hstill lists--mcp-host/--mcp-port(options table unchanged).