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@postsider

Pasa 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.

VariableObligatoriaPredeterminadaDescripción
POSTSIDER_API_KEYSí(ninguna)Clave de API de organización desde Configuración → API
POSTSIDER_API_URLNohttps://api.postsider.comURL 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 /api detrás del nginx incluido, así que establece POSTSIDER_API_URL a tu dominio más /api, por ejemplo https://social.example.com/api. El servidor agrega /public/v1 a 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.

HerramientaDescripción
postsider_list_channelsLista los canales conectados con ids, nombres y plataformas
postsider_get_agency_overviewObtiene conteos operativos a nivel de organización y errores recientes
postsider_get_customer_reportObtiene un informe de agencia con alcance de cliente
postsider_list_groupsLista los grupos de canales
postsider_find_slotDevuelve el siguiente espacio de cola libre para un canal (UTC)
postsider_list_postsLista las publicaciones dentro de un rango de fechas
postsider_get_post_missing_fieldsValidación por canal para una publicación antes de publicarla
postsider_get_postObtiene una publicación por id
postsider_get_post_analyticsAnalíticas para una sola publicación
postsider_get_channel_analyticsAnalíticas a nivel de cuenta para un canal
postsider_get_notificationsNotificaciones recientes, como fallos de publicación
postsider_get_publishing_stateIndica si la publicación está activa o en pausa para la organización
postsider_upload_media_from_urlImporta una imagen o video a la biblioteca de medios
postsider_create_postCrea, programa o publica una publicación en varios canales
postsider_update_post_statusCambia el estado de una publicación
postsider_delete_postElimina una publicación y todas sus versiones en otros canales
postsider_request_approvalSolicita aprobación para una publicación
postsider_get_approval_statusLee el estado de aprobación de una publicación
postsider_pause_publishingDetenció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.