Buscar en docs...

⌘K

SDK & Recursos

Servidor MCP

Conecta Codex, Claude o ChatGPT a Zoosial y dile en español qué hacer con tus anuncios de Meta, publicaciones, mensajes y leads. No instalas nada: es una URL. Trae una herramienta por cada cosa que hace la API, más un prompt de auditoría de anuncios, incluidos en todos los planes, también el gratis (una página; una cuenta gratis por persona).

Conéctalo en 2 minutos

1. Conecta tus cuentas de Meta en el dashboard, una sola vez. El MCP opera cuentas ya conectadas; conectar una necesita que tú autorices en Meta con el navegador.

2. Agrega el MCP a tu cliente (abajo).

3. Autoriza. Se abre Zoosial en tu navegador: inicias sesión, eliges qué perfiles ve el agente y si puede actuar (cambiar anuncios, publicar) o solo leer. Eso crea una API key llamada MCP · <cliente> que revocas cuando quieras en API Keys. No copias ninguna key.

4. Pruébalo: "Lista mis cuentas publicitarias de Meta".

Codex

codex mcp add zoosial --url https://zoosial.com/mcp
codex mcp login zoosial

Claude Code

claude mcp add --transport http zoosial https://zoosial.com/mcp
# dentro de Claude Code:  /mcp  →  zoosial  →  Authenticate

Claude (web y Desktop) · ChatGPT — conector personalizado

URL del conector:  https://zoosial.com/mcp

¿Otro cliente (Cursor, Antigravity, VS Code…)? Agrégalo como servidor MCP remoto por HTTP con esa misma URL; si pide OAuth, autoriza igual. ¿Un script o CI sin navegador? Mira Avanzado.

Qué pedirle a tus anuncios

Habla normal; el agente elige las herramientas. Algunos encargos que funcionan:

"Muéstrame mis campañas con su costo por lead de los últimos 7 días y dime cuál es la peor."

"Pausa los anuncios que gastaron más de $500 sin traer un solo lead."

"Duplica la campaña 'Preventa' para probar otro público (mujeres 25-40 en Mérida). Que quede en pausa."

"Sube este video (https://…/video.mp4) y crea un anuncio con él en el conjunto 'Lanzamiento'."

"Convierte mi última publicación de la página en un anuncio con $200 diarios por 5 días."

"Quítale a este anuncio las mejoras de IA de Meta y cambia el precio del texto de $469,000 a $468,000."

"Usa el prompt auditoria_anuncios sobre mi cuenta publicitaria." — una auditoría completa: producto, segmentación, desgloses, calidad de leads y públicos.

Reglas que el agente ya respeta

Crear no gasta. Campañas, conjuntos, anuncios y copias nacen siempre en PAUSED y devuelven un reviewUrl: un link al dashboard, con lo creado resaltado, para revisarlo y activarlo con un clic.

Lo que gasta o destruye pide tu confirmación. Activar, subir presupuesto, quitar la IA de Meta y borrar están marcadas como confirma en la lista de abajo: tu cliente te pregunta antes. Borrar es irreversible; el agente prefiere pausar o archivar.

Los montos van en centavos de la moneda de la cuenta: 50000 son $500.

Solo ve lo que le diste. El agente solo alcanza los perfiles que elegiste al autorizar. Con permiso de solo lectura, no publica, no envía y no cambia nada.

Lo que Zoosial agrega a Meta

No es solo un envoltorio de la API de Meta: incluye lo que Meta sola no deja hacer desde un agente.

Subir tus videos e imágenes. upload_media acepta una URL pública (Zoosial la descarga), base64 para imágenes chicas, o te da un enlace firmado de 30 minutos para subir un archivo local desde la terminal: curl -X POST "<uploadUrl>?filename=video.mp4" -H "Content-Type: video/mp4" --data-binary @video.mp4. El nombre debe llevar la extensión real: sin .mp4 Meta lo toma como foto.

Quitar la IA de Meta de un anuncio que ya corre. remove_meta_ai apaga todas las mejoras de Advantage+ creative (plantillas, retoques, recortes, textos reescritos, voz traducida) y, si se lo pides, corrige textos en todas las variantes. Reinicia el aprendizaje del anuncio, así que el agente te lo confirma antes.

Errores que se entienden. Cuando Meta rechaza algo, llega su motivo real, no solo "Invalid parameter". Si la cuenta publicitaria topa el límite de llamadas, el error dice cuántos minutos esperar.

Varios clientes en una conexión. Al autorizar eliges varios perfiles: una agencia conecta una vez y opera todas sus cuentas.

Automatízalo: revisión semanal

Codex (Automations) y Claude Code (rutinas) pueden correr una tarea con este MCP cada semana:

