Configure the integration

Follow these steps to configure MCP server integration:

  1. Click Setup > Account.
  2. Select the Integrations tile.
  3. The Installed Integrations screen is displayed, with all the installed applications. Click + ADD on the Installed Integrations page.
  4. If you do not have any installed applications, you will be navigated to the Available Integrations page. The Available Integrations page displays all the available applications
    Note: Search for MCP Server using the search option available. Alternatively, use the All Categories option to search.
  5. Click +ADD on the MCP Server tile.
  6. Enter a unique name for the integration in the popup box and click Add.

    Add MCP Server page

    The MCP Outbound configuration page appears.

    Add MCP Server configuration
  7. Click Add a configuration.
  8. Enter the following information in the Add Configuration window:

    MCP Server - Add Configuration
  9. Enter the Base URI.
    Always required. The URL of the MCP server, supplied by its provider—not an ordinary Jira, Splunk, or GitHub REST API URL. Use HTTPS for a hosted server. Confirm the exact path with the provider.
    https://mcp.atlassian.com/v1/mcp
  10. Select the Notification Type from the dropdown. Based on the Notification Type selected, the values in the Authentication type change.
  • REST API

    If you select REST API as Notification Type, the Authentication type dropdown has None, Basic, OAuth2, JWT, and Custom options.

    Select the Authentication type that matches how your MCP server authenticates requests:

    • None: Select this if the MCP server does not require authentication. No additional fields are displayed.
    • Basic: Select this if the MCP server uses a user name and password. Enter the credentials as described below.
    • OAuth2: Select this if the MCP server uses token-based authorization. Choose the Grant Type and enter the token URL, key, secret, and scope as described below.
    • JWT: Select this if the MCP server accepts a JSON Web Token. Enter the JWT details as described below.
    • Custom: Select this if the MCP server requires custom authentication, such as a specific header or API key. Enter the required values as described below.

    The fields displayed change based on the option you select.

    • Basic: Enter the following information:

      Field NameDescription
      User NameEnter the user name.
      PasswordEnter the password.
    • OAuth2: Enter the following information:

      Field NameDescription
      Grant TypeSelect the Grant Type from the dropdown. If you select Password Credentials or Refresh Token, enter the User Name and Password.
      Access Token URLThe provider's OAuth token endpoint
      KeyOAuth client ID issued for this MCP connection.
      SecretEnter the Secret. If the provider uses a public client with no secret, the tested Atlassian configuration uses the literal none; the connector omits it from the token request.
      ScopeEnter the scope.
    • JWT: Enter the following information:

      Field NameDescription
      Token URLEnter the Token URL.
      User NameEnter the user name.
      PasswordEnter the password.
      Token PayloadEnter the Token Payload.
      Token HeadersThe Name and Value are displayed by default. You can change them accordingly.
      Tokens PathEnter Name (displayed by default) and Value, and click SAVE.
      Resource Authorization HeadersEnter Name and Value (displayed by default), and click SAVE.
  • SOAP API

    If you select SOAP API as Notification Type, the Authentication type dropdown will have None and Basic options.

    Select the Authentication type that matches how your MCP server authenticates requests:

    • None: Select this if the MCP server does not require authentication. No additional fields are displayed.
    • Basic: Select this if the MCP server uses a user name and password. Enter the credentials as described below.

    The fields displayed change based on the option you select.

    • Basic: Enter the following information:

      Field NameDescription
      User NameEnter Account name or email. The integration requires it; changing this field alone does not change the authorized external account.
      PasswordFor Basic in this connector, enter a bearer token (not a standard HTTP Basic password). For Refresh Token, enter the provider's refresh token, not an access token. For Password Credentials, enter the provider account's password.
  1. Click Add Configuration. A success message appears.
  2. Click Finish.