Conectar Immich MCP con Microsoft Copilot

💡 ¿No quieres instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Immich, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Immich + Microsoft Copilot

Deja que tu IA lea tu biblioteca de fotos de Immich: cuántas fotos y vídeos tienes, tus álbumes y con quién se comparten, la fecha, el lugar, la cámara y las personas de una foto, las personas que Immich ha reconocido y cuántas imágenes se tomaron cada mes. Solo lectura: nunca sube, edita ni elimina nada. Funciona con Immich 3.0 o posterior autoalojado.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:

IMMICH_URL, IMMICH_API_KEY

Paso 1 — Obtén las credenciales

La configuración lleva unos 3 minutos. Necesitas Immich 3.0 o posterior y una clave de API del usuario cuya biblioteca debe leer la IA. No hace falta una cuenta de administrador.

1. Establece IMMICH_URL con la dirección en la que abres Immich, sin /api y sin barra final, por ejemplo https://photos.example.com o http://192.168.1.10:2283 (el puerto por defecto es 2283).
2. Inicia sesión en Immich como ese usuario, abre Account Settings → API Keys → New API Key y concede únicamente user.read, asset.read, asset.statistics, album.read y person.read. Copia la clave en IMMICH_API_KEY; Immich solo la muestra una vez. Se envía en la cabecera x-api-key.
3. Instala el conector y ejecuta immich_get_my_user: muestra el usuario asociado a la clave, además de su cuota de almacenamiento y su uso.

Dónde se ejecuta Immich: en un AnythingMCP autoalojado, Immich suele estar en un servidor doméstico o un NAS (http://192.168.x.x:2283). La protección SSRF de salida bloquea por defecto las direcciones privadas y locales, así que un administrador debe permitir el host mediante SSRF_ALLOWED_HOSTS o la lista de permitidos en los ajustes de administración. AnythingMCP Cloud solo puede acceder a un servidor Immich expuesto a internet por HTTPS, por ejemplo detrás de un proxy inverso. Se rechaza una IP privada o un nombre de host local, y la lista de permitidos no se puede modificar en Cloud.

Qué lee: el número de fotos y vídeos con immich_get_asset_statistics (sin filtros cuenta todos los elementos que no están en la papelera, incluidos los archivados; visibility=timeline coincide con la línea de tiempo principal); los álbumes y con quién se comparten (immich_list_albums, immich_get_album); una foto o vídeo con fechas, cámara, objetivo, exposición, GPS, ciudad, país, personas y etiquetas (immich_get_asset); las personas reconocidas por nombre (immich_search_people); los lugares por nombre con coordenadas (immich_search_places); y los recuentos por mes por persona, álbum, etiqueta o favoritos (immich_get_timeline_buckets). Todos los identificadores son UUID.

Privacidad: una clave de Immich solo ve la biblioteca del usuario que la creó, además de los álbumes compartidos con ese usuario, y eso incluye sus fotos, caras y ubicaciones. Asigna este conector solo a servidores MCP cuyos usuarios puedan ver esta biblioteca. Las rutas de archivos del servidor, las sumas de verificación, los thumbhashes, los identificadores de OAuth y las claves de licencia se eliminan de las respuestas.

Errores comunes: 401 significa que la clave es incorrecta o se ha eliminado; 401 "Elevated permission is required" se refiere a la carpeta bloqueada, que una clave de API no puede leer. 403 "Missing required permission" significa que a la clave le falta uno de los cinco permisos. 400 "Not found or no ... access" significa que no existe ningún elemento ni álbum con ese identificador en esta biblioteca (Immich responde 400, no 404). 400 "Validation failed" significa que un identificador no es un UUID, que un valor no está permitido o que falta name en una búsqueda de personas o lugares. 404 en todas las llamadas significa que IMMICH_URL es incorrecta o termina en /api.

El conector es de solo lectura: no sube, edita, marca como favorito, archiva, envía a la papelera ni elimina elementos, no modifica álbumes, etiquetas ni personas, no descarga originales, miniaturas ni vídeos, no ejecuta búsquedas inteligentes ni por metadatos, y no abre la carpeta bloqueada, los enlaces compartidos, los recuerdos, los endpoints de administración ni la gestión de claves de API.

Paso 2 — Instala el adaptador

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añade el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Immich.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Preguntas frecuentes

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT