MCP Atlassian Server

MCP Atlassian Server

Atlassian 製品（Confluence、Jira）を Model Context Protocol と統合する MCP サーバーです。このツールを使うと、MCP インターフェースから Confluence のコンテンツや Jira チケットに簡単にアクセスできます。

機能

Confluence

• CQL（Confluence Query Language）を使ったコンテンツの検索
• ページ、添付ファイル、コメントへのアクセス
• スペースによる絞り込み

Jira

• JQL（Jira Query Language）を使った課題の検索
• ステータス、担当者、タイムスタンプなどの課題の詳細の取得

インストール

Smithery 経由でのインストール

Smithery 経由で Atlassian Integration Server を Claude Desktop に自動でインストールするには、以下を実行します。

npx -y @smithery/cli install @petrsovadina/mcp-atlassian --client claude

手動インストール

git clone https://github.com/petrsovadina/mcp-atlassian.git
cd mcp-atlassian
npm install
npm run build

設定

次の環境変数を設定します。

Confluence

CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
[email protected]
CONFLUENCE_API_TOKEN=your-api-token

Jira

JIRA_URL=https://your-domain.atlassian.net
[email protected]
JIRA_API_TOKEN=your-api-token

MCP での使用

次の設定を MCP settings ファイルに追加します。

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/path/to/mcp-atlassian/build/index.js"],
      "env": {
        "CONFLUENCE_URL": "your-confluence-url",
        "CONFLUENCE_USERNAME": "your-username",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "JIRA_URL": "your-jira-url",
        "JIRA_USERNAME": "your-username",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

利用可能なツール

confluence_search

CQL を使って Confluence のコンテンツを検索します。

{
  "query": "type=page AND space='Engineering'", // CQL dotaz
  "limit": 10 // volitelný limit výsledků (1-50)
}

jira_search

JQL を使って Jira の課題を検索します。

{
  "jql": "project = ENG AND status = Open", // JQL dotaz
  "fields": "summary,status,assignee", // volitelné pole
  "limit": 10 // volitelný limit výsledků (1-50)
}

リソーステンプレート

Confluence ページ

confluence://{space_key}/pages/{title}

Jira 課題

jira://{project_key}/issues/{issue_key}

使用例

Confluence の検索

const result = await mcp.use('confluence_search', {
  query: "type=page AND space='Engineering' ORDER BY created DESC",
  limit: 5
});

Jira の検索

const result = await mcp.use('jira_search', {
  jql: "project = ENG AND status = 'In Progress'",
  fields: "summary,status,assignee,created",
  limit: 5
});

貢献

開発に貢献する場合は、次の手順を実行してください。

1. リポジトリをフォークします
2. feature branch を作成します
3. 変更をコミットします
4. branch をプッシュします
5. Pull Request を作成します

ライセンス

MIT