PostPiper MCP
透過您的 AI 助理管理社群帳號、建立草稿、上傳圖片,並在 X 和 LinkedIn 發佈或排程貼文。
託管 MCP 伺服器
npx add-mcp 'https://mcp.postpiper.ai/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
PostPiper MCP Server
IntroductionQuickstartMCPAPI Reference
Documentation
Accounts
Posts
- POSTCreate a draft
- PATCHEdit a draft
- GETGet a post
- GETList posts
- POSTPublish a post
- POSTSchedule a post
Media
MCP
Copy for AIOpen in
MCP setup
Connect your AI client to PostPiper. The server is hosted, so there is nothing to install.
See the PostPiper MCP overview for supported platforms and pricing.
MCP server URLCopy
https://mcp.postpiper.ai/mcp
PostPiper is listed in the official MCP Registry as ai.postpiper/mcp. View the server.json metadata for its version and connection details.
Read the MCP overview as Markdown.
Connect your client
ChatGPT setup is shown below. Other clients link to their guides further down the page.
ChatGPTClaudeGeminiGrok BotCodexClaude CodeCursorGrokOther
ChatGPT
PostPiper isn't in the public directory yet. Add it as a custom MCP server in ChatGPT:
- Open ChatGPT Plugins, select +, then Add custom MCP server.
- Name it PostPiper, enter
https://mcp.postpiper.ai/mcp, and choose OAuth. - Create the plugin, then install it from your personal plugins.
- Complete authorization, then use
@PostPiperin a ChatGPT chat.
Test the connection
Ask your assistant to list your connected social media accounts. It calls list_connected_accounts and returns each account's platform, username, and ID.
PromptCopy
@postpiper list my connected social media accounts
Example response
Found 1 connected account(s):
- X: acme (ID: 550e8400-e29b-41d4-a716-446655440000)
No accounts yet? Connect one and ask again.
Tools
Your assistant can use these tools after you connect.
whoami
Show your signed-in PostPiper profile.
list_connected_accounts
List your connected social accounts.
open_media_uploader
Open an image picker in clients that support MCP Apps.
upload_media
Upload a JPEG, PNG, or WebP image up to 2 MB from a client that can provide file bytes.
import_media_from_url
Import an image from a public HTTPS URL.
list_media_assets
List your uploaded images and their asset IDs.
get_media_asset
Get an image asset's details and a fresh preview URL.
prepare_tiktok_video_upload
Get a signed upload URL for one MP4 or MOV video. After uploading, use the returned media URL in the TikTok draft.
create_draft
Create a draft with text or images for X or LinkedIn, or attach one MP4 or MOV video to a TikTok draft.
update_draft
Edit a draft's text or attachments.
get_tiktok_creator_info
Check the creator’s available visibility and interaction settings before confirming a TikTok post.
publish_post
Publish an approved X or LinkedIn draft or TikTok video now.
schedule_post
Schedule an approved X or LinkedIn draft or TikTok video for later.
get_post
Get a post's content, media, platform, status, account, and scheduling or publication details.
list_posts
List posts by status, platform, account, or time range, with pagination.
Publishing and scheduling require your confirmation.
Client setup guides
Setup steps for other clients (ChatGPT is above). Server URL: https://mcp.postpiper.ai/mcp
Claude
In Claude (web, desktop or mobile), open Settings, then Connectors, then Add custom connector:
- Name: PostPiper
- URL:
https://mcp.postpiper.ai/mcp
Click Add. Claude redirects you to sign in with your PostPiper account, then the connector activates. No API key is needed.
Gemini
Connect PostPiper as a custom MCP app in Gemini Developer Mode:
-
Open Gemini Developer Mode, or enable Gemini Apps Developer Mode from Gemini's Settings.
-
In the app picker, choose + Create new.
-
In Connect to an MCP server, paste the URL below into MCP Server URL, then click Next.
MCP server URLCopy
https://mcp.postpiper.ai/mcp -
Click Connect to complete authorization.
-
Start a Gemini chat, type
@PostPiper, and ask it to list your connected social accounts.
Try in GeminiCopy
@PostPiper list my connected social media accounts
Grok Bot
-
Copy and paste this message to Grok Bot:
Message to Grok BotCopy
Visit https://postpiper.ai and setup for me -
Follow the prompts to add the connector and authorize access.
Codex
Add PostPiper in the Codex CLI, then start OAuth sign-in. Codex CLI and the IDE extension share this configuration.
TerminalCopy
codex mcp add postpiper --url https://mcp.postpiper.ai/mcp
codex mcp login postpiper
Claude Code
Run this command to add PostPiper for all your Claude Code projects.
TerminalCopy
claude mcp add --transport http --scope user postpiper https://mcp.postpiper.ai/mcp
Use /mcp select PostPiper and sign in with your PostPiper account:
> /mcp
Select > PostPiper
Select > Authenticate
Cursor
Add a remote server in Cursor, or put this in ~/.cursor/mcp.json (or a project's .cursor/mcp.json).
~/.cursor/mcp.jsonCopy
{
"mcpServers": {
"postpiper": {
"url": "https://mcp.postpiper.ai/mcp"
}
}
}
Cursor prompts you to sign in with your PostPiper account. To use an API key instead, pass it as a header:
~/.cursor/mcp.jsonCopy
{
"mcpServers": {
"postpiper": {
"url": "https://mcp.postpiper.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:POSTPIPER_API_KEY}"
}
}
}
}
Grok
- Sign in to PostPiper.
- Open grok.com/connectors.
- Click New Connector, select Custom, and name it PostPiper.
- Paste
https://mcp.postpiper.ai/mcpas the MCP server URL. - Complete OAuth sign-in with your PostPiper account.
Grok can then list accounts, create drafts, schedule posts, and publish from your chats. Confirm publishing and scheduling when prompted.
Other clients
Add https://mcp.postpiper.ai/mcp as a remote Streamable HTTP MCP server. Your client must support OAuth discovery and browser sign-in.
If it fails
- Sign-in: Reconnect and complete OAuth.
- No accounts: Connect an account.
- Missing tools: Refresh or restart your client.
Prefer direct HTTP?
Use the PostPiper REST API with an API key.
Explore the social media scheduling API for supported platforms, pricing, and code examples.
On this page
Connect your clientTest the connectionToolsClient setup guidesChatGPTClaudeGeminiGrok BotCodexClaude CodeCursorGrokOtherIf it fails