Servidor MCP de Atlassian

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración con Atlassian JIRA y Confluence. Este servidor proporciona herramientas para interactuar con tickets de JIRA y páginas de Confluence mediante el protocolo MCP.

Características

• Obtenga los detalles del ticket de JIRA

• Búsqueda de tickets de JIRA mediante JQL

• Crear nuevos tickets de JIRA

• Agregar comentarios a los tickets de JIRA

• Obtener el contenido de la página de Confluence

• Buscar contenido en Confluence

Related MCP server: Jira MCP Server

Prerrequisitos

• Node.js 16 o superior

• Una cuenta de Atlassian Cloud

• Un token de API de Atlassian

Instalación

Opción 1: Instalar desde Cline Marketplace (recomendado)

1. Cline abierto

2. Vaya a Configuración > Servidores MCP

3. Seleccione la pestaña "Mercado"

4. Buscar "Atlassian"

5. Haga clic en "Instalar"

6. Configure sus credenciales de Atlassian cuando se le solicite

Opción 2: Instalar desde npm

npm install -g atlassian-mcp-server

Opción 3: Instalar desde la fuente

1. Clonar el repositorio

2. Ejecute el script de instalación:

./install.sh

O manualmente:

1. Instalar dependencias

npm install

2. Construir el proyecto

npm run build

3. Instalar globalmente

npm install -g .

4. Ejecutar la configuración

atlassian-mcp-setup

Configuración

Puede configurar el servidor utilizando el script de instalación, un archivo de configuración o variables de entorno.

Usando el script de configuración (recomendado)

Ejecute el script de instalación para crear su archivo de configuración:

npx atlassian-mcp-setup

O si se instala localmente:

npm run setup

El script lo guiará a través del proceso de configuración y creará un archivo config.json en el directorio config .

Usar un archivo de configuración manualmente

1. Crea un archivo config.json en el directorio config (puedes copiarlo desde config.sample.json )

2. Complete sus datos de Atlassian:

{
  "atlassian": {
    "baseUrl": "https://your-instance.atlassian.net",
    "email": "your-email@example.com",
    "token": "your-api-token-here"
  },
  "server": {
    "name": "atlassian-server",
    "version": "0.1.0"
  }
}

Uso de variables de entorno

Establezca las siguientes variables de entorno:

• ATLASSIAN_BASE_URL : la URL de su instancia de Atlassian (por ejemplo, https://your-instance.atlassian.net )

• ATLASSIAN_EMAIL : El correo electrónico de su cuenta Atlassian

• ATLASSIAN_TOKEN : Su token de API de Atlassian

• ATLASSIAN_CONFIG_PATH : (opcional) Ruta a la ubicación de un archivo de configuración personalizado

Obtener un token de API de Atlassian

1. Inicie sesión en su cuenta de Atlassian en https://id.atlassian.com/manage-profile/security/api-tokens

2. Haga clic en "Crear token de API".

3. Dale un nombre a tu token (por ejemplo, "Servidor MCP")

4. Copia el token generado (no podrás volver a verlo)

Uso

Ejecutando el servidor

atlassian-mcp-server

O si se instala desde la fuente:

npm start

Integración con Cline

Opción 1: Instalar desde Marketplace (recomendado)

1. Cline abierto

2. Vaya a Configuración > Servidores MCP

3. Seleccione la pestaña "Mercado"

4. Buscar "Atlassian"

5. Haga clic en "Instalar"

6. Configure sus credenciales de Atlassian cuando se le solicite

Opción 2: Configuración manual

Si ha instalado el servidor manualmente, agregue lo siguiente a la configuración de MCP:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_CONFIG_PATH": "/path/to/your/config.json"
      },
      "disabled": false
    }
  }
}

Alternativamente, puede proporcionar las credenciales directamente en la configuración:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-instance.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_TOKEN": "your-api-token-here"
      },
      "disabled": false
    }
  }
}

Herramientas disponibles

obtener_ticket_jira

Obtener detalles de un ticket de JIRA por clave.

Parámetros:

• ticket_key : clave de ticket JIRA (p. ej., "PROJ-123")

búsqueda_de_tickets_jira

Busque tickets de JIRA usando JQL.

Parámetros:

• jql : cadena de consulta JQL

• max_results : Número máximo de resultados a devolver (predeterminado: 10)

crear_ticket_jira

Crear un nuevo ticket de JIRA.

Parámetros:

• project_key : Clave del proyecto (p. ej., "PROJ")

• summary : Resumen/título del ticket

• description : Descripción del ticket

• issue_type : Tipo de problema (p. ej., "Error", "Tarea", "Historia") (predeterminado: "Tarea")

añadir_comentario_al_ticket_de_jira

Agregar un comentario a un ticket de JIRA.

Parámetros:

• ticket_key : clave de ticket JIRA (p. ej., "PROJ-123")

• comment : Texto del comentario

obtener_página_de_confluencia

Obtener una página de Confluence por ID.

Parámetros:

• page_id : ID de la página de Confluence

búsqueda_confluencia

Buscar contenido en Confluence.

Parámetros:

• query : Consulta de búsqueda

• limit : Número máximo de resultados (predeterminado: 10)

Publicación en el Marketplace

Este servidor está configurado para publicarse en Cline MCP Marketplace mediante el repositorio de GitHub en: https://github.com/kompallik/ATLASSIAN-MCP

Para publicar actualizaciones:

1. Envíe sus cambios al repositorio de GitHub utilizando el script proporcionado:

npm run push-github

2. Agregue un archivo icon.png en el directorio assets si aún no está presente

3. Ejecute el script de publicación:

npm run publish-mcp

4. Siga las instrucciones para publicar en npm y/o crear un paquete de distribución

5. Envíe la URL de su repositorio al equipo de Cline MCP Marketplace

Licencia

Instituto Tecnológico de Massachusetts (MIT)