Frequently Asked Questions (FAQ) - Jira Weekly Reporter MCP Server

Q: What is the Jira Weekly Reporter MCP Server? A: It’s a tool that automates the generation of weekly Jira reports, connecting to your Jira instance to extract issue activity data and optionally summarize it using an LLM.

Q: What is an MCP Server? A: MCP stands for Model Context Protocol. An MCP Server acts as a bridge, allowing AI models to access and interact with external data sources and tools. It standardizes how applications provide context to LLMs.

Q: What Jira versions does this tool support? A: It supports Jira Cloud, Server, and Data Center versions.

Q: What are the prerequisites for using this tool? A: You need Python 3.10+, uv or pip, access to a Jira instance, a Jira API token, and the FastMCP CLI installed.

Q: How do I install the necessary dependencies? A: Use uv pip install fastmcp "jira[cli]" python-dotenv httpx anyio or pip install fastmcp "jira[cli]" python-dotenv httpx anyio.

Q: How do I configure the tool to connect to my Jira instance? A: Create a .env file in the same directory as jira_reporter_server.py and add your Jira URL, username, and API token.

Q: How do I run the server? A: You can run it directly with Python using python jira_reporter_server.py or using the FastMCP CLI with fastmcp run jira_reporter_server.py.

Q: How can I customize the reports generated by the tool? A: You can use JQL queries and project key filters to tailor the reports to your specific needs.

Q: What is JQL? A: JQL (Jira Query Language) is a powerful query language used to search for issues in Jira.

Q: Can the tool summarize the reports generated? A: Yes, the tool can optionally summarize the reports using the client’s LLM.

Q: How do I integrate the tool with the Claude Desktop application? A: Configure the claude_desktop_config.json file to make the server available as a tool within Claude.

Q: Where can I find the claude_desktop_config.json file? A: The location depends on your operating system: * macOS: ~/Library/Application Support/Claude/claude_desktop_config.json * Windows: %APPDATA%Claudeclaude_desktop_config.json * Linux: ~/.config/Claude/Claude/claude_desktop_config.json

Q: What is UBOS? A: UBOS is a full-stack AI Agent Development Platform that helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model and Multi-Agent Systems.

Q: How does this tool integrate with UBOS? A: The tool is an MCP Server, enabling integration with UBOS’s AI agent ecosystem. This allows you to build workflows where AI agents automatically trigger report generation and use the summarized data for further tasks.

Q: Is the .env file safe to commit to version control? A: No, never commit your .env file to version control! Add .env to your .gitignore file to prevent accidental commits.

Q: Where can I generate an API token for Jira Cloud? A: Generate an API token from your Atlassian account settings: Manage API tokens.

Q: Where can I generate a Personal Access Token (PAT) for Jira Server/Data Center? A: Generate a Personal Access Token (PAT) from your Jira user profile settings: Using Personal Access Tokens.

Q: What does the dependencies=["jira"] line in the code mean? A: It tells tools like fastmcp install that the jira library is required for this server to function correctly when creating isolated environments.