Servidor MCP

Conecta Zoosial a Claude (Desktop, Code) o a cualquier cliente que hable Model Context Protocol y opera tus redes conversando, sin escribir peticiones HTTP. Son 46 herramientas envolviendo esta misma API.

Conectar

No hay nada que instalar ni que clonar: el servidor vive en zoosial.com y te conectas con una URL. Crea antes una API key en API Keys — un agente no puede crearse la suya.

Claude Code

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

Cualquier cliente MCP con soporte HTTP

URL:     https://zoosial.com/mcp
Método:  Streamable HTTP (POST)
Header:  Authorization: Bearer sk_live_...

Detalles del transporte, por si tu cliente es quisquilloso: es stateless (no usamos Mcp-Session-Id) y sin 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.

Alternativa local (stdio)

Si prefieres correrlo en tu máquina —por ejemplo apuntando a una instancia propia— el mismo servidor funciona como proceso local. Necesita Node 18 o superior y el archivo mcp/socialgate-mcp.mjs del repo. Son exactamente las mismas herramientas.

Claude Desktop — claude_desktop_config.json

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

Qué puede hacer

Estructura

list_profiles · create_profile · set_ai_context · list_accounts · accounts_health

Publicar

list_posts · create_post · delete_post · account_history

Ads

list_ad_accounts · list_ad_campaigns · create_ad_campaign · list_ad_sets · create_ad_set · create_ad_creative · list_ads · create_ad · ad_insights · list_ad_audiences — crear siempre deja el objeto en PAUSED y devuelve reviewUrl para activarlo desde el dashboard

ai_models · generate_copy · generate_image · generate_video · generate_audio · check_generation

Mensajería

send_whatsapp · list_conversations · send_dm · list_comments · reply_comment · hide_comment

Automatización

list_automations · create_automation · delete_automation

Analytics

analytics_summary · followers_history · post_insights · get_usage

Leads

lead_forms · leads · lead_states · set_lead_state

Webhooks

list_webhooks · create_webhook · test_webhook · webhook_deliveries

Fuera a propósito: conectar cuentas (/connect/*) necesita un navegador y una persona autorizando en Meta — se hace desde el dashboard, o por REST si montas tu propia app. Y de anuncios solo queda fuera activar/editar/borrar (PATCH/DELETE /ads/object): eso sí gasta o mueve presupuesto real, y merece una pantalla con un humano delante.

Acotar qué puede hacer el agente

El MCP hereda los permisos de la key, así que el control está en cómo la creas — no hace falta configurar nada en el servidor:

Key con permission: 'read' → el agente puede consultar y analizar, pero no publica, no envía ni borra nada.

Key con scope: 'profiles' → el agente solo ve los perfiles que elijas, aunque tengas más.

Key con expiresIn → caduca sola. Útil para dejar a un agente trabajar unos días y olvidarte.

Además, cada herramienta viene anotada como lectura, escritura o destructiva, así que tu cliente MCP puede auto-aprobar las consultas y pedirte confirmación solo para lo que cambia algo.

Comprobar que responde

Si tu cliente no lo lista, pruébalo con curl: debe contestar serverInfo.name: "zoosial".

bash

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"}}'

¿Prefieres HTTP plano? Todo lo que hace el MCP está disponible en la API REST, y el manual completo para agentes está en /llms.txt.

En esta página

Conectar Alternativa local (stdio) Qué puede hacer Acotar qué puede hacer el agente Comprobar que responde

¿Tienes dudas?

Nuestro equipo responde en menos de 2h

Contactar soporte