Skip to main content

Jira Server

Jira Server (Data Center) is a self-hosted version of Jira for project management and issue tracking.

Authentication Types​

Jira Server supports 2 authentication methods:

  • OAuth 2.0 - Use OAuth 2.0 authentication with your self-hosted Jira Server instance (requires v8.5.9 or later).

    • Pros: Secure, per-user tracking, production-ready, no credentials stored in MCP-S
    • Cons: Requires OAuth configuration on Jira Server

  • API Key - Use a personal access token for authentication.

    • Pros: Simple setup
    • Cons: Single credential for all users

General Settings​

Before using the connector, you need to configure:

  • Jira Organization Domain - Your Jira Server instance URL (e.g., https://jira.yourcompany.com)

Setting up OAuth 2.0​

OAuth 2.0 is available for self-hosted Jira Server/Data Center instances running version 8.5.9 or later.

Requirements:

  • Jira Server/Data Center v8.5.9 or later
  • HTTPS enabled on your Jira Server instance (required for production)
  • Administrator access to Jira Server

Setup Steps:

  1. Log in to your Jira Server instance as an administrator

  2. Navigate to Settings (gear icon) → Applications → Application links

  1. Click Create link

  2. Select External application and then Incoming

  1. Choose OAuth 2.0 as the authentication method

  2. Configure the OAuth application:

    • Name: Enter a descriptive name (e.g., "MCP-S Integration")
    • Redirect URL: Copy this from MCP-S and paste it here
    • Scopes: Enable the required scopes:
      • READ - View projects and issues
      • WRITE - Create, update, and delete projects and issues (includes READ)
  1. Click Save and copy the Client ID and Client Secret

  1. In MCP-S:

    • Paste the Client ID and Client Secret
    • Enter your Jira Server instance URL in Jira Organization Domain (e.g., https://jira.yourcompany.com)

  2. Click Save Changes and authorize

Additional Information:

  • For detailed configuration steps, see Atlassian's official documentation
  • OAuth 2.0 supports both Authorization Code and Authorization Code with PKCE flows
  • Access tokens expire after 2 hours by default and are automatically refreshed

Generating an API Key (Personal Access Token)​

For Jira Server/Data Center (version 8.14+):

  1. Log in to your Jira Server instance

  2. Click on your profile icon in the top right

  3. Go to Profile

  1. In the left sidebar, click Personal Access Tokens
  1. Click Create token
  1. Enter a Token name and optionally set an expiry date

  1. Click Create

  2. Copy the token immediately (it won't be shown again)

  1. Paste the token into Webrix

  2. Enter your Jira Organization Domain in General Settings

Note: For older Jira Server versions without PAT support, you may need to use basic authentication with your username and password.