1. Conéctalo con una autorización de solo lectura. Una tarea que corre sola no tiene a nadie que apruebe cambios; con solo lectura nunca se queda esperando ni toca tu dinero.

2. Programa la tarea con un encargo así: "Usa el prompt auditoria_anuncios de Zoosial sobre mi cuenta publicitaria de los últimos 7 días. Compara contra la semana anterior y dame: qué subió o bajó de costo por lead y por qué, anuncios con mejoras de IA de Meta encendidas, textos con fechas o precios vencidos, presupuestos que se acaban antes de su fecha y 3 propuestas concretas."

3. Los cambios que proponga los aplicas tú en una conversación normal, con la conexión que sí puede escribir.

Sin agente, el dashboard también trae una revisión de la semana en Anuncios.

Todas las herramientas

lee: solo consulta, tu cliente puede auto-aprobarla. escribe: crea, envía o publica algo (las de IA gastan créditos de tu plan; create_post publica de verdad). confirma: puede gastar dinero o borrar; tu cliente te pide confirmación.

Anuncios de Meta — leer

list_ad_accountsLista las cuentas publicitarias de Meta conectadas de tu cuentalee

list_ad_campaignsLista las campañas de una cuenta publicitaria de Metalee

list_ad_setsLista los conjuntos de anuncios (ad sets) de una cuenta publicitarialee

list_adsLista los anuncios de una cuenta publicitarialee

ad_insightsMétricas (insights) de una campaña/adset/ad/cuenta de Meta Adslee

list_ad_audiencesLista las audiencias personalizadas (custom audiences) de una cuenta publicitarialee

list_ad_pixelsLista los píxeles de Meta de una cuenta publicitaria (para públicos de sitio web y conversiones)lee

search_ad_locationsBusca países, estados, ciudades o códigos postales para segmentarlee

Anuncios de Meta — crear (lo que se crea nace en PAUSED)

create_ad_campaignCrea una campaña de Meta Adsescribe

create_ad_setCrea un conjunto de anuncios dentro de una campañaescribe

create_ad_creativeCrea el arte del anuncio, con un post existente o con material nuevoescribe

create_adCrea un anuncio dentro de un conjunto, con un creativo ya existente (ver create_ad_creative)escribe

boost_postConvierte una publicación de la página en anuncio (campaña, conjunto y anuncio)escribe

create_dark_postCrea una publicación que no aparece en el muro de la página, para usarla como anuncioescribe

create_ad_audienceCrea un público en la cuenta publicitaria. `audience` va tal cual a Meta (POST /act_…/customaudiences)escribe

duplicate_ad_objectDuplica una campaña, conjunto o anuncio de Metaescribe

upload_mediaSube una imagen o video y devuelve su URL públicaescribe

Anuncios de Meta — cambiar (piden confirmación)

update_ad_objectCambia una campaña, conjunto o anuncio de Metaconfirma

remove_meta_aiApaga las mejoras de IA de Meta (Advantage+) de un anuncio que ya corre y corrige textosconfirma

delete_ad_objectBorra una campaña, conjunto o anuncio de Metaconfirma

Formularios y leads

lead_formsFormularios de captación (Lead Ads) de una cuenta de Facebooklee

lead_form_detailPreguntas, intro y página de gracias de un formulario de leadslee

create_lead_formCrea un formulario de leads en una Página de Facebookescribe

leadsLeads de un formulario, paginados por cursorlee

lead_statesEstado del pipeline de los leads de una cuentalee

set_lead_stateMueve un lead en el pipeline (estado, valor estimado, nota)escribe

Perfiles y cuentas

whoamiQuién eres con esta conexiónlee

list_profilesLista los profiles (marcas/proyectos) de tu cuenta, con los límites de su planlee

create_profileCrea un profileescribe

set_ai_contextGuarda el contexto de negocio del profile (máx. 2000 chars)escribe

list_accountsLista las cuentas conectadas de tu cuenta (sin tokens)lee

accounts_healthEstado de salud de las cuentas (connected / needs_reconnection)lee

Publicar

list_postsHistorial de publicaciones de tu cuentalee

create_postPublica ya o programa un post en una o varias cuentas conectadasescribe

delete_postCancela una publicación programada (o borra un intento fallido)confirma

account_historyPublicaciones ya hechas en una cuenta de Facebook/Instagram (lo que hay en la plataforma, no el historial de Zoosial)lee

IA generativa

ai_modelsCatálogo de modelos de IA disponibles (imagen/video/audio) con su costo en créditoslee

generate_copyEscribe caption + hashtags mirando un mediaescribe

generate_imageCrea una tarea de generación de imagenescribe

