ama-mcp-atlassian

Servidor MCP independiente en TypeScript que envuelve la API REST de Atlassian (Jira + Confluence). Funciona de forma independiente mediante variables de entorno o integrado con el registro a través de ama-mcp-registry.

Instalación

npm install -g @ama-work/mcp-atlassian
# or
bunx @ama-work/mcp-atlassian

Related MCP server: Jira MCP Integration

Uso

Modo independiente

Proporcione un token de acceso OAuth de Atlassian y su ID de nube directamente:

{
  "mcpServers": {
    "atlassian": {
      "command": "bunx",
      "args": ["@ama-work/mcp-atlassian"],
      "env": {
        "ATLASSIAN_ACCESS_TOKEN": "your-oauth-access-token",
        "ATLASSIAN_CLOUD_ID": "your-atlassian-cloud-id"
      }
    }
  }
}

Modo integrado con el registro

Si ejecuta ama-mcp-registry, el servidor obtiene su token automáticamente:

{
  "mcpServers": {
    "atlassian": {
      "command": "bunx",
      "args": ["@ama-work/mcp-atlassian"],
      "env": {
        "REGISTRY_URL": "https://your-registry.example.com",
        "INSTANCE_ID": "your-instance-id",
        "GATEWAY_PSK": "your-pre-shared-key"
      }
    }
  }
}

El token se almacena en caché y se renueva de forma proactiva 5 minutos antes de que expire.

Herramientas

Jira: jira_search_issues, jira_get_issue, jira_create_issue, jira_update_issue, jira_transition_issue, jira_add_comment, jira_get_projects

Confluence: confluence_search, confluence_get_page, confluence_create_page, confluence_update_page, confluence_add_comment, confluence_get_spaces

Meta: atlassian_whoami

Desarrollo

bash bootstrap.sh
bun run typecheck
bun run lint

Licencia

MIT