Solnk MCP

npx add-mcp 'https://mcp.solnk.com/mcp'

Solnk MCP

Un servidor de Model Context Protocol para Solnk — permite que cualquier cliente MCP (Claude, Cursor, tu propio agente) publique y programe contenido en 9 plataformas sociales a través de una única interfaz de herramientas: X, Instagram, TikTok, YouTube, Facebook, LinkedIn, Pinterest, Threads y Bluesky.

Es un proxy delgado y sin estado hacia la API pública de Solnk: tu clave de API se reenvía en cada solicitud, y toda la autenticación, los alcances y las cuotas se aplican del lado del servidor. No se almacenan credenciales en este Worker.

Endpoint alojado

Una instancia administrada se ejecuta en:

https://mcp.solnk.com/mcp

Autentícate con una clave de API de Solnk como token de portador. Crea una en https://solnk.com/settings/api-keys.

Authorization: Bearer sk_...

Conectar un cliente

La mayoría de los clientes MCP acceden a un servidor HTTP remoto a través de mcp-remote. Ejemplo de configuración (Claude Desktop / Cursor / cualquier cliente que use el esquema estándar mcpServers):

{
  "mcpServers": {
    "solnk": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.solnk.com/mcp",
        "--header",
        "Authorization:Bearer ${SOLNK_API_KEY}"
      ],
      "env": {
        "SOLNK_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Los clientes con soporte nativo de Streamable HTTP pueden conectarse directamente a https://mcp.solnk.com/mcp y configurar el encabezado Authorization: Bearer sk_....

Herramientas

Herramienta	Qué hace
solnk_list_accounts	Lista las cuentas sociales conectadas (id, plataforma, nombre de usuario, estado, capacidades). Llámala primero para obtener los account_ids.
solnk_get_usage	Planifica límites y uso actual — verifica can_publish antes de publicar.
solnk_publish	Publica en una o más plataformas en una sola solicitud (immediate, scheduled o draft).
solnk_confirm_publish	Confirma un borrador para que se publique, ahora o programado.
solnk_cancel_publish	Cancela un borrador o una publicación programada aún no enviada.
solnk_get_publish_status	Estado agregado de una publicación.
solnk_list_publishes	Lista publicaciones recientes con filtros.
solnk_get_post_analytics	Métricas de publicaciones consolidadas o por plataforma, incluidas las URL en vivo de las publicaciones.
solnk_create_media_upload	Carga pre-firmada para un archivo local de imagen/video (flujo de 3 pasos).
solnk_confirm_media_upload	Finaliza una carga pre-firmada.
solnk_create_media_from_url	Ingresa una imagen/video mediante URL pública en una sola llamada.

Las formas completas de solicitud/respuesta y las opciones por plataforma están en developers.solnk.com.

Autoalojamiento

El servidor es un único Cloudflare Worker.

pnpm install

# Local dev — point at your own Solnk API base if needed
# (edit SOLNK_API_BASE in wrangler.toml, e.g. http://localhost:3002/api/v1)
pnpm dev

# Deploy to your own Cloudflare account
pnpm deploy

wrangler.toml:

• SOLNK_API_BASE — la API pública de Solnk a la que las herramientas hacen proxy (por defecto https://api.solnk.com/api/v1).
• routes — vincula tu propio dominio personalizado.

No se necesitan secretos al momento del despliegue; la clave de API la proporciona el cliente en el momento de la solicitud.

Descubrimiento sin clave

El descubrimiento de MCP (initialize / tools/list) es abierto — los clientes, inspectores y directorios pueden inspeccionar la superficie de herramientas sin una clave de API. Solo se requiere una clave para invocar realmente una herramienta de publicación. Se incluye un Dockerfile para que el Worker pueda compilarse y ejecutarse localmente (wrangler dev, sin inicio de sesión en Cloudflare) para inspección.

Licencia

MIT © Solnk