MCP Atlassian

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

Demostración de funciones

Compatibilidad

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

Guía de configuración

1. Configuración de autenticación

Primero, genere los tokens de autenticación necesarios:

Para Atlassian Cloud

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

Elija uno de estos métodos de instalación:

# Using uv (recommended)
brew install uv
uvx mcp-atlassian

# Using pip
pip install mcp-atlassian

# Using Docker
git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
docker build -t mcp/atlassian .

3. Configuración y uso

Puede configurar el servidor MCP mediante argumentos de línea de comandos. El servidor admite el uso de Confluence, Jira o ambos servicios; incluya solo los argumentos necesarios para su caso de uso.

Argumentos requeridos

Para Atlassian Cloud:

uvx 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

Para servidor/centro de datos:

uvx 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

Nota: Puede configurar solo Confluence, solo Jira o ambos servicios. Simplemente incluya solo los argumentos de los servicios que desee usar. Por ejemplo, para usar solo Confluence Cloud, solo necesitaría --confluence-url , --confluence-username y --confluence-token .

Argumentos opcionales

--transport : Elija el tipo de transporte ( stdio [predeterminado] o sse )
--port : Número de puerto para el transporte SSE (predeterminado: 8000)
--[no-]confluence-ssl-verify : Activa o desactiva la verificación SSL para Confluence Server/DC
--[no-]jira-ssl-verify : Activar o desactivar la verificación SSL para Jira Server/DC
--verbose : aumenta el nivel de detalle del registro (se puede usar varias veces)
--read-only : Ejecutar en modo de solo lectura (desactiva todas las operaciones de escritura)

Nota: Todas las opciones de configuración también se pueden configurar mediante variables de entorno. Consulte el archivo .env.example en el repositorio para ver la lista completa de variables de entorno disponibles.

Integración IDE

Configuración del escritorio de Claude

Uso de uvx (recomendado) - Nube:

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

Nota: Los ejemplos a continuación utilizan la configuración de Atlassian Cloud. Para el servidor/centro de datos, utilice los argumentos correspondientes (--confluence-personal-token, --jira-personal-token) como se muestra en la sección Configuración anterior.

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "python",
      "args": [
        "-m",
        "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"
      ]
    }
  }
}

Nota: Los ejemplos a continuación utilizan la configuración de Atlassian Cloud. Para el servidor/centro de datos, utilice los argumentos correspondientes (--confluence-personal-token, --jira-personal-token) como se muestra en la sección Configuración anterior.

Hay dos formas de configurar el entorno de Docker:

Usando argumentos cli directamente en la configuración:

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

Usando un archivo de entorno:

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

Configuración del IDE del cursor

Abrir configuración del cursor
Vaya a Features > MCP Servers
Haga clic Add new MCP server

Para el transporte de stdio:

name: mcp-atlassian
type: command
command: uvx 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

name: mcp-atlassian
type: command
command: uvx 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

Para el transporte SSE, primero inicie el servidor:

uvx mcp-atlassian ... --transport sse --port 8000

Luego configura en Cursor:

name: mcp-atlassian
type: sse
Server URL: http://localhost:8000/sse

Recursos

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.

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

Herramientas disponibles

Herramienta	Descripción
`confluence_search`	Buscar contenido de Confluence usando CQL
`confluence_get_page`	Obtener el contenido de una página específica de Confluence
`confluence_get_page_children`	Obtener páginas secundarias de una página específica de Confluence
`confluence_get_page_ancestors`	Obtener las páginas principales de una página específica de Confluence
`confluence_get_comments`	Obtener comentarios para una página específica de Confluence
`confluence_create_page`	Crear una nueva página de Confluence
`confluence_update_page`	Actualizar una página de Confluence existente
`confluence_delete_page`	Eliminar una página de Confluence existente
`jira_get_issue`	Obtener detalles de un problema específico de Jira
`jira_search`	Buscar problemas de Jira usando JQL
`jira_get_project_issues`	Obtener todos los problemas de un proyecto específico de Jira
`jira_create_issue`	Crear un nuevo problema en Jira
`jira_update_issue`	Actualizar un problema existente de Jira
`jira_delete_issue`	Eliminar un problema existente de Jira
`jira_get_transitions`	Obtener las transiciones de estado disponibles para un problema de Jira
`jira_transition_issue`	Transición de un problema de Jira a un nuevo estado
`jira_add_worklog`	Agregar una entrada del registro de trabajo a un problema de Jira
`jira_get_worklog`	Obtener entradas del registro de trabajo para un problema de Jira
`jira_link_to_epic`	Vincular un problema a una epopeya
`jira_get_epic_issues`	Obtener todos los problemas vinculados a una epopeya específica

Desarrollo y depuración

Configuración de desarrollo local

Si ha clonado el repositorio y desea ejecutar una versión local:

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

Herramientas de depuración

# Using MCP Inspector
# For installed package
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
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Seguridad

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

Licencia

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

MCP Atlassian

Integrations

MCP Atlassian

Demostración de funciones

Compatibilidad

Guía de configuración

1. Configuración de autenticación

Para Atlassian Cloud

Para servidor/centro de datos

2. Instalación

3. Configuración y uso

Argumentos requeridos

Argumentos opcionales

Integración IDE

Configuración del escritorio de Claude

Configuración del IDE del cursor

Recursos

Herramientas disponibles

Desarrollo y depuración

Configuración de desarrollo local

Herramientas de depuración

Seguridad

Licencia

Appeared in Searches