PostFast MCP-Server

Name: postfast-mcp
Author: peturgeorgievv-factory

MCP-Server für die PostFast API – plane und verwalte Social-Media-Beiträge über KI-Tools wie Claude, Cursor, VS Code und mehr.

Schnellstart

1. API-Schlüssel abrufen

Melde dich bei PostFast an, gehe in der Seitenleiste auf API und generiere einen Schlüssel.

2. Installation

Wähle deine bevorzugte Methode:

Claude Desktop (empfohlen)

Lade die Erweiterung aus dem Claude Desktop Extension Directory herunter oder installiere sie manuell:

Füge dies zu claude_desktop_config.json hinzu:

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

Starte Claude Desktop neu.

Claude Code

Per Plugin (Genehmigung durch den Marketplace steht noch aus):

/plugin install postfast@claude-plugins-official

Nach der Installation lege deinen API-Schlüssel fest – wähle eine dieser Optionen:

# 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" } }

Starte danach Claude Code neu.

Per manueller Konfiguration:

Füge dies zu .mcp.json deines Projekts oder zu ~/.claude/.mcp.json (global) hinzu:

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

Cursor / VS Code / Windsurf / Andere MCP-Clients

Füge dies zu deiner MCP-Konfiguration hinzu (.mcp.json, mcp.json oder in den Einstellungen des Tools):

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

3. Verwendung

Frage deinen KI-Assistenten Dinge wie:

"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"

Verfügbare Tools

Tool	Beschreibung
`list_accounts`	Liste verbundener Social-Media-Konten
`list_posts`	Liste von Beiträgen mit Filtern (Plattform, Status, Datumsbereich)
`create_posts`	Erstellen und Planen von Beiträgen (Batch, bis zu 15)
`delete_post`	Löschen eines Beitrags nach ID
`upload_media`	Hochladen einer lokalen Datei und Erhalt eines Medien-Keys (handhabt den gesamten Ablauf)
`get_upload_urls`	Erhalt signierter URLs zum Hochladen von Mediendateien
`list_pinterest_boards`	Abrufen von Pinterest-Boards für ein Konto
`list_youtube_playlists`	Abrufen von YouTube-Playlists für ein Konto
`generate_connect_link`	Generieren eines Links für Kunden zum Verbinden von Konten
`get_post_analytics`	Abrufen veröffentlichter Beiträge mit Leistungskennzahlen – Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (Unternehmensseiten)

Unterstützte Plattformen

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

Plattformspezifische Steuerelemente

Beim Erstellen von Beiträgen kannst du plattformspezifische Einstellungen über den Parameter controls übergeben:

Plattform	Steuerelemente
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` (erforderlich), `pinterestLink`
LinkedIn	`linkedinAttachmentKey`, `linkedinAttachmentTitle`

Medien-Upload

Das Tool upload_media handhabt den gesamten Ablauf in einem einzigen Aufruf:

Erkennt den Inhaltstyp anhand der Dateiendung
Ruft eine signierte Upload-URL von PostFast ab
Lädt die Datei hoch
Gibt einen key und type zurück, die bereit für create_posts sind

Unterstützte Formate: JPEG, PNG, GIF, WebP, MP4, WebM, MOV

Du kannst auch get_upload_urls direkt verwenden, wenn du mehr Kontrolle über den Upload-Prozess benötigst.

Umgebungsvariablen

Variable	Erforderlich	Beschreibung
`POSTFAST_API_KEY`	Ja	Dein Workspace-API-Schlüssel
`POSTFAST_API_URL`	Nein	API-Basis-URL (Standard: `https://api.postfa.st`)

Testen

Überprüfe mit dem MCP Inspector, ob alles funktioniert:

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

API-Dokumentation

Vollständige REST-API-Dokumentation: postfa.st/docs

Entwicklung

npm install
npm run build
node dist/index.js

Badges

peturgeorgievv-factory/postfast-mcp MCP server

Lizenz

MIT

postfast-mcp