Atlassian MCP Server

Servidor MCP de Atlassian

Un servidor de Protocolo de Contexto de Modelo (MCP) de solo lectura para productos de Atlassian (Confluence y Jira).

Instalación

pip install -e .

Configuración

Establece tus credenciales de Atlassian como variables de entorno:

export ATLASSIAN_DOMAIN=your-company.atlassian.net
export ATLASSIAN_EMAIL=your-email@company.com

# Separate tokens for each service (recommended)
export ATLASSIAN_CONFLUENCE_TOKEN=your-confluence-token
export ATLASSIAN_JIRA_TOKEN=your-jira-token

# OR for backward compatibility, single token (if it has access to both)
export ATLASSIAN_API_TOKEN=your-api-token

Creación de Tokens de API

1. Ve a: https://id.atlassian.com/manage-profile/security/api-tokens
2. Haz clic en "Crear token de API"

Para Confluence:

• Al crear un token de Confluence, selecciona estos alcances:
  • read:content:confluence - Ver páginas, publicaciones de blog, comentarios, archivos adjuntos
  • read:content-details:confluence - Ver metadatos y propiedades de contenido

Para Jira:

• Al crear un token de Jira, verás diferentes opciones de alcance. Busca:
  • Alcances que permitan leer incidencias y proyectos
  • Capacidades de búsqueda para consultas JQL
  • Permisos básicos de exploración

Nota: Los nombres exactos de los alcances pueden variar en la interfaz de Atlassian. Elige los alcances mínimos de solo lectura que permitan ver incidencias, proyectos y buscar. Si no estás seguro, puedes comenzar con permisos de lectura más amplios y restringirlos más tarde.

Uso

Inicia el servidor MCP:

atlassian-mcp

Herramientas Disponibles

Confluence

• confluence_get_page - Obtener una página por ID
• confluence_get_page_by_url - Obtener una página por URL
• confluence_search_pages - Buscar páginas
• confluence_list_spaces - Listar todos los espacios

Jira

• jira_get_issue - Obtener una incidencia por clave (ej., PROJ-123)
• jira_get_issue_by_url - Obtener una incidencia por URL
• jira_search_issues - Buscar incidencias usando JQL
• jira_list_projects - Listar todos los proyectos

URLs Compatibles

Páginas de Confluence

• https://domain.atlassian.net/wiki/spaces/SPACE/pages/123456/Page+Title
• https://domain.atlassian.net/wiki/display/SPACE/Page+Title?pageId=123456
• https://domain.atlassian.net/wiki/pages/viewpage.action?pageId=123456

Incidencias de Jira

• https://domain.atlassian.net/browse/PROJ-123
• https://domain.atlassian.net/jira/software/projects/PROJ/boards/1?selectedIssue=PROJ-123

Configuración del Cliente MCP

{
  "mcpServers": {
    "atlassian": {
      "command": "python",
      "args": ["-m", "atlassian_mcp.server"],
      "cwd": "/path/to/your/atlassian_mcp",
      "env": {
        "ATLASSIAN_DOMAIN": "your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@company.com",
        "ATLASSIAN_CONFLUENCE_TOKEN": "your-confluence-token",
        "ATLASSIAN_JIRA_TOKEN": "your-jira-token"
      }
    }
  }
}

Puntos de Conexión de API Utilizados

Este servidor utiliza los siguientes puntos de conexión de la API REST de Atlassian:

API REST de Confluence:

• GET /wiki/rest/api/content/{id} - Obtener contenido de página
• GET /wiki/rest/api/content/search - Buscar páginas usando CQL
• GET /wiki/rest/api/space - Listar espacios

API REST de Jira v3:

• GET /rest/api/3/issue/{issueIdOrKey} - Obtener detalles de incidencia
• GET /rest/api/3/search - Buscar incidencias usando JQL
• GET /rest/api/3/project - Listar proyectos

Todos los puntos de conexión son de solo lectura y requieren autenticación básica con tu correo electrónico y token de API.