Skip to main content

Jira & Confluence MCP Servers

The platform provides MCP server integrations for both Jira and Confluence. Since both services are part of the Atlassian platform, they share the same OAuth app and credentials — you configure authentication once and can enable either or both services.

Jira

Capabilities

ToolWhat It Does
Search issuesSearch for issues using JQL (Jira Query Language)
Get issueRetrieve details about a specific issue
Create issueCreate a new issue in a project
Update issueModify fields on an existing issue
Add commentPost a comment on an issue
Transition issueMove an issue to a different status
List projectsList available Jira projects
Get projectRetrieve details about a specific project

Confluence

Capabilities

ToolWhat It Does
Search contentSearch pages and blog posts using CQL (Confluence Query Language)
Get pageRetrieve the full content of a page
Create pageCreate a new page in a space
Update pageEdit the content of an existing page
Add commentPost a comment on a page
List spacesList available Confluence spaces
Get spaceRetrieve details about a specific space

OAuth Setup

Both Jira and Confluence use the same Atlassian OAuth app. You create one app and use it for both services.

Step 1: Create an Atlassian OAuth App

  1. Go to the Atlassian Developer Console and sign in.
  2. Click Create > OAuth 2.0 integration.
  3. Enter a name (for example, "Devs AI MCP") and agree to the developer terms.
  4. Click Create.

Step 2: Configure the Callback URL

  1. In the left sidebar, go to Authorization.
  2. Under OAuth 2.0 (3LO), click Configure.
  3. Add the redirect URL(s) provided by your Devs.ai platform administrator.

Step 3: Add Permissions and Scopes

  1. In the left sidebar, go to Permissions.
  2. Click Add next to Jira API and select the following scopes:
ScopeDescription
read:jira-workRead project and issue data, search for issues
write:jira-workCreate and edit issues, post comments, manage worklogs
read:jira-userView user information (usernames, emails, avatars)
  1. Click Add next to Confluence API and select the following scopes:
ScopeDescription
read:confluence-content.allRead all page and blog content, including body text
write:confluence-contentCreate and update pages, blogs, and comments
read:confluence-space.summaryView space information and metadata
search:confluenceSearch across Confluence content
read:confluence-userView user profiles

📝 Note: You can include scopes for both Jira and Confluence in a single OAuth app. If you only need one service, you only need to add the scopes for that service.

Step 4: Get Your Credentials

  1. In the left sidebar, go to Settings.
  2. Copy the Client ID and Secret (click Show to reveal).

Step 5: Configure in Devs.ai

  1. Navigate to Organization > Connectors in Devs.ai.
  2. Find the Jira or Confluence template and click Enable.
  3. Select OAuth as the authentication type.
  4. Enter your Client ID and Client Secret from Step 4.
  5. Select the tools you want to make available.
  6. Click Save.

You can enable Jira and Confluence separately. Both use the same Client ID and Client Secret.

How Atlassian Cloud Authentication Works

Atlassian Cloud APIs use a per-tenant Cloud ID in the API URL. After a user authorizes access, the platform automatically:

  1. Retrieves the user's accessible Atlassian sites.
  2. Determines the correct Cloud ID for the user's site.
  3. Uses the correct base URL for all API requests (for example, https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3).

This is handled transparently — you do not need to configure the Cloud ID manually.

OAuth Configuration Reference

FieldValue
Authorization URLhttps://auth.atlassian.com/authorize
Token URLhttps://auth.atlassian.com/oauth/token
Scopes Parameter Namescope (space-separated)
Additional Parametersprompt=consent, response_type=code

Additional Resources

⌘J