MCP Atlassian

Servidor de Protocolo de Contexto de Modelo (MCP) para productos de Atlassian (Confluence y Jira). Esta integración es compatible con las implementaciones de Confluence y Jira Cloud y de servidor/centro de datos.

Ejemplo de uso

Pídale a su asistente de IA que:

Actualizaciones automáticas de Jira : "Actualizar Jira desde las notas de la reunión"
Búsqueda en Confluence con IA : "Encuentra nuestra guía OKR en Confluence y resúmela"
Filtrado inteligente de incidencias de Jira : "Muéstrame errores urgentes en el proyecto PROJ de la semana pasada"
📄 Creación y gestión de contenido : "Crear un documento de diseño técnico para la función XYZ"

Demostración de funciones

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

Compatibilidad

Producto	Tipo de implementación	Estado de soporte
Confluencia	Nube	✅ Totalmente compatible
Confluencia	Servidor/Centro de datos	✅ Compatible (versión 6.0+)
Jira	Nube	✅ Totalmente compatible
Jira	Servidor/Centro de datos	✅ Compatible (versión 8.14+)

Guía de inicio rápido

1. Configuración de autenticación

Primero, genere los tokens de autenticación necesarios para Confluence y Jira:

Para la nube

Vaya a https://id.atlassian.com/manage-profile/security/api-tokens
Haga clic en Crear token de API y asígnele un nombre.
Copiar el token inmediatamente

Para servidor/centro de datos

Vaya a su perfil (avatar) → Perfil → Tokens de acceso personal
Haga clic en Crear token , asígnele un nombre y configure la fecha de caducidad.
Copiar el token inmediatamente

2. Instalación

La forma principal de utilizar MCP Atlassian es a través de la integración IDE:

Opción 1: Usar uvx (recomendado)

Primero instale uv:

macOS/Linux:

# Using the official installer
curl -LsSf https://astral.sh/uv/install.sh | sh

# Alternatively, on macOS you can use Homebrew
brew install uv

Ventanas:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Con uv instalado, puede usar uvx mcp-atlassian directamente en su configuración IDE sin instalar el paquete por separado.

Opción 2: Usar pip

pip install mcp-atlassian

Opción 3: Uso de herrería

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

Opción 4: Usar Docker

Clonar el repositorio:
git clone https://github.com/sooperset/mcp-atlassian.git cd mcp-atlassian
Construya la imagen de Docker:
docker build -t mcp/atlassian .

3. Opciones de configuración clave

Al configurar su IDE, puede utilizar estas variables de entorno opcionales:

CONFLUENCE_SPACES_FILTER : Filtrar por claves de espacio (p. ej., "DEV,TEAM,DOC")
JIRA_PROJECTS_FILTER : Filtrar por claves de proyecto (p. ej., "PROJ,DEV,SUPPORT")
READ_ONLY_MODE : Establézcalo en "verdadero" para deshabilitar las operaciones de escritura
MCP_VERBOSE : Establézcalo en "verdadero" para un registro más detallado

Nota: Puede configurar solo Confluence, solo Jira o ambos servicios incluyendo solo las variables para los servicios que necesita.

Consulte el archivo .env.example para ver todas las opciones disponibles.

Integración IDE

MCP Atlassian está diseñado para usarse con asistentes de IA a través de la integración IDE.

Nota : Para aplicar la configuración en Claude Desktop:
Método 1 (recomendado) : Haga clic en el menú de hamburguesa (☰) > Configuración > Desarrollador > botón "Editar configuración"
Método 2 : Localice y edite el archivo de configuración directamente:
Ventanas : %APPDATA%\Claude\claude_desktop_config.json
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json
Para el cursor : Abra Configuración → Características → Servidores MCP → + Agregar nuevo servidor MCP global

A continuación se explica cómo configurarlo según su método de instalación:

Uso de uvx (recomendado)

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Para implementaciones de servidor/centro de datos, utilice estas variables de entorno en su lugar:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://confluence.your-company.com",
        "CONFLUENCE_PERSONAL_TOKEN": "your_token",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_token"
      }
    }
  }
}

Sólo para Confluence:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Solo para Jira:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

También puedes utilizar argumentos de línea de comandos en lugar de variables de entorno:

{
  "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"
      ]
    }
  }
}

Si ha instalado mcp-atlassian con pip, utilice esta configuración en su lugar:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "mcp-atlassian",
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Si ha creado la imagen de Docker, utilice esta configuración:

Método 1: Uso de variables de entorno

