Cómo usar el servidor MCP de Postoria

El servidor MCP de Postoria permite que las herramientas de IA compatibles con MCP creen y administren publicaciones en Postoria a través de la API pública de Postoria.

Puedes conectarte a Postoria de dos formas:

Servidor MCP local mediante npm — se ejecuta en tu equipo y utiliza tu clave de la API pública de Postoria.
Endpoint MCP alojado por Postoria — se ejecuta en la infraestructura de Postoria en https://mcp.postoria.io/mcp y admite el inicio de sesión mediante OAuth o la autenticación con una clave de la API pública, según las funciones que admita tu cliente MCP.

El servidor MCP puede ayudar a una herramienta de IA a listar espacios de trabajo, encontrar cuentas sociales y colas, importar o subir archivos multimedia, publicar contenido, programar publicaciones, añadir publicaciones a colas, listar publicaciones existentes, consultar el estado de una publicación y eliminar publicaciones en Postoria.

La compatibilidad con MCP depende de la herramienta de IA que utilices. Entre las herramientas compatibles con MCP pueden estar Claude Desktop, Cursor, Claude Code y las aplicaciones personalizadas de ChatGPT cuando permiten conexiones MCP personalizadas.

Antes de empezar

Estos son los principales aspectos que debes conocer antes de utilizar el servidor MCP de Postoria:

El acceso al servidor MCP está disponible en los planes Pro y Agency.
El servidor MCP utiliza la API pública de Postoria internamente.
El servidor MCP local mediante npm requiere una clave de la API pública de Postoria.
El endpoint MCP alojado por Postoria puede utilizar el inicio de sesión mediante OAuth cuando el cliente MCP admite el descubrimiento de OAuth.
El endpoint MCP alojado por Postoria también puede aceptar una clave de la API pública de Postoria como token Bearer.
Las claves de la API pública pertenecen a la cuenta, no a un espacio de trabajo concreto.
El uso local permite subir archivos locales desde tu equipo cuando el cliente MCP admite el acceso a archivos.
El endpoint MCP alojado por Postoria no requiere instalar localmente el paquete npm.

También puedes consultar el artículo de ayuda sobre la API pública de Postoria para obtener información sobre la configuración de la clave y el comportamiento de la API.

Elige entre la opción local y la alojada

Elige el método de conexión compatible con tu cliente MCP.

Servidor MCP local mediante npm

Utiliza el servidor MCP local mediante npm cuando tu cliente compatible con MCP pueda ejecutar un comando local.

Esta configuración es habitual en herramientas de escritorio y entornos de desarrollo como Claude Desktop, Cursor y Claude Code.

En el modo local:

El servidor MCP se ejecuta en tu equipo mediante el paquete npm.
La clave de la API pública de Postoria se proporciona en la configuración local del cliente MCP.
La carga de archivos locales puede funcionar cuando el cliente MCP permite que el servidor acceda a una ruta de archivo local.

El paquete npm es:

@postoria/mcp-server

El comando local es:

npx -y @postoria/mcp-server

Endpoint MCP alojado por Postoria

Utiliza el endpoint MCP alojado por Postoria cuando tu cliente compatible con MCP pueda conectarse a servidores MCP alojados.

En el modo alojado:

No instalas localmente el paquete npm.
El cliente MCP se conecta a https://mcp.postoria.io/mcp.
Los clientes compatibles con OAuth pueden guiarte durante el inicio de sesión en Postoria.
Los clientes que admiten tokens Bearer pueden utilizar una clave de la API pública de Postoria.

El endpoint MCP alojado por Postoria es:

https://mcp.postoria.io/mcp

Crea una clave de la API pública

Crea una clave de la API pública para el servidor MCP local mediante npm o para los clientes MCP alojados que utilicen autenticación mediante token Bearer.

El flujo de inicio de sesión mediante OAuth del endpoint MCP alojado por Postoria no utiliza una clave de la API pública.

Para crear una clave de la API pública:

Abre Postoria.
Ve a Settings.
Busca la sección Public API.
Haz clic en Create API key.
Copia la clave y guárdala de forma segura.

Postoria muestra la clave completa una sola vez. Después de cerrar el cuadro de diálogo, solo verás el prefijo de la clave.

Si pierdes la clave, revócala y crea una nueva.

Configuración de un cliente MCP local

La configuración exacta depende de tu cliente MCP.

