postiz-mcp MCP 服务说明文档

1. 服务概述一句话简介Postiz官方MCP客户端提供完整的Postiz公共API覆盖集成、帖子、上传、分析、视频支持环境变量控制写入权限、确认删除和内置速率限制保护服务名称postiz-mcp版本号1.0.0开发者/提供方solomonneas协议类型MCP (Model Context Protocol)2. 核心功能该MCP服务提供以下主要功能2.1 读取功能始终可用postiz_list_integrations- 列出已连接的社交媒体频道postiz_check_integration- 验证API密钥有效性postiz_find_next_slot- 查找频道的下一个可用发布时段postiz_list_posts- 列出指定日期范围内的帖子postiz_get_missing_content- 恢复帖子的平台内容postiz_list_notifications- 获取Postiz UI通知postiz_get_platform_analytics- 获取平台分析数据粉丝/展示/互动postiz_get_post_analytics- 获取帖子分析数据点赞/评论/分享postiz_list_voices- 获取AI视频语音目录postiz_get_provider_settings_schema- 获取各平台的设置模式2.2 写入功能需要POSTIZ_ENABLE_WRITEtruepostiz_create_post- 创建帖子立即发布/定时发布/草稿postiz_connect_integration- 生成新频道的OAuth URLpostiz_update_post_status- 切换帖子状态草稿↔队列postiz_update_post_release_id- 重新关联帖子到平台发布postiz_upload_file- 从本地文件或base64上传postiz_upload_from_url- 服务器端URL上传postiz_generate_video- AI视频生成2.3 删除功能需要额外权限和确认postiz_delete_post- 删除帖子级联删除整个组postiz_delete_post_group- 删除跨平台帖子组的所有帖子postiz_delete_integration- 断开频道连接并删除所有定时帖子3. 使用场景该服务适合以下使用场景社交媒体管理- 管理多个社交媒体平台的帖子发布内容调度- 自动化社交媒体内容定时发布跨平台发布- 一次性在多个平台发布相同内容社交媒体分析- 分析帖子表现和平台数据AI辅助创作- 使用AI生成视频内容自动化工作流- 通过AI助手自动化社交媒体运营4. 接入方式4.1 服务端点该服务连接到Postiz实例支持以下平台集成Bluesky- 去中心化社交平台Reddit- 社区论坛平台X (Twitter)- 微博平台LinkedIn- 职业社交平台其他平台- 支持Postiz集成的所有平台4.2 认证与权限服务使用以下认证和权限控制机制API密钥- 从Postiz设置中生成的API密钥写入权限- 需要设置POSTIZ_ENABLE_WRITEtrue删除权限- 需要设置POSTIZ_ENABLE_DELETEtrue并在调用时传递confirm: trueCloudflare Access- 可选的CF Access服务令牌认证4.3 数据格式服务使用以下数据格式请求格式JSON格式的帖子创建和管理请求响应格式JSON格式的帖子数据和分析结果文件上传支持multipart上传和base64编码4.4 服务器配置环境变量配置变量名必需默认值说明POSTIZ_URL是-Postiz实例URL如http://localhost:5000POSTIZ_API_KEY是-Postiz API密钥POSTIZ_ENABLE_WRITE否false启用写入功能POSTIZ_ENABLE_DELETE否false启用删除功能POSTIZ_REQUEST_TIMEOUT_MS否30000HTTP超时时间毫秒POSTIZ_RATE_LIMIT_PER_HOUR否30本地速率限制上限4.5 Claude Desktop配置添加到~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 或%APPDATA%\Claude\claude_desktop_config.json(Windows){ mcpServers: { postiz: { command: postiz-mcp, env: { POSTIZ_URL: http://localhost:5000, POSTIZ_API_KEY: your-api-key-here, POSTIZ_ENABLE_WRITE: true, POSTIZ_ENABLE_DELETE: false } } } }5. 接口定义该服务提供的主要接口分类5.1 集成管理接口接口名称功能描述权限要求postiz_list_integrations列出已连接的社交媒体频道读取postiz_check_integration验证API密钥读取postiz_connect_integration生成OAuth URL连接新频道写入postiz_delete_integration断开频道连接删除5.2 帖子管理接口接口名称功能描述权限要求postiz_create_post创建帖子立即/定时/草稿写入postiz_list_posts列出日期范围内的帖子读取postiz_update_post_status更新帖子状态写入postiz_delete_post删除帖子删除5.3 分析接口接口名称功能描述返回数据postiz_get_platform_analytics获取平台分析数据粉丝数/展示量/互动率postiz_get_post_analytics获取帖子分析数据点赞/评论/分享数6. 快速开始6.1 环境要求Node.js支持TypeScript的版本Postiz实例自托管或云服务API密钥从Postiz设置中生成6.2 安装步骤# 全局安装 npm install -g postiz-mcp # 或从源码安装 git clone https://github.com/solomonneas/postiz-mcp.git cd postiz-mcp npm install npm run build6.3 获取API密钥以管理员身份登录Postiz进入 Settings → Public API点击 Generate API Key复制API密钥以pos_开头或为UUID格式6.4 使用示例在AI助手中使用自然语言交互列出我的Postiz集成为明天上午9点安排一条Bluesky帖子刚刚发布了postiz-mcpLinkedIn的下一个可用时段是什么在那个时间为X安排这个4条推文的线程上周发布了什么周二的X帖子表现如何显示X提供商设置模式以便我构造线程负载7. 重要警告7.1 发布副作用Postiz写入操作会产生公开的副作用。成功的postiz_create_post调用type: now或近期定时会在真实的社交媒体账户上发布内容。一旦发布虽然可以从Postiz删除帖子但平台上的帖子仍然存在——Postiz无法撤回。7.2 速率限制Postiz公共API默认限制为每小时30个请求。此服务器在本地跟踪限制当配额耗尽时拒绝发送。如果您的Postiz实例配置了更高的限制请使用POSTIZ_RATE_LIMIT_PER_HOUR覆盖。7.3 权限控制写入和删除操作默认关闭。读取操作始终可用。要启用写入必须显式设置POSTIZ_ENABLE_WRITEtrue。要启用删除必须额外设置POSTIZ_ENABLE_DELETEtrue并在工具调用中传递confirm: true。8. Cloudflare Access配置如果您的Postiz通过Cloudflare Tunnel Access暴露例如 https://postiz.example.com需要在Cloudflare Zero Trust仪表板中生成服务令牌并添加环境变量export POSTIZ_CF_ACCESS_CLIENT_IDyour-cf-id.access export POSTIZ_CF_ACCESS_CLIENT_SECRETyour-cf-secretMCP服务器会在每个请求中转发这些令牌。如果忘记设置会收到清晰的PostizCfAccessChallengeError错误而不是令人困惑的HTML响应。9. 开发与测试npm install npm run typecheck npm test npm run build10. 许可证MIT License