generate_videoCrea una tarea de generación de videoescribe

generate_audioTexto a vozescribe

check_generationEstado de una tarea de imagen/video/audiolee

Mensajes y comentarios

send_whatsappEnvía un WhatsApp desde una cuenta whatsapp conectadaescribe

list_conversationsConversaciones (DMs) de una cuenta de Facebook/Instagramlee

send_dmResponde un DM de Facebook/Instagramescribe

list_commentsComentarios de un post/media de Facebook o Instagramlee

reply_commentPublica un comentario o respuesta en un post/mediaescribe

hide_commentOculta o vuelve a mostrar un comentario (solo Facebook)escribe

Automatizaciones

list_automationsLista las automatizaciones comment-to-DMlee

create_automationCrea una automatización comment-to-DM (keyword → DM privado)escribe

delete_automationBorra una automatizaciónconfirma

Analíticas y uso

analytics_summaryResumen de analíticas de una cuenta, normalizado para decisiones de IAlee

followers_historyHistórico diario de seguidores de una cuentalee

post_insightsMétricas de un post/media concretolee

get_usageUso del periodo de tu cuenta (cuentas conectadas + contadores)lee

Webhooks

list_webhooksLista los webhooks de salida de tu cuentalee

create_webhookRegistra un webhook de salida (recibe eventos firmados)escribe

test_webhookEncola una entrega de prueba (webhook.test) para comprobar que el receptor respondeescribe

webhook_deliveriesHistorial de entregas de un webhook (éxitos, fallos, reintentos)lee

Si algo falla

"Falta la API key" o 401. La autorización no se completó o se revocó. Vuelve a autorizar: codex mcp login zoosial, o /mcp en Claude Code.

Puede leer pero no cambiar nada. Autorizaste con solo lectura. Revoca esa conexión en API Keys y autoriza de nuevo eligiendo "actuar".

Una cuenta no responde. Pídele accounts_health: si sale needs_reconnection, reconéctala en el dashboard (Meta pidió iniciar sesión otra vez).

No puede responder un DM. Meta solo deja responder dentro de su ventana de mensajería (24 h desde el último mensaje del cliente). Si ya cerró, Zoosial devuelve 422. No es un fallo del MCP.

Un video sale como foto. Le falta la extensión al nombre del archivo en upload_media (video.mp4, no video).

Un formulario de leads quedó mal. Meta no deja editarlos después de crearlos: hay que crear otro. Por eso el agente te enseña el texto antes.

No conecta una cuenta nueva. Es a propósito: conectar redes se hace en el dashboard, no por MCP.

Avanzado

Con una API key fija (scripts, CI, sin navegador)

Crea una key en API Keys (un agente no puede crearse la suya) y pásala en el header. El control está en cómo la creas: permission: 'read' = solo consulta; scope: 'profiles' = solo los perfiles que elijas; expiresIn = caduca sola.

claude mcp add --transport http zoosial https://zoosial.com/mcp \
  --header "Authorization: Bearer sk_live_..."

# Codex: la key va en una variable de entorno
codex mcp add zoosial --url https://zoosial.com/mcp --bearer-token-env-var ZOOSIAL_API_KEY

Comprobar que responde (curl)

Debe contestar serverInfo.name: "zoosial".

curl -X POST https://zoosial.com/mcp \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'

Detalles del transporte (si tu cliente es quisquilloso)

Streamable HTTP stateless: no usamos Mcp-Session-Id y no hay SSE (GET /mcp responde 405 a propósito). Cada mensaje JSON-RPC va en su propio POST y vuelve como application/json; una notificación responde 202 sin cuerpo. Si mandas MCP-Protocol-Version, tiene que ser 2025-06-18, 2025-03-26 o 2024-11-05.

Correrlo local (stdio)

Para apuntar a una instancia propia. Necesita Node 18+ y el archivo mcp/socialgate-mcp.mjs del repo; son las mismas herramientas.

{
  "mcpServers": {
    "zoosial": {
      "command": "node",
      "args": ["/ruta/absoluta/mcp/socialgate-mcp.mjs"],
      "env": { "ZOOSIAL_API_KEY": "sk_live_..." }
    }
  }
}

¿Eres un agente? Lee /llms.txt: el manual completo, siempre al día con la API. ¿Prefieres HTTP plano? Todo lo que hace el MCP está en la API REST.

En esta página

Conéctalo en 2 minutos Qué pedirle a tus anuncios Reglas que el agente ya respeta Lo que Zoosial agrega a Meta Automatízalo: revisión semanal Todas las herramientas Si algo falla Avanzado

¿Tienes dudas?

Nuestro equipo responde en menos de 2h

Contactar soporte