amulen-mcp

Servidor MCP para AMULEN, la plataforma de gestión de proyectos, tableros y tareas de 3HTP. Permite que asistentes como Claude consulten y actualicen tu trabajo en AMULEN con tus mismos permisos.

• Autenticación con token personal (sin contraseña).
• Una llamada por herramienta. Los errores (403, 404, 422…) se devuelven con un mensaje claro.
• Comentarios y descripciones en Markdown, que AMULEN muestra con formato.
• Adjuntos de evidencia: archivos locales o textos generados por el agente.

Instalación

1. Crea tu token

En AMULEN → Mi Perfil → Tokens de API → Crear token. Copia el valor (amu_…): se muestra una sola vez. Puedes revocarlo desde el mismo lugar.

2. Configura tu cliente MCP

Necesitas uv. AMULEN_BASE_URL es la dirección de AMULEN que usas en el navegador.

Claude Code

claude mcp add amulen -s user \
  -e AMULEN_BASE_URL=https://amulen.3htp.cloud \
  -e AMULEN_TOKEN=amu_xxx \
  -- uvx amulen-mcp@1.2.0

Claude Desktop y otros clientes (mcpServers en JSON)

{
  "mcpServers": {
    "amulen": {
      "command": "uvx",
      "args": ["amulen-mcp@1.2.0"],
      "env": {
        "AMULEN_BASE_URL": "https://amulen.3htp.cloud",
        "AMULEN_TOKEN": "amu_xxx"
      }
    }
  }
}

Fijar la versión (@1.2.0) evita que una actualización te llegue sin aviso. Para actualizar, cambia el número de versión.

3. Pruébalo

Abre una sesión nueva y pregunta: "¿Tengo tareas en AMULEN?"

Herramientas

No borra tareas, tableros ni proyectos, ni administra usuarios o permisos.

Seguridad

• El servidor corre en tu máquina y solo habla con la AMULEN_BASE_URL que configures.
• El token actúa con tus permisos. AMULEN registra en la auditoría cada cambio hecho con él.
• Si un token se filtra, revócalo en Mi Perfil. Si encuentras una vulnerabilidad, repórtala en privado a los mantenedores (no en un issue público).

Solución de problemas

Desarrollo

uv sync
uv run pytest

Las versiones se publican en PyPI al crear un tag vX.Y.Z (GitHub Actions, Trusted Publishing).

Licencia

MIT. Ver LICENSE.