En los clientes que admiten una configuración del servidor MCP en formato JSON, utiliza el paquete e incluye la clave de la API de Postoria en las variables de entorno.

Ejemplo:

{
  "mcpServers": {
    "postoria": {
      "command": "npx",
      "args": ["-y", "@postoria/mcp-server"],
      "env": {
        "POSTORIA_API_KEY": "pst_live_your_postoria_api_key_here"
      }
    }
  }
}

Después de guardar la configuración, reinicia o actualiza el cliente MCP y pídele que utilice Postoria.

Endpoint MCP alojado por Postoria

Para las conexiones MCP alojadas, utiliza este endpoint:

https://mcp.postoria.io/mcp

El endpoint alojado admite dos métodos de autenticación. El método que utilices dependerá de tu cliente MCP.

Inicio de sesión mediante OAuth

Algunos clientes MCP admiten el descubrimiento de OAuth para servidores MCP alojados. En ese caso, añade el endpoint MCP alojado por Postoria en el cliente MCP e inicia sesión en Postoria cuando se te solicite.

https://mcp.postoria.io/mcp

Clave de la API pública como token Bearer

Algunos clientes MCP admiten tokens Bearer personalizados. En ese caso, utiliza tu clave de la API pública de Postoria como token Bearer.

Authorization: Bearer pst_live_your_postoria_api_key_here

Si el cliente solicita por separado el valor del token y el esquema del encabezado, introduce únicamente la clave de la API como valor del token y elige Bearer como esquema.

No pegues la palabra Bearer en el campo del token, salvo que el cliente MCP solicite explícitamente el valor completo del encabezado.

Después de conectarte, pide al cliente que examine o cargue las herramientas disponibles.

Herramientas disponibles

El servidor MCP de Postoria proporciona herramientas para los flujos de publicación más habituales.

Herramientas de espacios de trabajo y cuentas

list_workspaces — lista los espacios de trabajo de Postoria disponibles.
list_social_accounts — lista las cuentas sociales de un espacio de trabajo.
list_queues — lista las colas de un espacio de trabajo.

Estas herramientas ayudan al cliente de IA a encontrar los identificadores del espacio de trabajo, de las cuentas sociales y de las colas que necesita antes de crear una publicación.

Herramientas de contenido multimedia

import_media_from_url — importa contenido multimedia desde una URL pública.
create_media_upload — crea una URL firmada para subir contenido multimedia.
complete_media_upload — completa una carga multimedia después de que se hayan enviado los bytes sin procesar del archivo.
upload_media_from_file — sube un archivo local desde el equipo en el que se ejecuta el servidor MCP local.
get_media — consulta el estado y los detalles de un elemento multimedia.

Herramientas de publicaciones

publish_post_now — publica contenido inmediatamente.
schedule_post — programa una publicación para una fecha y hora concretas.
add_post_to_queue — añade una publicación a una cola.
list_posts — lista las publicaciones de un espacio de trabajo con filtros y paginación opcionales.
get_post — consulta el estado y los detalles de una publicación.
delete_post — elimina una publicación de Postoria. Esto no elimina de las redes sociales el contenido que ya se haya publicado.

Opciones para el contenido multimedia

El flujo multimedia adecuado depende de dónde se encuentre el archivo y de las funciones que admita tu cliente MCP.

Importar contenido multimedia desde una URL pública

Utiliza esta opción cuando la imagen o el vídeo ya estén disponibles mediante una URL pública.

Resulta útil para archivos guardados en un sitio web, un CMS, una biblioteca de recursos u otra fuente pública.

El cliente de IA puede llamar a import_media_from_url y después a get_media para comprobar si el procesamiento ha finalizado.

Subir contenido multimedia mediante una URL de carga firmada

Utiliza esta opción cuando el cliente pueda enviar los bytes sin procesar del archivo a una URL de carga firmada.

El flujo es el siguiente:

Llama a create_media_upload.
Sube los bytes sin procesar del archivo a la URL de carga devuelta mediante PUT.
Llama a complete_media_upload.
Llama a get_media para consultar el estado del contenido multimedia.

Llama a complete_media_upload únicamente después de haber subido realmente los bytes sin procesar del archivo.

Subir un archivo local

Utiliza esta opción en flujos MCP locales de escritorio cuando quieras subir un archivo mediante su ruta local.

El cliente de IA puede llamar a upload_media_from_file con una ruta de archivo local. El servidor MCP local sube el archivo a Postoria, completa la carga y devuelve el estado del contenido multimedia.

