Servidor MCP de PostFast

Name: postfast-mcp
Author: peturgeorgievv-factory

Servidor MCP para la API de PostFast: programa y gestiona publicaciones en redes sociales a través de herramientas de IA como Claude, Cursor, VS Code y más.

Inicio rápido

1. Obtén tu clave de API

Inicia sesión en PostFast, ve a API en la barra lateral y genera una clave.

2. Instalación

Elige tu método preferido:

Claude Desktop (recomendado)

Descarga la extensión desde el directorio de extensiones de Claude Desktop o instálala manualmente:

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "postfast": {
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reinicia Claude Desktop.

Claude Code

Vía plugin (pendiente de aprobación en el marketplace):

/plugin install postfast@claude-plugins-official

Después de instalar, configura tu clave de API; elige una de estas opciones:

# Option A: Add to your shell profile (~/.zshrc or ~/.bashrc)
export POSTFAST_API_KEY="your-api-key-here"

# Option B: Add to ~/.claude/settings.local.json
# { "env": { "POSTFAST_API_KEY": "your-api-key-here" } }

Luego reinicia Claude Code.

Vía configuración manual:

Añade al archivo .mcp.json de tu proyecto o a ~/.claude/.mcp.json (global):

{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code / Windsurf / Otros clientes MCP

Añade a tu configuración de MCP (.mcp.json, mcp.json o la interfaz de configuración de la herramienta):

{
  "mcpServers": {
    "postfast": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "postfast-mcp"],
      "env": {
        "POSTFAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Uso

Pide a tu asistente de IA cosas como:

"List my connected social accounts"
"Schedule a post to Instagram for tomorrow at 9am"
"Show me all scheduled posts for this week"
"Upload this image and create a LinkedIn post with it"
"Create a Facebook reel with this video"
"Show me analytics for my Instagram posts this month"

Herramientas disponibles

Herramienta	Descripción
`list_accounts`	Lista las cuentas de redes sociales conectadas
`list_posts`	Lista las publicaciones con filtros (plataforma, estado, rango de fechas)
`create_posts`	Crea y programa publicaciones (por lotes, hasta 15)
`delete_post`	Elimina una publicación por ID
`upload_media`	Sube un archivo local y obtiene una clave multimedia (gestiona el flujo completo)
`get_upload_urls`	Obtiene URLs firmadas para subir archivos multimedia
`list_pinterest_boards`	Obtiene los tableros de Pinterest de una cuenta
`list_youtube_playlists`	Obtiene las listas de reproducción de YouTube de una cuenta
`generate_connect_link`	Genera un enlace para que los clientes conecten sus cuentas
`get_post_analytics`	Obtiene publicaciones publicadas con métricas de rendimiento: Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (páginas de empresa)

Plataformas compatibles

Facebook, Instagram, X (Twitter), TikTok, LinkedIn, YouTube, BlueSky, Threads, Pinterest, Telegram

Controles específicos de plataforma

Al crear publicaciones, puedes pasar configuraciones específicas de la plataforma a través del parámetro controls:

Plataforma	Controles
X (Twitter)	`xCommunityId`, `xQuoteTweetUrl`, `xRetweetUrl`
Instagram	`instagramPublishType` (TIMELINE/STORY/REEL), `instagramPostToGrid`, `instagramCollaborators`
Facebook	`facebookContentType` (POST/REEL/STORY), `facebookAllowComments`, `facebookPrivacy`, `facebookReelsCollaborators`
TikTok	`tiktokPrivacy` (PUBLIC/MUTUAL_FRIENDS/FOLLOWER_OF_CREATOR/ONLY_ME), `tiktokIsDraft`, `tiktokAllowComments`, `tiktokAllowDuet`, `tiktokAllowStitch`, `tiktokBrandOrganic`, `tiktokBrandContent`, `tiktokAutoAddMusic`, `tiktokIsAigc`
YouTube	`youtubeTitle`, `youtubePrivacy` (PUBLIC/PRIVATE/UNLISTED), `youtubeTags`, `youtubeCategoryId`, `youtubeIsShort`, `youtubeMadeForKids`, `youtubePlaylistId`, `youtubeThumbnailKey`
Pinterest	`pinterestBoardId` (obligatorio), `pinterestLink`
LinkedIn	`linkedinAttachmentKey`, `linkedinAttachmentTitle`

Carga de archivos multimedia

La herramienta upload_media gestiona el flujo completo en una sola llamada:

Detecta el tipo de contenido a partir de la extensión del archivo
Obtiene una URL de carga firmada de PostFast
Sube el archivo
Devuelve una key y un type listos para usar en create_posts

Formatos compatibles: JPEG, PNG, GIF, WebP, MP4, WebM, MOV

También puedes usar get_upload_urls directamente si necesitas más control sobre el proceso de carga.

Variables de entorno

Variable	Requerido	Descripción
`POSTFAST_API_KEY`	Sí	Tu clave de API del espacio de trabajo
`POSTFAST_API_URL`	No	URL base de la API (predeterminado: `https://api.postfa.st`)

Pruebas

Verifica que todo funcione con el Inspector MCP:

POSTFAST_API_KEY=your-key npx @modelcontextprotocol/inspector npx postfast-mcp

Documentación de la API

Documentación completa de la API REST: postfa.st/docs

Desarrollo

npm install
npm run build
node dist/index.js

Insignias

peturgeorgievv-factory/postfast-mcp MCP server

Licencia

MIT

postfast-mcp