MCP Atlassian Fcr

MCP Atlassian is an integrated tool that provides Model Context Protocol services for Atlassian products (Confluence and Jira). It supports cloud and server/data - center deployments and can implement functions such as content search, page management, and issue tracking.

Knowledge management and memory Developer tools #Atlassian Integration #Team Collaboration #Project Management #Knowledge Management

rating : 2 points

downloads : 14

update time : 2025-04-23

What is MCP Atlassian?

MCP Atlassian is a server that integrates the Model Context Protocol (MCP) and supports both cloud and on - premise deployments of Confluence and Jira. It helps users efficiently manage and search enterprise knowledge bases and tasks.

How to use MCP Atlassian?

After configuring the server to connect to Confluence and Jira, you can search, create, update, and delete content, as well as manage tasks and projects.

Applicable scenarios

Suitable for enterprise teams that need to efficiently manage enterprise knowledge bases and tasks, especially those using Confluence and Jira for collaboration.

Main Features

Confluence SearchSearch for content in Confluence spaces through CQL queries.

Jira Task ManagementSupport creating, updating, and deleting Jira tasks, and manage task status and work logs.

Multiple Transmission ModesSupport two transmission modes: standard input/output (stdio) and server - sent events (SSE).

Advantages and Limitations

Advantages

Support both cloud and on - premise deployments of Confluence and Jira.

Provide various query and operation tools to improve work efficiency.

Support flexible selection of transmission modes.

Limitations

Requires API key configuration, which may involve security risks.

The processing speed for large - scale data may be slow.

How to Use

Install MCP Atlassian

Install via pip or start the server using a Docker image.

Configure the Server

Set the URLs, usernames, and API keys for Confluence and Jira.

Start Using

Connect to the server through the MCP client and execute queries.

Usage Examples

Search for Confluence DocumentsFind documents in a specific development space.

Manage Jira TasksUpdate the status of a Jira task and add a comment.

Frequently Asked Questions

How to generate an API key?

Does it support on - premise deployment?

How to switch the transmission mode?

Related Resources

Official Documentation

Detailed guide on using MCP Atlassian.

GitHub Repository

Source code and example code.

Installation Tutorial Video

Quick - start video.

Installation

Copy the following command to your Client for configuration

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-personal-token=your_token",
        "--jira-url=https://jira.your-company.com",
        "--jira-personal-token=your_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://confluence.your-company.com",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_password"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "mcp-atlassian",
      "args": [
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/.env",
        "mcp/atlassian"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse"
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp-atlassian",
        "run", "mcp-atlassian",
        "--confluence-url=https://your-domain.atlassian.net/wiki",
        "--confluence-username=your.email@domain.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-domain.atlassian.net",
        "--jira-username=your.email@domain.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

Note: Your key is sensitive information, do not share it with anyone.

🚀 MCP Protocol (Claude)

The MCP Protocol (Claude) is a tool designed to interact with Atlassian's Confluence and Jira platforms, offering a range of operations and functionalities to streamline access and management of related resources.

🚀 Quick Start

📦 Installation

You can install and run the MCP Protocol (Claude) in the following two ways:

Using npm Package

npm install @modelcontextprotocol/mcp-atlassian
npx @modelcontextprotocol/mcp-atlassian

Running from Source Code

git clone git@github.com:claude-mcp/mcp-atlassian.git
cd mcp-atlassian
npm install
node index.js

🔧 Configuration

Configuring the MCP Server Using the Package Method

Add the following content to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "--directory",
        "/path/to/@modelcontextprotocol/mcp-atlassian",
        "run",
        "mcp-atlassian",
        "--confluence-url",
        "https://your-domain.atlassian.net/wiki",
        "--confluence-username",
        "your.email@domain.com",
        "--confluence-token",
        "your_api_token",
        "--jira-url",
        "https://your-domain.atlassian.net",
        "--jira-username",
        "your.email@domain.com",
        "--jira-token",
        "your_api_token"
      ]
    }
  }
}

Running with Docker

FROM node:16
WORKDIR /app
COPY package*.json ./
RUN npm install @modelcontextprotocol/mcp-atlassian
CMD ["npx", "@modelcontextprotocol/mcp-atlassian"]

🔍 Resource Access

⚠️ Important Note

The MCP server filters based on the Confluence space and Jira project that the user is currently interacting with, displaying only the content that the user has permission to operate on.

confluence://{space_key}: Access a specific Confluence space.
jira://{project_key}: Access a specific Jira project.

🛠️ Toolset

Tool	Description
`confluence_search`	Search Confluence content using CQL.
`confluence_get_page`	Get the content of a specific Confluence page.
`confluence_get_page_children`	Get the child pages of a specific page.
`confluence_get_page_ancestors`	Get the parent pages of a specific page.
`confluence_get_comments`	Get the comments on a specific page.
`confluence_create_page`	Create a new Confluence page.
`confluence_update_page`	Update an existing Confluence page.
`confluence_delete_page`	Delete an existing Confluence page.
`confluence_attach_content`	Attach content to a Confluence page.
`jira_get_issue`	Get detailed information about a specific Jira issue.
`jira_search`	Search Jira issues using JQL.
`jira_get_project_issues`	Get all Jira issues for a specific project.
`jira_get_epic_issues`	Get all Jira issues associated with a specific epic.
`jira_create_issue`	Create a new issue in Jira.
`jira_update_issue`	Update an existing Jira issue.
`jira_delete_issue`	Delete an existing Jira issue.
`jira_get_transitions`	Get the transition options for a specific issue.
`jira_get_boards`	Get a list of all boards.
`jira_get_board_columns`	Get the column information for a specific board.
`jira_search_issues`	Search Jira issues using a query.

💻 Development and Debugging

Configuring the MCP Server (Development Mode)

Add the following content to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "development": {
      "command": "npm",
      "args": ["run", "dev"],
      "options": {
        "cwd": "/path/to/@modelcontextprotocol/mcp-atlassian"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

const { MCPClient } = require('@modelcontextprotocol/mcp');
const client = new MCPClient('mcp-atlassian');

client.confluence_search(query => {
  return {
    title: query.title,
    content: query.content,
    comments: query.comments
  };
});