Ejemplos de flujos de trabajo

Las solicitudes de ejemplo deben parecer peticiones de publicación normales, no instrucciones de la API. El cliente MCP puede decidir qué herramientas de Postoria debe invocar internamente.

Encontrar espacios de trabajo

Pregunta a tu cliente MCP:

Muéstrame los espacios de trabajo de Postoria a los que tengo acceso.

El cliente debería listar los espacios de trabajo disponibles para que puedas elegir dónde trabajar.

Encontrar cuentas sociales

Pregunta a tu cliente MCP:

Muéstrame las cuentas sociales conectadas al espacio de trabajo ACME Studio.

El cliente debería encontrar primero el espacio de trabajo correspondiente y, después, listar las cuentas sociales conectadas para que puedas elegir dónde publicar.

Publicar contenido de texto

Pregunta a tu cliente MCP:

Publica esto en la página de LinkedIn de ACME Studio: Acabamos de publicar una guía de planificación de lanzamientos para equipos pequeños. Explica cómo mantener organizados los recursos de campaña, las aprobaciones y las publicaciones programadas antes del día del lanzamiento.

Revisa el espacio de trabajo, la cuenta y el texto seleccionados antes de confirmar la acción.

Programar una publicación

Pregunta a tu cliente MCP:

Programa una publicación de Instagram para ACME Studio mañana a las 10:00 con la imagen que he adjuntado. Texto: Una sencilla lista de comprobación para lanzamientos puede ahorrar horas cuando tu equipo prepara contenido para varios canales.

El cliente debería preparar la publicación programada y mostrarte la cuenta, el contenido multimedia y la hora seleccionados antes de que confirmes la publicación.

Añadir una publicación a una cola

Pregunta a tu cliente MCP:

Añade esta publicación con imagen a la cola Weekly Tips de ACME Studio utilizando la imagen que he adjuntado. Texto: Conserva una única lista de comprobación reutilizable para cada campaña, de modo que tu equipo sepa qué está aprobado, programado y listo para publicar.

El cliente debería encontrar la cola, preparar la publicación con el contenido multimedia seleccionado y añadirla a la cola de publicación elegida.

Listar publicaciones existentes

Pregunta a tu cliente MCP:

Muéstrame las publicaciones de Instagram programadas en el espacio de trabajo ACME Studio.

El cliente puede utilizar list_posts con filtros como identificadores de cuentas, identificador de cola, estado de publicación, redes sociales, intervalo de fechas, límite de resultados y cursor de paginación.

Seguridad y confirmación

Los clientes de IA pueden ayudarte a preparar acciones de publicación, pero debes revisar los detalles importantes antes de publicar o programar.

Antes de confirmar una acción, comprueba:

El espacio de trabajo
Las cuentas sociales
Las colas, cuando corresponda
El texto de la publicación
El contenido multimedia
La fecha y hora programadas y la zona horaria del espacio de trabajo
Si la acción publica inmediatamente o programa el contenido para más adelante

delete_post elimina la publicación correspondiente de Postoria. No elimina el contenido que ya se haya publicado en las redes sociales. Utilízala únicamente cuando tengas la certeza de que la publicación debe eliminarse de Postoria.

Código fuente y paquete

El servidor MCP de Postoria es de código abierto en GitHub:

https://github.com/postoria-app/postoria-mcp-server

El paquete npm está disponible aquí:

https://www.npmjs.com/package/@postoria/mcp-server

Cómo usar el servidor MCP de Postoria

Antes de empezar

Elige entre la opción local y la alojada

Servidor MCP local mediante npm

Endpoint MCP alojado por Postoria

Crea una clave de la API pública

Configuración de un cliente MCP local

Endpoint MCP alojado por Postoria

Inicio de sesión mediante OAuth

Clave de la API pública como token Bearer

Herramientas disponibles

Herramientas de espacios de trabajo y cuentas

Herramientas de contenido multimedia

Herramientas de publicaciones

Opciones para el contenido multimedia

Importar contenido multimedia desde una URL pública

Subir contenido multimedia mediante una URL de carga firmada

Subir un archivo local

Ejemplos de flujos de trabajo

Encontrar espacios de trabajo

Encontrar cuentas sociales

Publicar contenido de texto

Programar una publicación

Añadir una publicación a una cola

Listar publicaciones existentes

Seguridad y confirmación

Código fuente y paquete

Empresa

Producto

Ayuda

Ayuda