Zoosial
docs
InicioServidor MCP
Volver al sitio Volver al Dashboard
Zoosial
Buscar en docs...
⌘K
SDK & Recursos

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 36 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
IA
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 los anuncios tampoco están: gastar presupuesto publicitario 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