{
  "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"
      ]
    }
  }
}

Método 2: Uso de un archivo de entorno

Cree un archivo .env basado en la plantilla .env.example en el repositorio y complételo con sus variables, luego use:

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

Configuración de transporte SSE

Inicie el servidor con:

uvx mcp-atlassian --transport sse --port 9000 \
  --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

Configurar en su IDE:

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

Recursos y herramientas

Recursos

confluence://{space_key} : Acceder a los espacios de Confluence
jira://{project_key} : Acceder a proyectos de Jira

Nota: El servidor MCP filtra los recursos para mostrar solo los espacios de Confluence y los proyectos de Jira con los que el usuario está interactuando activamente, en función de sus contribuciones y asignaciones.

Herramientas clave

Herramientas de Confluence

confluence_search : busca contenido de Confluence usando CQL
confluence_get_page : Obtener el contenido de una página específica
confluence_create_page : Crea una nueva página
confluence_update_page : Actualizar una página existente

Herramientas de Jira

jira_get_issue : obtener detalles de un problema específico
jira_search : Problemas de búsqueda con JQL
jira_create_issue : Crea un nuevo problema
jira_update_issue : Actualizar un problema existente
jira_transition_issue : Transición de un problema a un nuevo estado
jira_add_comment : Agregar un comentario a un problema

Herramientas de Confluence	Herramientas de Jira
`confluence_search`	`jira_get_issue`
`confluence_get_page`	`jira_search`
`confluence_get_page_children`	`jira_get_project_issues`
`confluence_get_page_ancestors`	`jira_get_epic_issues`
`confluence_get_comments`	`jira_create_issue`
`confluence_create_page`	`jira_batch_create_issues`
`confluence_update_page`	`jira_update_issue`
`confluence_delete_page`	`jira_delete_issue`
	`jira_get_transitions`
	`jira_transition_issue`
	`jira_add_comment`
	`jira_add_worklog`
	`jira_get_worklog`
	`jira_download_attachments`
	`jira_link_to_epic`
	`jira_get_agile_boards`
	`jira_get_board_issues`
	`jira_get_sprints_from_board`
	`jira_get_sprint_issues`
	`jira_create_issue_link`
	`jira_remove_issue_link`

Solución de problemas y depuración

Problemas comunes

Errores de autenticación :
- Para la nube: Verifique sus tokens API (no la contraseña de su cuenta)
- Para servidor/centro de datos: Verifique que su token de acceso personal sea válido y no esté vencido
- Para servidores Confluence más antiguos: Algunas versiones anteriores requieren autenticación básica con CONFLUENCE_USERNAME y CONFLUENCE_API_TOKEN (donde token es su contraseña)
Problemas con el certificado SSL : si usa un servidor o centro de datos y encuentra errores de SSL, configure CONFLUENCE_SSL_VERIFY=false o JIRA_SSL_VERIFY=false
Errores de permisos : asegúrese de que su cuenta de Atlassian tenga permisos suficientes para acceder a los espacios/proyectos

Herramientas de depuración

# Using MCP Inspector for testing
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %APPDATA%\Claude\logs\mcp*.log | more

Seguridad

Nunca comparta tokens API
Mantenga los archivos .env seguros y privados
Consulte SECURITY.md para conocer las mejores prácticas

Contribuyendo

¡Agradecemos sus contribuciones a MCP Atlassian! Si desea contribuir:

Consulta nuestra guía CONTRIBUTING.md
Configure su entorno de desarrollo:
uv sync --frozen --all-extras --dev pre-commit install
Realizar cambios y enviar una solicitud de extracción

Usamos ganchos previos a la confirmación para garantizar la calidad del código y seguimos el control de versiones semántico para los lanzamientos.

Licencia

Con licencia del MIT (véase el archivo de LICENCIA ). Este no es un producto oficial de Atlassian.

MCP Atlassian

Integrations

MCP Atlassian

Ejemplo de uso

Demostración de funciones

Compatibilidad

Guía de inicio rápido

1. Configuración de autenticación

Para la nube

Para servidor/centro de datos

2. Instalación

3. Opciones de configuración clave

Integración IDE

Uso de uvx (recomendado)

Configuración de transporte SSE

Recursos y herramientas

Recursos

Herramientas clave

Herramientas de Confluence

Herramientas de Jira

Solución de problemas y depuración

Problemas comunes

Herramientas de depuración

Seguridad

Contribuyendo

Licencia

Tools

Appeared in Searches