MyLeantime MCP

Read this in English

Servidor MCP (Model Context Protocol) para gestionar tickets y proyectos en Leantime desde asistentes de IA.

Instalación

Usando npx (recomendado)

No necesitas instalar nada. Usa npx directamente en la configuración de tu agente de IA:

npx myleantime-mcp --url https://TU_LEANTIME_HOST --api-key TU_API_KEY

Instalación global

npm install -g myleantime-mcp
myleantime-mcp --url https://TU_LEANTIME_HOST --api-key TU_API_KEY

Desde el código fuente

git clone https://github.com/dherrero/leantime-mcp.git
cd leantime-mcp
npm install
npm run build

Configuración en agentes de IA

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "leantime": {
      "command": "npx",
      "args": [
        "myleantime-mcp",
        "--url", "https://TU_LEANTIME_HOST",
        "--api-key", "TU_API_KEY"
      ]
    }
  }
}

Claude Code (CLI)

claude mcp add leantime -- npx myleantime-mcp --url https://TU_LEANTIME_HOST --api-key TU_API_KEY

O edita .claude/settings.json en tu proyecto:

{
  "mcpServers": {
    "leantime": {
      "command": "npx",
      "args": [
        "myleantime-mcp",
        "--url", "https://TU_LEANTIME_HOST",
        "--api-key", "TU_API_KEY"
      ]
    }
  }
}

Cursor

Edita ~/.cursor/mcp.json:

{
  "mcpServers": {
    "leantime": {
      "command": "npx",
      "args": [
        "myleantime-mcp",
        "--url", "https://TU_LEANTIME_HOST",
        "--api-key", "TU_API_KEY"
      ]
    }
  }
}

VS Code (GitHub Copilot)

Edita .vscode/mcp.json en tu proyecto o la configuración global de usuario:

{
  "servers": {
    "leantime": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "myleantime-mcp",
        "--url", "https://TU_LEANTIME_HOST",
        "--api-key", "TU_API_KEY"
      ]
    }
  }
}

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "leantime": {
      "command": "npx",
      "args": [
        "myleantime-mcp",
        "--url", "https://TU_LEANTIME_HOST",
        "--api-key", "TU_API_KEY"
      ]
    }
  }
}

Zed

Edita la configuración de Zed (.zed/settings.json o configuración global):

{
  "context_servers": {
    "leantime": {
      "command": {
        "path": "npx",
        "args": [
          "myleantime-mcp",
          "--url", "https://TU_LEANTIME_HOST",
          "--api-key", "TU_API_KEY"
        ]
      }
    }
  }
}

Opciones de configuración

Parámetro	Variable de entorno	Descripción
--url	LEANTIME_URL	URL base de tu instancia de Leantime (https://host) — sin /api/jsonrpc
--api-key	LEANTIME_API_KEY	API Key de Leantime

Los argumentos de CLI tienen prioridad sobre las variables de entorno.

Herramientas disponibles

• Tickets: crear, listar, actualizar y gestionar tickets en Leantime.
• Proyectos: listar y consultar proyectos.

Requisitos

• Node.js 18+
• Una instancia de Leantime con API habilitada y una API Key válida.