Cómo conectar Meta Catalog a Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Meta Catalog, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Meta Catalog + Microsoft Copilot

Deja que tu IA revise y mantenga tus catálogos de productos de Meta (Commerce Manager): productos con precios, stock y estado de revisión, conjuntos de productos, feeds de datos y errores de carga, y el diagnóstico del catálogo. Tras tu confirmación también puede actualizar, añadir o borrar productos en bloque (desactivado al instalar).

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

META_CATALOG_ACCESS_TOKEN, META_CATALOG_BUSINESS_ID

Paso 1 — Obtener credenciales

La configuración lleva unos 10 minutos. Necesitas un portfolio comercial de Meta con un catálogo de productos en Commerce Manager y una app de Meta.

1. Abre developers.facebook.com/apps/creation y crea una app de negocio conectada a tu portfolio comercial. Si ya usas el conector de Meta Ads, puedes reutilizar su app.
2. Recomendado, un token que no caduca: en Business Settings abre Users → System users y añade un usuario del sistema. En Assign assets → Catalogs asígnale tu catálogo (Manage catalog, o View catalog si la IA solo debe leer). Haz clic en Generate token, elige la app, pon Never como caducidad y marca catalog_management y business_management. Meta puede pedirte antes que verifiques el portfolio comercial.
3. Pega el token en META_CATALOG_ACCESS_TOKEN. Empieza por EA; pégalo sin la palabra Bearer.
4. Pon el id del portfolio comercial en META_CATALOG_BUSINESS_ID: solo dígitos, desde Business Settings → Business info o desde business_id= en la barra de direcciones de business.facebook.com. Con un token de usuario del sistema, meta_catalog_list_businesses devuelve una lista vacía, así que toma el id de Business Settings.
5. Instala el conector y ejecuta meta_catalog_check_permissions: los dos permisos deben aparecer como granted. Después meta_catalog_list_catalogs lista tus catálogos con su número de productos.

Con un token de usuario: un token de usuario del Graph API Explorer (tu app, User Token, los mismos dos permisos) dura solo una o dos horas. Rellena también los campos opcionales META_APP_ID y META_APP_SECRET (en tu app, en App settings → Basic): AnythingMCP cambia entonces el token por uno de larga duración, de unos 60 días, en la primera llamada y lo renueva cuando quedan menos de 10 días, igual que en el conector de Meta Ads. Sin ellos, amplía tú el token en el Access Token Debugger (Extend Access Token) y sustitúyelo antes de que pasen los 60 días; la página del conector te avisa con antelación. Con un token de usuario del sistema, déjalos vacíos.

Qué lee: los catálogos de tu empresa y los que tus clientes han compartido con ella (como los ve una agencia o un partner, con tus roles en cada uno); productos con SKU (retailer_id), nombre, precio y precio de oferta, disponibilidad, inventario, estado de revisión (approved, pending, rejected, outdated), visibilidad, errores y motivos de rechazo; conjuntos de productos con su regla de filtro y sus productos; feeds de datos con su programación, sesiones de carga (artículos detectados, guardados, no válidos y borrados) y errores de carga con número de fila y SKU; y el diagnóstico que muestra Commerce Manager, marcado como MUST_FIX u OPPORTUNITY.

Averiguar por qué no se muestran los productos: la IA empieza con meta_catalog_get_diagnostics, luego lista los productos con errores o con un estado de revisión concreto y lee con meta_catalog_get_product los errores y motivos de rechazo exactos de un producto. Para problemas de feed va de meta_catalog_list_feeds a meta_catalog_list_feed_uploads y de ahí a meta_catalog_list_upload_errors.

Dos ids por producto: Meta da a cada producto su propio id, y tu SKU es el retailer_id (la columna id de un feed). La IA usa el id de Meta para productos sueltos y el SKU en cambios en bloque y filtros. Los precios llegan como texto con la moneda, por ejemplo 19.99 EUR.

Los cambios llegan a anuncios y tiendas: los catálogos alimentan los anuncios de catálogo Advantage+, las tiendas de Facebook e Instagram y el etiquetado de productos, así que un cambio en el catálogo se ve allí. Un producto que suministra un feed programado se sobrescribe en la siguiente carga del feed: para un cambio duradero, corrige el origen del feed o usa un feed complementario.

Desactivadas al instalar: meta_catalog_batch_update_items, meta_catalog_create_product, meta_catalog_update_product y meta_catalog_delete_product. Cambian lo que los clientes ven en anuncios y tiendas, y un producto borrado no se puede recuperar, solo volver a añadir. Un administrador puede activarlas una a una si la IA debe editar el catálogo.

Pregunta antes de cada cambio: una vez activadas, la IA indica el catálogo, los productos (nombre y SKU) y los valores antiguos y nuevos, y espera tu sí. Un lote admite hasta 5.000 cambios (se recomiendan menos de 3.000) y se procesa en segundo plano: la IA lo sigue con meta_catalog_check_batch_status hasta que termina y te informa de los errores.

Límites: Meta limita las llamadas a la API. Los códigos de error 4, 17, 613, 80009 y 80014 (el límite de lotes) significan esperar unos minutos antes de volver a intentarlo.

Errores comunes: el código 190 indica que el token no es válido o ha caducado; crea uno nuevo. Con el subcódigo 467, 460 o 458 (sesión cerrada, contraseña cambiada, app eliminada) la sesión ha terminado para siempre, y el conector deja de enviar el token hasta que guardes uno nuevo. Los códigos 10 y de 200 a 299 indican que falta un permiso o que el usuario del sistema no tiene acceso a ese catálogo: asigna el catálogo y vuelve a generar el token. El código 100 indica que un parámetro, campo o filtro es incorrecto.

El conector no crea ni borra catálogos, feeds ni conjuntos de productos, no cambia la programación de los feeds ni sube archivos de feed, no gestiona catálogos localizados, píxeles ni orígenes de eventos, no lleva los anuncios de catálogo (de eso se encarga el conector de Meta Ads) y no etiqueta productos en publicaciones de Instagram.

Paso 2 — Instalar el adapter

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ñadir 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 Meta Catalog.
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

Ejemplos de prompts

• "¿Por qué se rechazan o no se muestran productos de nuestro catálogo principal? Dame los problemas MUST_FIX y cuántos artículos afecta cada uno."
• "¿Funcionó la última carga de nuestro feed de productos? Enséñame los errores con número de fila y SKU."
• "¿Qué productos del conjunto Rebajas de verano están agotados ahora mismo?"
• "Pon el SKU CAMISETA-ROJA-M a 24,90 EUR y en stock. Enséñame los valores antiguos y nuevos antes de cambiar nada."
• "Lista los catálogos que nuestros clientes han compartido con nosotros y cuántos productos tiene cada uno."

FAQ

¿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
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse