PostPeer
API Unificada de Redes Sociales
Documentación
Servidor MCP
Conecta Claude, Cursor, ChatGPT y otros agentes de IA a PostPeer mediante el Protocolo de Contexto de Modelo.
PostPeer ejecuta un servidor MCP (Protocolo de Contexto de Modelo) alojado en https://mcp.postpeer.dev/mcp. Añade una URL a tu cliente de IA y obtendrás 34 herramientas que cubren todos los endpoints de PostPeer: publicación, programación, analíticas, integraciones, perfiles, asistentes de IA y más.
Nada que instalar. Nada ejecutándose localmente.
¿Qué es MCP?
Model Context Protocol es un estándar abierto de Anthropic que permite a los asistentes de IA llamar a herramientas externas. Cuando añades el servidor MCP de PostPeer a un cliente compatible, la IA puede publicar posts, programar contenido, obtener analíticas y gestionar tus cuentas sociales directamente.
Conecta tu cliente de IA
Necesitarás una clave de acceso de PostPeer: consíguela en el Dashboard.
Claude.ai (web)
En Claude, ve a Customize → Connectors → Add custom connector y pega esta URL en el campo Remote MCP:
https://mcp.postpeer.dev/mcp?access_key=YOUR_POSTPEER_API_KEY
Reemplaza YOUR_POSTPEER_API_KEY con tu clave de acceso del Dashboard.
Claude Desktop / Claude Code / Cursor
Añade lo siguiente a tu configuración MCP:
{
"mcpServers": {
"postpeer": {
"url": "https://mcp.postpeer.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_POSTPEER_API_KEY"
}
}
}
}
Reinicia el cliente. Las herramientas de PostPeer (create_post, list_integrations, get_analytics, etc.) aparecerán en la lista de herramientas disponibles.
ChatGPT (y otros clientes MCP Streamable-HTTP)
Misma estructura: apunta el cliente a https://mcp.postpeer.dev/mcp y pasa Authorization: Bearer YOUR_POSTPEER_API_KEY. Si tu cliente no admite cabeceras personalizadas, añade ?access_key=YOUR_POSTPEER_API_KEY a la URL en su lugar.
Herramientas disponibles
El servidor MCP expone una herramienta por cada operación de la API pública. Las más comunes:
| Herramienta | Qué hace |
|---|---|
list_integrations | Muestra las cuentas sociales conectadas |
create_post | Publica o programa un post en una o más plataformas |
list_posts / get_post / delete_post | Explora y gestiona posts |
list_scheduled_posts / reschedule_post / cancel_scheduled_post | Gestiona la cola de publicación |
get_analytics | Métricas de posts multiplataforma |
ai_write_content / ai_generate_image | Asistentes de IA para pies de foto e imágenes |
get_pinterest_boards | Requerido antes de publicar en Pinterest |
get_tiktok_creator_info | Requerido antes de publicar en TikTok |
create_profile / list_profiles / update_profile | Gestión de perfiles multiinquilino |
create_app / list_apps | Gestiona aplicaciones OAuth BYOK |
La lista completa está en el repositorio MCP: github.com/geiger01/postpeer-mcp.
Pruébalo
Una vez conectado, pregúntale a tu cliente de IA cosas como:
- "Lista mis cuentas sociales conectadas."
- "Redacta un tweet anunciando nuestro nuevo producto y prográmalo para mañana a las 9 a. m. hora del Este."
- "¿Cómo rindieron mis últimos 5 posts de LinkedIn?"
- "Genera una imagen para un post sobre los resultados del tercer trimestre y publícala en Twitter y LinkedIn."
La IA llama a las herramientas relevantes, PostPeer publica y recibes una confirmación en línea.
Requisitos previos de plataforma
Antes de publicar en ciertas plataformas, la IA debe llamar primero a una herramienta auxiliar:
- Pinterest — llama a
get_pinterest_boardspara elegir un tablero y luego pasa el id del tablero comoplatformSpecificData.boardIdencreate_post. Los pines deben aterrizar en un tablero. - TikTok — llama a
get_tiktok_creator_infoy pasaplatformSpecificData.privacyLevelusando uno de losprivacyLevelOptionsdevueltos. Requerido por las reglas de intercambio de contenido de TikTok.
La descripción de la herramienta de create_post apunta al modelo hacia estos requisitos automáticamente, así que no deberías necesitar indicarlos manualmente.
Autenticación
El servidor MCP acepta tu clave de acceso de tres maneras (en orden de prioridad):
Authorization: Bearer <key>— recomendado.x-access-key: <key>— la misma cabecera que usa la API REST.?access_key=<key>cadena de consulta — para clientes sin soporte de cabeceras personalizadas.
El servidor MCP nunca valida la clave por sí mismo: reenvía cada llamada a api.postpeer.dev, que gestiona la autenticación, los créditos y el límite de velocidad. Así, el uso de créditos, los límites del plan y los permisos de la clave de acceso se comportan de manera idéntica a REST.
Autoalojamiento
Si necesitas el MCP en tu propia infraestructura (cumplimiento normativo, dominio personalizado, etc.), el código fuente es abierto: github.com/geiger01/postpeer-mcp. Es un servidor pequeño de Node + Express + @modelcontextprotocol/sdk: se ejecuta en cualquier lugar donde Node funcione (Railway, Fly, Render, tu propio VPS).
Solución de problemas
401 Unauthorized— tu clave de acceso falta o no es válida. Confirma que el token Bearer esté configurado en el cliente y que la clave funcione contra la API REST.429 Too Many Requests— límite de velocidad de tu plan. Mejora el plan o espacia las llamadas.- Las herramientas no aparecen en el cliente — reinicia el cliente de IA después de editar la configuración. Algunos clientes también necesitan que MCP esté habilitado explícitamente en los ajustes.
[
Agent Skills
Instala las Agent Skills de PostPeer para que los agentes de codificación puedan publicar, programar, subir medios, listar cuentas y obtener analíticas a través de PostPeer.