PostSider
La plataforma definitiva de programación para redes sociales
Servidor MCP alojado
npx add-mcp 'https://mcp.postsider.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Conecta agentes de IA a PostSider mediante las herramientas del servidor MCP
El servidor MCP de PostSider expone 19 herramientas para agentes de IA. Se distribuye como el paquete npm @postsider/mcp y se ejecuta localmente a través de stdio; no hay una página de panel.
PostSider incluye un servidor MCP, @postsider/mcp, que expone 19 herramientas a través de la API REST pública. Implementa el Protocolo de Contexto de Modelo y se ejecuta localmente a través de stdio. Funciona con PostSider Cloud o cualquier instancia autoalojada.
Nota
El servidor MCP es un servidor stdio local que tu cliente MCP inicia. Se distribuye como el paquete npm
@postsider/mcp, no es una página de panel y no está alojado por PostSider Cloud. Tu clave de API permanece en la configuración de tu propio cliente MCP y se envía únicamente a tu instancia de PostSider. El servidor requiere Node.js 20.17 o superior.
Antes de comenzar
En el panel de PostSider, ve a **Configuración → API** y crea una clave de API de organización. Cópiala ahora; solo se muestra una vez. Consulta [Autenticación](/agent/authentication) para más detalles. Conecta Claude Code, Claude Desktop, Cursor, Codex o cualquier cliente compatible con MCP usando los comandos a continuación. `npx` descarga el paquete publicado en la primera ejecución, por lo que no hay nada que clonar ni compilar.Conectar Claude Code
Usa claude mcp add con npx y pasa tu clave como variable de entorno:
claude mcp add postsider -e POSTSIDER_API_KEY=your-api-key -- npx -y @postsider/mcp
Reinicia Claude Code para que aplique el cambio y luego pídele que "liste mis canales de PostSider" para confirmar la conexión.
Consejo
Claude Code también puede instalar el servidor como un plugin, que incluye un flujo de trabajo de lectura-primero y borrador-primero:
claude plugin marketplace add lumizone/postsider claude plugin install postsider@postsiderPasa la clave en el momento de la instalación con
--config api_key=your-api-key, o configúrala más tarde con/plugin configure postsider@postsider.
Conectar Codex
Codex — la CLI, la aplicación de escritorio de ChatGPT y la extensión del IDE — comparten una única configuración de MCP. Registra PostSider con codex mcp add y pasa tu clave como variable de entorno:
codex mcp add postsider --env POSTSIDER_API_KEY=your-api-key -- npx -y @postsider/mcp
Luego inicia una nueva sesión de Codex y pídele que "liste mis canales de PostSider". Ejecuta codex mcp list para confirmar que el servidor está registrado, o /mcp dentro de la TUI de Codex. En la aplicación de escritorio de ChatGPT y en la extensión del IDE, abre Configuración → Servidores MCP → Agregar servidor, elige STDIO y proporciona npx -y @postsider/mcp con la misma variable de entorno.
Conectar Claude Desktop, Cursor y otros clientes
La mayoría de los clientes MCP usan la misma estructura JSON. Agrega PostSider bajo la clave mcpServers de tu cliente, ejecutando el servidor con npx:
{
"mcpServers": {
"postsider": {
"command": "npx",
"args": ["-y", "@postsider/mcp"],
"env": {
"POSTSIDER_API_KEY": "your-api-key"
}
}
}
}
Configuración
El servidor se configura completamente mediante variables de entorno.
| Variable | Obligatoria | Predeterminada | Descripción |
|---|---|---|---|
POSTSIDER_API_KEY | Sí | (ninguna) | Clave de API de organización desde Configuración → API |
POSTSIDER_API_URL | No | https://api.postsider.com | URL base de tu instancia de PostSider |
Nota
En PostSider Cloud la predeterminada es correcta. En una instancia autoalojada, la API pública se sirve bajo
/apidetrás del nginx incluido, así que establecePOSTSIDER_API_URLa tu dominio más/api, por ejemplohttps://social.example.com/api. El servidor agrega/public/v1a lo que establezcas. HTTP simple solo se acepta en loopback (localhost,127.0.0.1,[::1]).
Herramientas disponibles
PostSider expone 19 herramientas. Consulta la Referencia de herramientas para ver los parámetros completos y ejemplos.
| Herramienta | Descripción |
|---|---|
postsider_list_channels | Lista los canales conectados con ids, nombres y plataformas |
postsider_get_agency_overview | Obtiene conteos operativos a nivel de organización y errores recientes |
postsider_get_customer_report | Obtiene un informe de agencia con alcance de cliente |
postsider_list_groups | Lista los grupos de canales |
postsider_find_slot | Devuelve el siguiente espacio de cola libre para un canal (UTC) |
postsider_list_posts | Lista las publicaciones dentro de un rango de fechas |
postsider_get_post_missing_fields | Validación por canal para una publicación antes de publicarla |
postsider_get_post | Obtiene una publicación por id |
postsider_get_post_analytics | Analíticas para una sola publicación |
postsider_get_channel_analytics | Analíticas a nivel de cuenta para un canal |
postsider_get_notifications | Notificaciones recientes, como fallos de publicación |
postsider_get_publishing_state | Indica si la publicación está activa o en pausa para la organización |
postsider_upload_media_from_url | Importa una imagen o video a la biblioteca de medios |
postsider_create_post | Crea, programa o publica una publicación en varios canales |
postsider_update_post_status | Cambia el estado de una publicación |
postsider_delete_post | Elimina una publicación y todas sus versiones en otros canales |
postsider_request_approval | Solicita aprobación para una publicación |
postsider_get_approval_status | Lee el estado de aprobación de una publicación |
postsider_pause_publishing | Detención de emergencia para la organización: las publicaciones en cola se retienen y las nuevas se rechazan. La reanudación es solo para humanos |
Consejo
Comienza cada flujo de trabajo con
postsider_list_channels. Los ids de canal que devuelve son necesarios para las herramientas de programación, analíticas y publicación.
Desde el código fuente (opcional)
Para compilar el servidor desde el repositorio en lugar de usar el paquete publicado, clónalo y compila apps/mcp:
git clone https://github.com/lumizone/postsider.git
cd postsider
pnpm install
pnpm --filter @postsider/mcp build
Luego apunta tu cliente a apps/mcp/dist/index.js con node:
{
"mcpServers": {
"postsider": {
"command": "node",
"args": ["/absolute/path/to/apps/mcp/dist/index.js"],
"env": {
"POSTSIDER_API_KEY": "your-api-key"
}
}
}
}
Esta documentación está compilada y alojada en Mintlify, una plataforma de documentación para desarrolladores.