Jira Sprint Dashboard MCP Server

Gera análises interativas de sprint e dashboards executivos ao conectar dados do Jira ao Claude AI. Fornece insights sobre burndown, velocidade e progresso de metas.

GitHub
2

Documentação

Jira MCP Server with OAuth Authentication

🚀 Smithery-Compatible MCP Server for seamless Jira integration with browser OAuth authentication.

✨ Key Features

  • 🔐 Browser OAuth Flow - No manual API token management
  • 🏪 Smithery Marketplace Ready - One-click installation
  • ⚡ Auto-Configuration - Claude Desktop configured automatically
  • 🛠️ Complete Tool Suite - Issue management, search, projects
  • 🔒 Secure - OAuth tokens handled safely
  • 📱 User-Friendly - Config UI in Smithery

🎯 User Experience

Install from Smithery → Config UI → Browser Login → Done!
(30 seconds total setup time)

Installation Flow:

  1. Install from Smithery marketplace
  2. Configure Jira URL and email in Smithery UI
  3. Open Claude Desktop (auto-configured)
  4. Run start_oauth tool
  5. Login via browser
  6. Ready! All Jira tools available

🛠️ Available Tools

  • oauth_status - Check authentication status
  • start_oauth - Launch browser authentication
  • test_jira_connection - Verify connection
  • jira_get_issue - Get issue details
  • jira_search - Search with JQL
  • list_projects - List accessible projects
  • help - Complete usage guide

🚀 Deployment

For Smithery Marketplace:

  1. Upload this repository to Smithery
  2. Configure OAuth app with Atlassian
  3. Set environment variables in Smithery
  4. Publish to marketplace

OAuth App Setup:

  • Authorization callback URL: ${SMITHERY_HOSTNAME}/oauth/callback
  • Scopes: read:jira-user, read:jira-work, write:jira-work

💻 Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Start development server
npm run dev-oauth

# Test OAuth flow
npm run test-oauth

📋 Environment Variables

Required for Smithery deployment:

OAUTH_CLIENT_ID=your_atlassian_oauth_client_id
OAUTH_CLIENT_SECRET=your_atlassian_oauth_client_secret
THIS_HOSTNAME=https://your-smithery-hostname
PORT=3000

🔧 Technical Details

  • Runtime: Node.js 18+
  • Transport: HTTP (Smithery-compatible)
  • Authentication: Atlassian OAuth 2.0
  • Framework: Express.js with MCP SDK
  • Token Storage: In-memory (production: Redis recommended)

📜 License

MIT License - see LICENSE file for details

Built for seamless Jira integration with Claude Desktop via Smithery marketplace.