Jira & Confluence MCP Servers

Servidores MCP para interagir com as APIs do Jira e Confluence.

GitHub

Documentação

Jira & Confluence MCP Servers

Servidores MCP (Model Context Protocol) baseados em Python que permitem interagir com as APIs do Jira e do Confluence.

Configuração

1. Instalação das dependências

uv sync

2. Configuração das variáveis de ambiente

Copie .env.example para .env e configure as credenciais:

cp .env.example .env

Configure as seguintes informações:

  • JIRA_URL / CONFLUENCE_URL: URL da instância do Atlassian
  • JIRA_USERNAME / CONFLUENCE_USERNAME: endereço de e-mail
  • JIRA_API_TOKEN / CONFLUENCE_API_TOKEN: token da API (gerado em aqui)
  • JIRA_CLOUD / CONFLUENCE_CLOUD: para a versão em nuvem, use true; para a versão de servidor, use false

Como usar

Iniciando o servidor MCP do Jira

uv run python src/jira_server.py

Iniciando o servidor MCP do Confluence

uv run python src/confluence_server.py

Ferramentas disponíveis

Jira MCP

  • jira_search_issues: pesquisar issues usando JQL
  • jira_get_issue: obter detalhes de uma issue específica
  • jira_create_issue: criar uma nova issue
  • jira_update_issue: atualizar uma issue existente
  • jira_add_comment: adicionar um comentário a uma issue
  • jira_transition_issue: alterar o status de uma issue
  • jira_get_projects: obter a lista de projetos

Confluence MCP

  • confluence_search_content: pesquisar conteúdo usando CQL
  • confluence_get_page: obter detalhes de uma página
  • confluence_create_page: criar uma nova página
  • confluence_update_page: atualizar uma página existente
  • confluence_delete_page: excluir uma página
  • confluence_get_spaces: obter a lista de espaços
  • confluence_get_page_children: obter páginas filhas
  • confluence_add_attachment: adicionar um anexo a uma página

Configuração no Claude Desktop

Adicione o seguinte ao arquivo de configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "jira": {
      "command": "/path/to/jira-confluence-mcp/run_jira.sh",
      "args": [],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_CLOUD": "true"
      }
    },
    "confluence": {
      "command": "/path/to/jira-confluence-mcp/run_confluence.sh",
      "args": [],
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USERNAME": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_CLOUD": "true"
      }
    }
  }
}

Atenção:

  • Substitua a parte /path/to/jira-confluence-mcp/ pelo caminho real do projeto
  • O token da API pode ser gerado em Configurações da conta Atlassian
  • run_jira.sh e run_confluence.sh são scripts de shell localizados na raiz do projeto

Exemplos de uso

Jira

# イシューの検索
await jira_search_issues({"jql": "project = PROJ AND status = 'In Progress'", "max_results": 10})

# イシューの作成
await jira_create_issue({
    "project_key": "PROJ",
    "summary": "新しいタスク",
    "description": "タスクの説明",
    "issue_type": "Task",
    "priority": "Medium"
})

# イシューのステータス変更
await jira_transition_issue({"issue_key": "PROJ-123", "status": "Done"})

Confluence

# ページの検索
await confluence_search_content({"cql": "space = DEV AND title ~ 'API'"})

# ページの作成
await confluence_create_page({
    "space_key": "DEV",
    "title": "新しいドキュメント",
    "content": "<p>ページの内容</p>"
})

# ページの更新
await confluence_update_page({
    "page_id": "123456",
    "content": "<p>更新された内容</p>",
    "version_comment": "APIドキュメントを更新"
})

Licença

MIT