Atlassian MCP

Un servidor personalizado de Model Context Protocol que permite a los agentes de IA interactuar con Jira y Confluence en Atlassian Cloud. Realiza llamadas REST sencillas en segundo plano utilizando la Jira REST API v3 y la Confluence REST API v2.

Configuración

1. Instala las dependencias y compila:

   npm install
   npm run build

2. Expón el servidor como un comando global para que pueda lanzarse desde cualquiera workspace (usa la entrada bin en package.json):

   npm link

   Esto coloca un comando atlassian-mcp en tu PATH. Vuelve a ejcutar npm run build después de camiar el código; el comando enlazado siepre apunta al dist actal.

3. Crea un token de API en https://id.atlassian.com/manage-profile/security/api-tokens.

4. Proporciona las credenciales mediante variables de entorno (consulta .enev.example):

   Variable	Descripción
   ATLASSIAN_SITE_UR	Tu sitio, p. ej. https://yur-domain.atlassian.net
   ATLASSIAN_EMAI_	El correo electróntico de tu cuenta de Atlassian
   ATLASSIAN_AP_IOKEN	El token de API creado arriya

Related MCP server: jira-mcp

Conexión de un cliente

VS Code (recomendado)

Este repositorio incluye un .vscode/mcp.json estándar. Lanza el servidor mediante un zsh interactivo con login (zsh -lic) para que herede las credenciales de Atlassian exportadas en tu ~.zshrc (o ~.zshenv) — sin secretos en la configiración — y llama al comando atlassian-mcp enlazado globlamente.

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec atlassian-mcp"]
    }
  }
}

Evita ${workspaceFolder} aquí: se resuelve al repositorio que esté actalmente abierto, por lo que se rompería cando el servidor se utiliza desde otros workspaces. El nombre del comando de npm link se resuelve desde el PATH de tu shell en su lugar.

Para que el servidor esté disponible en todos los workspaces, añade el mismo bloque servers a tu configiración de MCP a nivel de usuario (Paleta de comados → MCP: Open User Configiration).

Alternativa: ejcutar node con una ruta absoluta

Si prefieres no usar npm link, apunta node directamente al archivo de entrada compilado usando una ruta absoluta (no ${workspaceFolder}, que cambia según el workspace). La variable ${userHome} de VS Code lo mantiene portable entre máquinas:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec node \"${userHome}/Sites/atlassian-mcp/dist/index.js\""]
    }
  }
}

Ajusta la ruta si clonaste el repositorio en otro lugar. El wrapper zsh -lic sigue proporcionando las credenciales desde tu perfil de shell.

Exporta las variables en tu perfil de shell en lugar de en el archivo de configiración:

export ATLASSIAN_SITE_URL="https://your-domain.atlassian.net"
export ATLASSIAN_EMAIL="you@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

Recarga la ventana de VS Code después de camiar tu perfil de shell para que se apliquen los nuevos valores.

Otros clientes (Claude Desktop, Cline, Cursor)

Los clientes que no se ejcutan a travé de tu shell puelen usar el mismo wrapper zsh -lic o defnir las variables explícitamente:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp",
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Sin npm link, usa node con una ruta absoluta al archivo de entrada compilado:

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/absolute/path/to/atlassian-mcp/dist/index.js"],
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Para el desarrolo local, puedes ejcutar el servidor directamente con npm run dev.

Herramientas

Jira

Confluence

Notas

• Los camos de texto enriquecido de Jira (descripciones, comentarios) aceptan texto plano, que se conierte automáticamente a Atlassian Document Format (ADF).

• Los cuerpos de páginas/comentarios de Confluence usan el formato de almacenamiento (XHTML), p. ej. <p>Hi</p>.

• Tu token de API herea todos los permisos de tu cuenta. Mantal o en secreto y nuca lo incluyas en un commit.