Solnk MCP

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

Solnk MCP

Um servidor Model Context Protocol para Solnk — permita que qualquer cliente MCP (Claude, Cursor, seu próprio agente) publique e agende conteúdo em 9 plataformas sociais por meio de uma única interface de ferramentas: X, Instagram, TikTok, YouTube, Facebook, LinkedIn, Pinterest, Threads e Bluesky.

É um proxy fino e sem estado para a API pública do Solnk: sua chave de API é encaminhada por requisição, e toda a aplicação de autenticação/escopo/cota ocorre no lado do servidor. Nenhuma credencial é armazenada neste Worker.

Endpoint hospedado

Uma instância gerenciada está disponível em:

https://mcp.solnk.com/mcp

Autentique-se com uma chave de API do Solnk como token bearer. Crie uma em https://solnk.com/settings/api-keys.

Authorization: Bearer sk_...

Conecte um cliente

A maioria dos clientes MCP acessa um servidor HTTP remoto por meio de mcp-remote. Exemplo de configuração (Claude Desktop / Cursor / qualquer cliente que use o esquema padrão 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"
      }
    }
  }
}

Clientes com suporte nativo a Streamable HTTP podem se conectar diretamente a https://mcp.solnk.com/mcp e definir o cabeçalho Authorization: Bearer sk_....

Ferramentas

Ferramenta	O que faz
solnk_list_accounts	Lista contas sociais conectadas (id, plataforma, nome de usuário, status, capacidades). Chame primeiro para obter os account_ids.
solnk_get_usage	Planeja limites e uso atual — verifique can_publish antes de publicar.
solnk_publish	Publica em uma ou mais plataformas em uma única requisição (immediate, scheduled ou draft).
solnk_confirm_publish	Confirma um rascunho para que ele seja enviado, agora ou agendado.
solnk_cancel_publish	Cancela um rascunho ou uma publicação agendada ainda não enviada.
solnk_get_publish_status	Status agregado de uma publicação.
solnk_list_publishes	Lista publicações recentes com filtros.
solnk_get_post_analytics	Métricas de postagem consolidadas ou por plataforma, incluindo URLs ao vivo dos posts.
solnk_create_media_upload	Upload pré-assinado para um arquivo local de imagem/vídeo (fluxo de 3 etapas).
solnk_confirm_media_upload	Finaliza um upload pré-assinado.
solnk_create_media_from_url	Ingere uma imagem/vídeo por URL pública em uma única chamada.

Formas completas de requisição/resposta e opções por plataforma estão em developers.solnk.com.

Auto-hospedagem

O servidor é um ú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 — a API pública do Solnk para a qual as ferramentas fazem proxy (padrão: https://api.solnk.com/api/v1).
• routes — vincule seu próprio domínio personalizado.

Nenhum segredo é necessário no momento da implantação; a chave de API é fornecida pelo cliente no momento da requisição.

Descoberta sem chave

A descoberta do MCP (initialize / tools/list) é aberta — clientes, inspetores e diretórios podem inspecionar a superfície de ferramentas sem uma chave de API. Uma chave é necessária apenas para realmente invocar uma ferramenta de publicação. Um Dockerfile está incluído para que o Worker possa ser compilado e executado localmente (wrangler dev, sem login no Cloudflare) para inspeção.

Licença

MIT © Solnk