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:

HerramientaQué hace
list_integrationsMuestra las cuentas sociales conectadas
create_postPublica o programa un post en una o más plataformas
list_posts / get_post / delete_postExplora y gestiona posts
list_scheduled_posts / reschedule_post / cancel_scheduled_postGestiona la cola de publicación
get_analyticsMétricas de posts multiplataforma
ai_write_content / ai_generate_imageAsistentes de IA para pies de foto e imágenes
get_pinterest_boardsRequerido antes de publicar en Pinterest
get_tiktok_creator_infoRequerido antes de publicar en TikTok
create_profile / list_profiles / update_profileGestión de perfiles multiinquilino
create_app / list_appsGestiona 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_boards para elegir un tablero y luego pasa el id del tablero como platformSpecificData.boardId en create_post. Los pines deben aterrizar en un tablero.
  • TikTok — llama a get_tiktok_creator_info y pasa platformSpecificData.privacyLevel usando uno de los privacyLevelOptions devueltos. 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):

  1. Authorization: Bearer <key> — recomendado.
  2. x-access-key: <key> — la misma cabecera que usa la API REST.
  3. ?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.

](https://www.postpeer.dev/docs/ai-agents/skills)