Cómo conectar Meta Catalog a Cursor 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 + Cursor

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Meta Catalog.

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

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

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