Jira Integration

Connect Chatty AI with Atlassian Jira for project management and issue tracking.

Overview

Jira integration allows Chatty AI to interact with your Jira projects, issues, and workflows.

Key Features:

• Create and update Jira issues
• Query project status
• Search issues
• View issue details
• Add comments
• Track progress

---

Configuration

Option 1: Using Chatty AI MCP Server (Recommended)

Easiest setup - Connect via Chatty AI MCP server:

Benefits:

• ✅ Simplified configuration
• ✅ Managed by Chatty AI
• ✅ No direct API token management in Chatty AI
• ✅ Centralized credential management

MCP Server URL:

# Chatty AI Hosted
https://mcp-jira.chattyai.io

# Or internal deployment
http://mcp-jira:3101

Setup:

1. Configure Jira API token in MCP server (vendor-managed)
2. Add MCP server in Chatty AI:

   Settings → MCP Servers → Add Server
   Name: Jira
   URL: https://mcp-jira.chattyai.io

3. Start using Jira integration in Chatty AI

See MCP Servers for more details.

---

Option 2: Direct Jira API Integration

For custom setups - Connect directly to Jira API:

Required Permissions

Jira API access requires specific permissions. The user account used for API access needs:

Project Permissions (per project):

• Browse Projects - View project and issue details
• Create Issues - Create new issues
• Edit Issues - Modify existing issues
• Add Comments - Add comments to issues
• Delete Issues - Delete issues (optional)
• Assign Issues - Assign issues to users
• Transition Issues - Change issue status

Global Permissions (recommended):

• Browse Users - Search and view user information
• Create Team-Managed Projects - Create projects (optional)

Permission Levels

Access Level	Permissions	Use Case
Read-Only	Browse Projects, Browse Users	Viewing and querying only
Standard	Browse, Create, Edit, Comment, Assign, Transition	Most common use case
Full Access	All permissions including Delete	Complete project management

Step 1: Generate Jira API Token

1. Go to Atlassian Account Settings
2. Click Create API token
3. Give it a name (e.g., "Chatty AI")
4. Click Create
5. Copy the token (you won't see it again)

Step 2: Verify User Permissions

Before configuring, verify the user has required permissions:

1. Login to Jira with the account
2. Go to Project Settings → Permissions
3. Verify the user has:
   • Browse Projects
   • Create Issues
   • Edit Issues
   • Add Comments
   • Transition Issues
4. If missing permissions, contact Jira admin to grant access

Step 2: Configure in Chatty AI

Method 1: Admin UI

1. Login to Chatty AI as admin
2. Go to Settings → Apps
3. Find Jira
4. Click Configure
5. Enter:
   • Jira URL: https://your-company.atlassian.net
   • Email: Your Jira account email
   • API Token: Token from Step 1
6. Click Save
7. Click Test Connection

Method 2: Environment Variables

Add to .env:

# Jira Configuration
JIRA_URL=https://your-company.atlassian.net
JIRA_EMAIL=your-email@company.com
JIRA_API_TOKEN=your-api-token-here

# Enable Jira app
CHATTY_APP_SHOW_APPS=true

Restart services:

docker compose restart chattyai

---

Using Jira Integration

Example Interactions

Creating Issues

User: Create a bug ticket for the login issue

Chatty AI: [Creates Jira issue]
Created: BUG-123 - Login issue
Project: Support
Type: Bug
Status: To Do

Querying Issues

User: Show me all open bugs in the Support project

Chatty AI: [Queries Jira]
Open bugs in Support:
1. BUG-123: Login issue (High priority)
2. BUG-124: Email not sending (Medium priority)
3. BUG-125: UI glitch (Low priority)

Updating Issues

User: Update BUG-123 status to In Progress

Chatty AI: [Updates Jira]
BUG-123 status updated to In Progress

Adding Comments

User: Add comment to BUG-123: "Working on fix, ETA 2 hours"

Chatty AI: [Adds comment to Jira]
Comment added to BUG-123

---

Common Use Cases

1. Daily Standup

User: What tickets am I assigned to?

Chatty AI: Your assigned tickets:
- BUG-123: Login issue (In Progress)
- TASK-456: Update documentation (To Do)
- STORY-789: New feature (In Review)

2. Sprint Planning

User: How many story points are in the current sprint?

Chatty AI: Current sprint (Sprint 24):
- Total story points: 45
- Completed: 12
- In progress: 18
- To do: 15

3. Bug Triage

User: Show me all critical bugs

Chatty AI: Critical bugs:
1. BUG-200: Database connection failing
2. BUG-201: Payment processing error
3. BUG-202: Data loss on save

4. Project Status

User: What's the status of the Mobile App project?

Chatty AI: Mobile App Project:
- Total issues: 45
- Done: 30 (67%)
- In Progress: 10 (22%)
- To Do: 5 (11%)

---

Jira Query Language (JQL)

Use JQL for advanced queries:

User: Find issues using JQL: project = SUPPORT AND status = "In Progress"

Chatty AI: [Executes JQL query]
Found 8 issues in Support project with status In Progress

Common JQL Examples:

# My open issues
assignee = currentUser() AND status != Done

# High priority bugs
type = Bug AND priority = High

# Issues updated today
updated >= startOfDay()

# Sprint issues
sprint in openSprints()

---

Security Best Practices

1. Use API Tokens

Never use passwords - always use API tokens:

• Tokens can be revoked
• Tokens have limited scope
• Tokens don't expire passwords

2. Least Privilege

Create dedicated Jira account for Chatty AI:

• Read-only access if possible
• Limited to specific projects
• No admin permissions

3. Rotate Tokens

Regularly rotate API tokens:

# Every 90 days
1. Generate new token
2. Update .env
3. Restart services
4. Revoke old token

4. Secure Storage

Never commit tokens to git:

echo "JIRA_API_TOKEN=*" >> .gitignore

---

Troubleshooting

Cannot Connect to Jira

# Verify Jira URL
curl https://your-company.atlassian.net

# Check API token
# Try accessing Jira API directly
curl -u your-email@company.com:your-api-token \
  https://your-company.atlassian.net/rest/api/3/myself

# Check Chatty AI logs
docker compose logs chattyai | grep -i jira

Permission Denied

# Verify API token has correct permissions
# Check Jira user has access to projects

# Test with Jira API
curl -u email:token \
  https://your-company.atlassian.net/rest/api/3/project

# May need to grant permissions in Jira

Rate Limiting

# Jira API has rate limits
# Reduce query frequency
# Use caching where possible

# Check rate limit headers
curl -I -u email:token \
  https://your-company.atlassian.net/rest/api/3/myself

---

Advanced Configuration

Custom Fields

Access custom Jira fields:

# Configure custom field mapping
JIRA_CUSTOM_FIELDS='{"customfield_10001": "Story Points", "customfield_10002": "Sprint"}'

Webhooks

Set up Jira webhooks to notify Chatty AI:

1. Jira Settings → System → Webhooks
2. Create webhook
3. URL: https://YOUR_CHATTYAI_DOMAIN/api/webhooks/jira
4. Events: Select events to monitor
5. Save

Multiple Jira Instances

Connect to multiple Jira instances:

# Primary Jira
JIRA_URL=https://company.atlassian.net
JIRA_EMAIL=email@company.com
JIRA_API_TOKEN=token1

# Secondary Jira
JIRA_URL_2=https://other.atlassian.net
JIRA_EMAIL_2=email@other.com
JIRA_API_TOKEN_2=token2

---

Related Documentation

• Integrations Overview - All integrations
• Microsoft 365 Apps - MS365 integration
• n8n Integration - Workflow automation with Jira
• Core Application Variables - Jira configuration