# Configura SosoAPI para la persona que usa este asistente Usa el asistente existente de la persona y conserva la tarea, el contenido y las referencias multimedia de esta conversación. Usa un solo MCP de SosoAPI para sus cuentas conectadas cuentas sociales. Reutiliza una conexión existente o elige acceso local o alojado a continuación. La configuración no publica nada. La persona inicia sesión y elige qué autorizar en su navegador. Nunca introduzcas sus credenciales ni apruebes el consentimiento por ellos. Free no requiere una tarjeta. ## 1. Conecta este asistente Comprueba primero el entorno actual y su configuración existente de SosoAPI. Reutiliza una conexión operativa; no cierres sesión, sobrescribas la configuración ni crees otra conexión solo porque esta guía se abrió de nuevo. Para un shell local, comprueba que estén disponibles Node.js 20 o posterior y npx. Usa una entorno de ejecución compatible existente. Si falta, explica el requisito con lenguaje lenguaje; no hagas automáticamente cambios privilegiados ni globales en el sistema. Claude Code: ```sh claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Codex: ```sh codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Tras registrar el servidor, comprueba que puedes llamar a sus herramientas en esta conversación. Si el entorno necesita reconexión o reinicio, indica a la persona qué acción que debe realizar. Espera a que funcionen las herramientas antes de decir que la conexión está lista. Las conexiones nuevas usan el perfil core existente de 28 herramientas para publicación cotidiana, archivos multimedia, comentarios y estadísticas. Debe reutilizarse una conexión operativa de perfil full. Si falta una operación de administración solicitada, explica que el perfil full está disponible; ocultar una herramienta no concede ni revoca permisos. Para un cliente que solo funciona en el navegador, como ChatGPT con compatibilidad para aplicaciones MCP personalizadas, añade este URL de MCP remoto y elige OAuth con registro automático de clientes: `https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp` No es necesario pegar clave API, ID de cliente ni secreto de cliente. La persona inicia sesión en SosoAPI y elige sus espacios/acciones. Las aplicaciones personalizadas de ChatGPT dependen de su plan y disponibilidad del modo de desarrollador. Reutiliza una conexión local o remota operativa conexión si ya hay una configurada. X admite textos y enlaces originales. Cada organización comparte 10 créditos de X de Free una sola vez, o 100 por período de facturación Pro. Un texto sencillo cuesta 1; una publicación que contiene una URL cuesta 10. Consulta `sosoapi_get_x_usage` con workspace_id antes de planificar el uso de X. No se cobra automáticamente un exceso; una publicación incierta mantiene su crédito reserva y debe conciliarse antes de otro envío. ## 2. Inicia sesión sin clave API La primera llamada MCP autenticada abre el inicio de sesión existente en el navegador y el flujo de flujo de consentimiento. La persona puede usar Google o registrarse y verificar su correo. Deja que elijan su espacio de trabajo y si el asistente solo puede preparar contenido o también puede programar y publicar. No les pidas copiar credenciales. El consentimiento de publicación es continuo dentro del alcance elegido, no una pantalla de aprobación por cada publicación. Mantén desactivada la gestión de claves para publicar de forma habitual. El registro y el inicio de sesión por correo usan verificación de seguridad en segundo plano, sin casilla que debe resolver la persona. Si la verificación falla, informa del error y usa la acción de reintento disponible; no pidas a la persona buscar ni pulsar una casilla CAPTCHA. La opción existente **Continue with Google** también está disponible si la persona quiere usar Google; Google puede exigir su propia comprobación de identidad. Deja que la persona elija su cuenta y apruebe el acceso. Conserva el enlace actual de inicio de sesión/aprobación y su destino de retorno; no sustituyas por una URL de registro sin más o cambies silenciosamente a una identidad de mantenedor existente. Un error de inicio de sesión no demuestra que todos los métodos de acceso estén indisponibles. Pausa solo el paso que necesita la identidad o el consentimiento de la persona. Mientras lo completa, termina las comprobaciones de instalación y prepara el borrador original sin inventar una cuenta o un espacio de trabajo. Explica qué está listo y la única acción necesaria a continuación. Tras iniciar sesión, vuelve a consultar el contexto autenticado y reanuda la misma tarea. No desactives CAPTCHA, uses API de registro de administrador ni pidas tokens, ni afirmes que la cuenta/conexión está lista antes de completar el flujo real. Si las herramientas MCP necesitan recargar el entorno, la CLI local también está disponible para este asistente. Ejecuta `npx -y sosoapi auth status` primero; usa `npx -y sosoapi auth login` solo cuando sea necesario iniciar sesión. Nunca leas el archivo de credenciales ni muestres tokens. Si el inicio de sesión abre el perfil de navegador incorrecto, detente esa sesión de inicio pendiente antes de empezar una nueva `npx -y sosoapi auth login --no-open`. La persona abre el nuevo enlace mostrado en el perfil previsto y comprueba la la identidad de la sesión antes de aprobar. Nunca hagas competir dos perfiles por el mismo enlace. Uso `--help` primero para confirmar que esta opción de recuperación existe en la CLI instalada; si no existe, explica la limitación de versión en vez de inventar una opción funcional. La CLI puede examinar sus contratos integrados: ```sh npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` La sintaxis de solicitud de CLI es `sosoapi api post < request.json`. Escribe el JSON con tu herramienta de archivos; no interpoles contenido del usuario en comandos de shell comandos. Lee http_status y el cuerpo de respuesta, no solo el código de salida código. Un error API no es éxito. Usa solo rutas y esquemas del contrato integrado; no inventes nombres ni eludas una capacidad ausente. ## 3. Conecta la cuenta social de la propia persona Obtén la organización y el espacio de trabajo autenticados desde el contexto de SosoAPI. Nunca adivines identificadores ni sustituyas silenciosamente el espacio de trabajo. Si hay más de una marca adecuada, pregunta cuál tiene en mente la persona. Usa una conexión existente si está sana. En otro caso, ejecuta `npx -y sosoapi connect ` (instagram, threads, facebook, youtube o x) o dale a la persona https://app.sosoapi.ai/connect. Completan el proceso del proveedor el consentimiento y revisa la cuenta exacta en el navegador. Cuando regrese, vuelve a consultar las cuentas y las capacidades de publicación. Un callback de conexión no es prueba de que se permite publicar. Reutiliza el borrador original; no pidas a la persona copiar un identificador interno o recrear su contenido. ## 4. Completa la tarea original de publicación Usa la solicitud existente de la persona o pregunta qué quiere promocionar. No inventes una publicación de prueba. Muestra la cuenta de destino exacta, el contenido, los archivos multimedia y la fecha/hora locales antes del primer envío. Confirma la zona horaria cuando sea desconocido. Consulta los datos actuales de capacidades de cuenta; una cuenta personal de Instagram o la ausencia de los permisos del proveedor pueden necesitar un tipo de cuenta compatible o una reconexión. X solo acepta textos y enlaces originales; deja media vacío. Los archivos multimedia, respuestas, no se admiten citas, republicaciones ni publicación de hilos. Para destinos que admiten archivos multimedia, regístralos antes de programar: para un archivo local usa sosoapi_upload_asset dentro de sus carpetas permitidas; para una URL externa usa sosoapi_import_asset_url y consulta sosoapi_get_asset_import_status con include_asset=true hasta que el importación acotada esté lista. El asset.id listo pasa a ser media.asset_id y asset.asset_url pasa a ser media.url; no se requiere una llamada get_asset adicional. Conserva la misma identidad de importación, respeta las indicaciones de reintento y detente ante un resultado definitivo fallo. Una solicitud exitosa no demuestra que la decodificación/importación haya terminado. Si el progreso se detiene, consulta sosoapi_job_status con el job_id de esa importación antes de esperar de nuevo. Una tarea pendiente ya puede tener un error de ejecución. Un error de servicio un error de configuración requiere atención del operador, no otra importación, una nueva cuenta social conexión o permiso de la persona. Informa del impedimento sin afirmar la imagen está lista. Usa juntos el ID de recurso registrado devuelto y la URL multimedia canónica. Nunca programar la URL externa original o una URL temporal de vista previa como sustituto. Reutiliza un recurso listo existente solo tras comprobar su espacio de trabajo e identidad. Usa sosoapi_get_scheduled_post_eligibility cuando resulte útil una vista previa orientativa; es opcional y no sustituye la validación canónica de creación/ejecución. Usa la publicación programada canónica herramientas. Una publicación es un destino. Reutiliza el mismo idempotency_key para los reintentos de la misma solicitud exacta; un borrador modificado es otra solicitud. Tras agotar el tiempo de espera, consulta la publicación existente antes de realizar otra acción. Nunca reenvíes a ciegas una escritura incierta en el proveedor. Las actualizaciones, cancelación y reintento explícito usan la versión actual y elegibilidad de la acción según el servidor. El resultado debe distinguir: - Programado: aceptado para la hora indicada; todavía sin publicar. - En curso o conciliándose: el resultado final no está confirmado; no reenvíes. - Publicado: un resultado definitivo respaldado por el proveedor confirma la publicación exacta; devuelve su enlace público cuando esté disponible. - Fallido o requiere atención: indica qué se sabe y la siguiente acción permitida; vuelve a conectar solo la cuenta afectada cuando la persona deba conceder acceso de nuevo. Para varios destinos, informa de cada uno por separado. No califiques toda la tarea de exitoso cuando solo algunas plataformas tuvieron éxito. Para una programación futura, devuelve los IDs y las horas aceptadas de las publicaciones; no mantengas la conversación esperando hasta la hora prevista ni crees un bucle de consultas. Al volver, consulta las mismas publicaciones de nuevo. La persona también puede volver al resultado exacto en https://app.sosoapi.ai/scheduled-posts/, usando el ID real devuelto de SosoAPI. Esa página requiere su propio inicio de sesión autorizado. Para un entorno personalizado entorno, usa en su lugar el origen de aplicación configurado explícitamente. No prometas despertar un asistente cerrado ni enviar una notificación de éxito que no se ha configurado y verificado. ## Referencias - Guía de inicio para personas: https://app.sosoapi.ai/start - Guía del producto: https://sosoapi.ai/es/docs/quickstart - Alcance admitido: Instagram, Threads, páginas de Facebook, YouTube y textos originales de X textos/enlaces. Los formatos y permisos varían por cuenta; otras plataformas no están disponibles simplemente porque la persona los solicite.