Conectar un agente
Apunta un cliente agente a tu cuenta de SocialFaktory y deja que lleve una marca de principio a fin, sin abrir la aplicación.
Qué es
Un único punto de entrada con el que habla tu cliente agente. Puede leer tus marcas y canales, generar vídeo y texto, subir archivos, programar y enviar publicaciones, y luego leer sus resultados.
No puede conectar una red social ni cambiar tu plan. Lo que puede gastar lo acotan sus permisos, el límite mensual de créditos de su token y las claves de idempotencia, que impiden que un reintento cobre dos veces. Conectar un canal pasa por un inicio de sesión en el navegador, así que se queda en la aplicación.
Mira lo que un agente puede llevar para una marcaConsigue un token
Crea un token de acceso personal en tus ajustes. El secreto se muestra una sola vez y solo sirve en este punto de entrada.
- Los permisos deciden qué puede hacer el token — lectura por sí sola, más generación para todo lo que gasta créditos, más publicación para publicar.
- Fíjalo a una marca y solo verá los canales, generaciones, publicaciones y textos de esa marca. La cartera de créditos, los archivos subidos, los actores y los productos se comparten en toda la cuenta.
- Pon un límite mensual de créditos y el token no inicia ninguna llamada de pago cuando el gasto del mes lo alcanza. Una escritura de texto ya en curso se liquida a su coste real, que puede quedar algo por encima.
Punto de entrada
POST https://www.socialfaktory.com/mcp
Streamable HTTP, versión de protocolo 2025-06-18, autenticación bearer en la cabecera Authorization. No hay identificador de sesión que llevar: el token es la sesión. Un GET responde 405.
Claude Code
claude mcp add -s user --transport http socialfaktory https://www.socialfaktory.com/mcp \--header "Authorization: Bearer sfp_…"
Codex
export SOCIALFAKTORY_TOKEN=sfp_…codex mcp add socialfaktory --url https://www.socialfaktory.com/mcp --bearer-token-env-var SOCIALFAKTORY_TOKEN
Claude Desktop
Claude Desktop arranca servidores locales desde su archivo de configuración, así que esta entrada ejecuta mcp-remote con npx como puente hacia el punto de entrada, y necesitas Node.js instalado. claude.ai y Cowork solo llegan a él si un administrador de la organización lo añade como conector con el token como cabecera de la petición, una función beta de Anthropic que comparte el token con toda la organización.
{"mcpServers": {"socialfaktory": {"command": "npx","args": ["-y", "mcp-remote", "https://www.socialfaktory.com/mcp", "--header", "Authorization:${SOCIALFAKTORY_AUTH}"],"env": { "SOCIALFAKTORY_AUTH": "Bearer sfp_…" }}}}
Cualquier cliente Streamable HTTP
Envía JSON-RPC 2.0 por POST. Acepta tanto JSON como el tipo event-stream, e indica la versión del protocolo en cada petición.
POST https://www.socialfaktory.com/mcpAuthorization: Bearer sfp_…Content-Type: application/jsonAccept: application/json, text/event-streamMCP-Protocol-Version: 2025-06-18{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }
Herramientas
Cada herramienta indica el permiso que necesita. Un token sin ese permiso se rechaza antes de que la herramienta se ejecute. quote_generation es una comprobación de precio opcional para un vídeo, y generate_text reserva unos pocos créditos por adelantado y liquida lo que la redacción consumió de verdad.
Leer lo que ya tienes
list_brandsreadGratislist_channelsreadGratisget_channel_requirementsreadGratislist_formatsreadGratisget_walletreadGratis
Crear algo nuevo
quote_generationreadGratiscreate_generationgenerateGasta créditosgenerate_textgenerateGasta créditoscheck_referencereadGratis
Leer resultados
get_generationreadGratislist_generationsreadGratisget_text_generationreadGratislist_mediareadGratis
Traer tu propio archivo
create_uploadgenerateGratiscomplete_uploadgenerateGratisget_uploadreadGratis
Publicar
create_postspublishGratissend_postpublishGratisdelete_postpublishGratislist_postsreadGratis
Reintentar sin riesgo
Pasa este argumento en cada llamada que gaste o publique. Una repetición dentro de 24 horas devuelve el resultado original, marcado como repetido, en vez de hacer el trabajo dos veces.
idempotency_keyLímites
- 120 llamadas por minuto y token, y 300 peticiones cada 5 minutos por dirección.
- Clonar un vídeo desde un enlace, y generar imágenes fijas o carruseles, aún no están disponibles para un agente.