Conecta un asistente de IA con MCP

Con el Model Context Protocol (MCP), puedes conectar un asistente de IA a tu biblioteca de PixelUnion. Después puedes pedirle cosas como «busca fotos de la playa del verano pasado» o «crea un álbum llamado Islandia 2026 con todas las fotos de febrero», y el asistente lo hace por ti.

Esta guía usa ImmichMCP, un proyecto gratuito de código abierto. Es un proyecto de la comunidad, no creado ni mantenido por PixelUnion ni por el equipo de Immich. No podemos ayudarte con problemas del propio ImmichMCP, pero te ayudamos con mucho gusto con la parte de PixelUnion.

Antes de empezar

Lee esto primero. Cuando usas un servicio de IA en la nube como Claude o ChatGPT, la información que el asistente lee de tu biblioteca se envía a ese servicio. Puede incluir nombres de archivo, fechas, ubicaciones, nombres de personas y, a veces, imágenes de vista previa. PixelUnion guarda tus fotos en Europa, pero en cuanto estos datos llegan al servicio de IA, se aplican sus condiciones de privacidad. Si quieres que todo se quede en tu propio ordenador, usa un modelo local, por ejemplo a través de LM Studio.

Necesitarás:

• Tu dirección de PixelUnion (p. ej. https://yourname.pixelunion.eu)
• Docker Desktop instalado y en ejecución
• Una aplicación de IA compatible con MCP, como Claude Desktop o LM Studio

Paso 1: crea una clave API

1. Inicia sesión en tu dominio de PixelUnion (p. ej. https://yourname.pixelunion.eu)
2. Haz clic en el icono de tu perfil (arriba a la derecha) y ve a Configuración de cuenta
3. Ve a Claves API y haz clic en Nueva clave API
4. Ponle un nombre, por ejemplo «Asistente de IA»
5. Elige los permisos. Te recomendamos empezar con acceso de solo lectura: asset.read, asset.view, album.read, person.read y tag.read. Más adelante puedes crear una nueva clave con más permisos, por ejemplo album.create para que el asistente pueda crear álbumes.
6. Haz clic en Crear y copia la clave

Solo verás la clave una vez. Guárdala en un lugar seguro, como un gestor de contraseñas.

Paso 2: añade ImmichMCP a Claude Desktop

1. Abre Claude Desktop
2. Ve a Configuración → Desarrollador y haz clic en Editar configuración
3. Se abre un archivo llamado claude_desktop_config.json. Pega lo siguiente y sustituye la dirección y la clave por las tuyas:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "mcpServers": {
    "immich": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
               "-e", "IMMICH_BASE_URL=https://yourname.pixelunion.eu",
               "-e", "IMMICH_API_KEY=your-api-key",
               "ghcr.io/barryw/immichmcp:latest", "--stdio"]
    }
  }
}

4. Guarda el archivo y reinicia Claude Desktop por completo

Cuando Claude se vuelva a abrir, verás immich en la lista de conectores o herramientas. El primer arranque puede tardar un minuto, porque Docker descarga ImmichMCP en segundo plano.

Otras aplicaciones MCP usan una configuración parecida. Consulta la documentación de tu aplicación para saber dónde añadir un servidor MCP.

Paso 3: pruébalo

Abre un chat nuevo y pregunta algo sobre tus fotos, por ejemplo:

• «¿Cuántas fotos tengo en PixelUnion?»
• «Busca fotos de una puesta de sol en la playa»
• «¿Qué álbumes tengo?»

El asistente te pedirá permiso antes de usar una herramienta por primera vez. Cuando lo permitas, verás los resultados en el chat.

Consejos

• Borrar está protegido. ImmichMCP solo borra fotos o álbumes cuando la petición lo confirma de forma explícita. Aun así, lee lo que el asistente piensa hacer antes de aprobar el uso de una herramienta.
• Tu clave API se guarda en texto plano en el archivo de configuración. No compartas ese archivo y no uses esta configuración en un ordenador compartido.
• Retira el acceso en cualquier momento borrando la clave API en Configuración de cuenta → Claves API. El asistente pierde el acceso de inmediato.
• ¿No pasa nada? Comprueba que Docker Desktop está en ejecución y que tu dirección de PixelUnion empieza por https://.

Estamos estudiando ofrecer MCP directamente desde PixelUnion en el futuro, sin Docker ni claves API en un archivo. Todavía no lo hemos decidido. Si tienes comentarios, contacta con nosotros.