Jira

Connect Jira to let agents search issues, create new tickets, and add comments to existing issues.

What Agents Can Do

Tool	Description
`search_jira`	Search Jira issues by keyword, project, or status
`jira_create_issue`	Create a new Jira issue (Task, Bug, Story, etc.)
`jira_add_comment`	Add a comment to an existing Jira issue

Prerequisites

An Atlassian account with Jira Cloud access
Admin permissions in your Jira project
Sempleo workspace on any plan

Setup Steps

1. Navigate to Integrations

Go to Settings → Integrations in your Sempleo dashboard.

2. Find Jira

Find Jira in the catalog and click Connect.

3. Authorize

You'll be redirected to Atlassian's OAuth page. Sempleo requests:

Scope	Why
`read:jira-work`	Search and read issues, projects, and sprints
`write:jira-work`	Create issues and add comments
`offline_access`	Refresh token for continuous access

4. Select Site

If you have multiple Atlassian sites, Sempleo connects to the first accessible site. The cloud ID is stored for API routing.

Usage

Searching Issues

"Find all open bugs in the PROJ project"
"What tickets are assigned to the platform team this sprint?"
"Search Jira for issues related to authentication"

Creating Issues

Agents can create tickets when governance allows:

"Create a Jira task in PROJ: Update the login page error messages"
"File a bug in the MOBILE project: App crashes on iOS 17 when uploading photos"

Adding Comments

"Add a comment to PROJ-123: Investigated this — the root cause is a missing null check in the auth middleware"

Governance

On Professional and Enterprise plans, you can require approval before agents create issues or add comments. Configure this in Settings → Governance.

Troubleshooting

Issue	Solution
"Missing cloud ID"	Reconnect the integration to re-fetch the Atlassian cloud ID
"Project not found"	Verify the project key is correct and you have access
Permission errors	Ensure your Atlassian account has the required project permissions
Token expired	Sempleo auto-refreshes with `offline_access`; reconnect if persistent

On this page