Zoosial

npx add-mcp 'https://zoosial.com/mcp'

Inicio Servidor MCP

Volver al sitio Volver al Dashboard

Buscar en docs...

⌘K

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".

Conecta tu IA en un clic

Copia lo de tu asistente y pégalo. Se autoriza con tu cuenta de Zoosial: no hay llaves que pegar.

Claude (web y Desktop)

Agrega un conector personalizado y pega esta URL.

https://zoosial.com/mcp

ChatGPT

Agrega un conector personalizado y pega esta URL.

https://zoosial.com/mcp

Claude Code

Después, dentro de Claude Code: /mcp → zoosial → Authenticate.

claude mcp add --transport http zoosial https://zoosial.com/mcp

Codex

Después de agregarlo, inicia sesión con el segundo comando.

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

Cursor, VS Code y otros

Agrégalo como servidor MCP remoto por HTTP con la misma URL; si pide OAuth, autoriza.

https://zoosial.com/mcp

Script o CI

Para un script o CI sin navegador, usa una llave en la cabecera.

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

¿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_accounts Lista las cuentas publicitarias de Meta conectadas de tu cuentalee

list_ad_campaigns Lista las campañas de una cuenta publicitaria de Metalee

list_ad_sets Lista los conjuntos de anuncios (ad sets) de una cuenta publicitarialee

list_ads Lista los anuncios de una cuenta publicitarialee

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

list_ad_audiences Lista las audiencias personalizadas (custom audiences) de una cuenta publicitarialee

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

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

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

create_ad_campaign Crea una campaña de Meta Adsescribe

create_ad_set Crea un conjunto de anuncios dentro de una campañaescribe

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

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

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

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

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

duplicate_ad_object Duplica una campaña, conjunto o anuncio de Metaescribe

upload_media Sube una imagen o video y devuelve su URL públicaescribe

Anuncios de Meta — cambiar (piden confirmación)

update_ad_object Cambia una campaña, conjunto o anuncio de Metaconfirma

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

delete_ad_object Borra una campaña, conjunto o anuncio de Metaconfirma

Formularios y leads

lead_forms Formularios de captación (Lead Ads) de una cuenta de Facebooklee

lead_form_detail Preguntas, intro y página de gracias de un formulario de leadslee

create_lead_form Crea un formulario de leads en una Página de Facebookescribe

leads Leads de un formulario, paginados por cursorlee

lead_states Estado del pipeline de los leads de una cuentalee

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

Perfiles y cuentas

whoami Quién eres con esta conexiónlee

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

create_profile Crea un profileescribe

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

list_accounts Lista las cuentas conectadas de tu cuenta (sin tokens)lee

accounts_health Estado de salud de las cuentas (connected / needs_reconnection)lee

linked_accounts Solo superadminlee

Publicar

list_posts Historial de publicaciones de tu cuentalee

create_post Publica ya o programa un post en una o varias cuentas conectadasescribe

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

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

IA generativa

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

generate_copy Escribe caption + hashtags mirando un mediaescribe

generate_image Crea una tarea de generación de imagenescribe

generate_video Crea una tarea de generación de videoescribe

generate_audio Texto a vozescribe

check_generation Estado de una tarea de imagen/video/audiolee

Mensajes y comentarios

send_whatsapp Envía un WhatsApp desde una cuenta whatsapp conectadaescribe

list_conversations Conversaciones (DMs) de una cuenta de Facebook/Instagramlee

send_dm Responde un DM de Facebook/Instagramescribe

list_comments Comentarios de un post/media de Facebook o Instagramlee

reply_comment Publica un comentario o respuesta en un post/mediaescribe

hide_comment Oculta o vuelve a mostrar un comentario (solo Facebook)escribe

Automatizaciones

list_automations Lista las automatizaciones comment-to-DMlee

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

delete_automation Borra una automatizaciónconfirma

Analíticas y uso

analytics_summary Resumen de analíticas de una cuenta, normalizado para decisiones de IAlee

followers_history Histórico diario de seguidores de una cuentalee

account_insights Métricas de una cuenta de Facebook o Instagramlee

post_insights Métricas de un post/media concretolee

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

Investigación de mercado

research_instagram_account Espía a la competencialee

research_hashtag Posts públicos de un hashtag de Instagram (top o recent = últimas 24 h), rankeados por interacciónlee

research_tagged Posts de otras cuentas donde etiquetaron a esta cuenta de Instagramlee

research_ad_library Biblioteca de anuncios de Metalee

targeting_search Busca intereses de anuncios de Meta con el tamaño de su audiencia (audience_size_lower_bound/upper_bound)lee

audience_estimate Usuarios activos al mes que alcanza un targeting de Meta (el mismo objeto de un ad setlee

Webhooks

list_webhooks Lista los webhooks de salida de tu cuentalee

create_webhook Registra un webhook de salida (recibe eventos firmados)escribe

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

webhook_deliveries Historial 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

¿Tienes dudas?

Nuestro equipo responde en menos de 2h

Contactar soporte