Frequently Asked Questions (FAQ) - MCP Server for JIRA

Q: What is the MCP Server for JIRA?

A: The MCP (Model Context Protocol) Server for JIRA is a tool available on the UBOS Asset Marketplace that allows AI models to interact with JIRA APIs through Claude Desktop. It facilitates automation, issue management, and enhanced collaboration.

Q: What are the main features of the MCP Server for JIRA?

A: Key features include JQL search, project listing, issue management (create, update, delete), comment and transition management, and user search with GDPR compliance.

Q: What is MCP (Model Context Protocol)?

A: MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). An MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools.

Q: How do I install the MCP Server for JIRA?

A: Installation involves cloning the repository, creating a virtual environment, installing dependencies, configuring environment variables with JIRA credentials, testing the installation, and starting the MCP server.

Q: What JIRA credentials do I need to configure?

A: You need your JIRA server URL, your JIRA email address, and a JIRA API token.

Q: How do I obtain a JIRA API token?

A: Log in to your Atlassian account, go to Account Settings > Security > Create and manage API tokens, and create a new API token.

Q: How does the MCP Server for JIRA handle GDPR compliance?

A: For JIRA Cloud instances with GDPR strict mode, the MCP Server for JIRA restricts user searches to display names and email addresses. It also automatically adjusts API calls to comply with GDPR requirements.

Q: What should I do if I encounter a ‘ModuleNotFoundError: No module named ‘src’’ error?

A: Run the run.py script with the PYTHONPATH environment variable set to the path of the mcp-jira directory: PYTHONPATH=/path/to/mcp-jira python run.py.

Q: What should I do if I encounter a JIRA API Authentication Error?

A: Verify that your API token is correct, your email matches your Atlassian account, and your JIRA instance URL is correct and includes ‘https://’.

Q: Can I use usernames to search for users in a GDPR-compliant JIRA instance?

A: No, in GDPR strict mode, user search must use display names or email addresses instead of usernames.

Q: How can I update an existing JIRA issue using the MCP Server?

A: Use the update_issue tool with the issue_key and the parameters you want to update (e.g., summary, description, status, priority, assignee, comment).

Q: How can I create a new JIRA issue using the MCP Server?

A: Use the create_issue tool with the required parameters such as project_key, summary, and issue_type. You can also specify optional parameters like description, priority, and assignee.

Q: How do I search for issues using JQL?

A: Use the search_issues tool and provide a JQL query string in the jql parameter (e.g., jql="project=DEMO AND status=Open").

Q: Can I delete a JIRA issue using the MCP Server?

A: Yes, use the delete_issue tool, but you must set the confirm parameter to True to prevent accidental deletion.

Q: How does the MCP Server integrate with the UBOS platform?

A: The MCP Server integrates seamlessly with the UBOS platform, a full-stack AI Agent Development Platform, allowing you to orchestrate AI Agents, connect them with enterprise data, and build custom AI Agents with your LLM model and Multi-Agent Systems.

Q: Where can I find the code repository for the MCP Server for JIRA?

A: The code is available on GitHub; refer to the installation instructions for the repository URL.