Socialync
Rascunhe, agende e publique posts de mídia social em 8 plataformas a partir de qualquer agente de IA. Somente APIs oficiais, sem scraping.
Documentação
Servidor MCP Socialync
Documentação oficial, manifesto de registro e plugin para Cursor do servidor MCP hospedado Socialync. Socialync é uma ferramenta de agendamento e publicação cruzada para criadores: envie uma vez, publique no TikTok, Instagram, YouTube, Facebook, X, LinkedIn, Threads e Bluesky.
Este servidor MCP permite que Claude, ChatGPT, Cursor, Grok Bot e qualquer agente de IA compatível com MCP rascunhe, agende e publique posts em redes sociais através da sua própria conta Socialync autorizada via OAuth, com aprovação humana integrada ao fluxo de trabalho.
Cada integração de plataforma roda na API oficial da plataforma. Sem automação de navegador, sem scraping, sem endpoints não oficiais. Seu agente não pode ter sua conta restringida em nosso nome.
A proteção contra duplicatas garante que uma nova tentativa nunca publique duas vezes, e posts com falha são tentados novamente automaticamente. Ambos os recursos importam quando um agente está fazendo a publicação.
Nota: O servidor do Socialync é hospedado (remoto) e de código fechado. Este repositório contém apenas a documentação, o manifesto do Registro MCP e os arquivos do plugin para Cursor. Não há nada para instalar ou executar a partir daqui.
Endpoint
https://mcp.socialync.io/mcp
Transporte: HTTP Streamable. Documento de descoberta (ferramentas, plataformas, autenticação, limites, em JSON): https://mcp.socialync.io/.well-known/mcp
O acesso MCP e API está no plano gratuito. $0, sem cartão de crédito, 5 posts por mês em todas as 8 plataformas. Seu agente pode conectar e publicar sem que ninguém precise pegar um cartão. Planos pagos começam em $20/mês para posts ilimitados e 5 contas conectadas (Starter $20, Creator $30 para 10 contas, Studio $60 para 25, Agency $99 para 100). Planos e preços.
Limites que vale a pena conhecer: 1 chave de API por marca e 10 posts criados por IA por dia por marca nos planos pagos (5 no gratuito).
Autenticação, de duas formas
A) OAuth 2.0 (preferido). Adicione a URL sem cabeçalhos. Seu cliente se registra sozinho (registro dinâmico de cliente, PKCE, sem segredo de cliente), abre um navegador e você faz login com sua conta Socialync e escolhe quais marcas o agente pode gerenciar. É isso que Claude.ai, Claude Code, Cursor e ChatGPT fazem por conta própria.
B) Chave de API Bearer. Para clientes que não conseguem concluir um fluxo OAuth no navegador (Grok Bot, agentes headless, arquivos de configuração editados manualmente). Gere uma chave em https://www.socialync.io/api-keys e envie Authorization: Bearer <key>. Uma chave por marca, incluída em todos os planos. Nunca faça commit da chave.
Callbacks OAuth conhecidos por funcionar de ponta a ponta (qualquer URI de redirecionamento https mais http://localhost e http://127.0.0.1 em qualquer porta é aceita):
- https://www.cursor.com/agents/mcp/oauth/callback
- http://localhost:8787/callback
- https://claude.ai/api/mcp/auth_callback
- http://localhost/callback
- http://127.0.0.1/callback
Conectar
Claude (claude.ai): Configurações, depois Conectores, depois "Adicionar conector personalizado" e cole a URL do endpoint acima. Guia completo: Guia do conector Socialync MCP.
Claude Code:
claude mcp add --transport http socialync https://mcp.socialync.io/mcp
Cursor / Grok Bot (OAuth, apenas URL):
{
"mcpServers": {
"socialync": {
"url": "https://mcp.socialync.io/mcp"
}
}
}
Grok Bot ou qualquer cliente que não consiga concluir OAuth (chave Bearer):
{
"mcpServers": {
"socialync": {
"url": "https://mcp.socialync.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_SOCIALYNC_API_KEY"
}
}
}
}
O Grok Bot executa OAuth a partir da nuvem do Cursor, não da sua máquina. A mesma URL pode funcionar no IDE do Cursor e falhar no Grok Bot. Teste no Grok Bot em Configurações, depois Plugins, não apenas no IDE. Se o OAuth nunca iniciar ou você vir "falha na busca", use o formulário de chave Bearer.
OpenClaw:
openclaw mcp add socialync --url https://mcp.socialync.io/mcp --transport streamable-http
openclaw mcp login socialync
Outros clientes MCP (configuração genérica):
{
"mcpServers": {
"socialync": {
"type": "streamable-http",
"url": "https://mcp.socialync.io/mcp"
}
}
}
Plugin para Claude Code
Este repositório também é um plugin para Claude Code: .claude-plugin/plugin.json é o manifesto, .mcp.json adiciona o servidor hospedado sem segredos, e as mesmas três habilidades em skills/ são carregadas. Ele passa em claude plugin validate .. Notas de configuração, incluindo como funciona o login: SETUP.md.
Assim que estiver listado no diretório de plugins do Claude, instale com claude plugin install socialync. Até lá, ou para pular o plugin, adicione o servidor diretamente (veja Claude Code em Conectar acima); as habilidades são orientação opcional, o servidor é o produto.
Plugin para Cursor e Grok Bot
Este repositório também é o plugin para Cursor (.cursor-plugin/plugin.json, mcp.json, skills/, assets/logo.png). Instale pelo Marketplace do Cursor (pesquise "Socialync") assim que estiver listado, ou adicione a URL MCP diretamente como acima. As habilidades em skills/ informam ao agente quando rascunhar, agendar, reaproveitar ou inspecionar a fila. Checklist de envio: MARKETPLACE-SUBMIT.md.
Ferramentas
Vinte e duas ferramentas. A mesma lista é publicada em https://www.socialync.io/.well-known/mcp.
| Ferramenta | O que faz |
|---|---|
list_profiles | Liste seus perfis de marca no Socialync (chame primeiro; toda escrita recebe um profileId) |
list_connections | Mostre quais contas sociais estão conectadas e saudáveis |
list_audiences | Liste públicos salvos que um post pode segmentar |
list_media | Navegue pela mídia já no Socialync, com o mediaId usado para anexar vídeo |
create_media_upload / finalize_media_upload | Envie imagens ou um vídeo gerado |
check_quota | Plano, posts restantes, limites diários por plataforma, janela de agendamento |
validate_post | Pré-verificação somente leitura: tamanho da legenda, links, mídia, proporção de aspecto, duração do vídeo, saúde da conexão |
create_post_draft | Rascunhe um post de texto ou imagem (você aprova no aplicativo) |
schedule_post_draft | Rascunhe um post para um horário futuro, texto, imagem ou vídeo (você aprova no aplicativo) |
get_draft_status | Verifique em que etapa do pipeline um rascunho está |
approve_draft | Publique um rascunho pendente após você confirmar no chat |
publish_now | Publique um post de texto ou imagem imediatamente, após você confirmar no chat |
publish_scheduled | Agende um post diretamente, incluindo vídeo para TikTok e YouTube, após você confirmar no chat |
create_x_article_draft / publish_x_article_now | Artigos longos do X (conta X Premium necessária) |
get_scheduled_posts | Liste posts agendados futuros |
delete_scheduled_post | Cancele um post agendado |
get_post_history | Revise o histórico de posts publicados e o status |
get_top_posts | Destaque seu conteúdo de melhor desempenho |
get_analytics | Obtenha análises de seguidores e engajamento |
generate_content | Gere legendas nativas da plataforma com IA (planos pagos) |
Posts de texto e imagem são publicados imediatamente no Instagram, Facebook, X, LinkedIn, Threads e Bluesky. Posts de vídeo, incluindo TikTok e YouTube (título obrigatório), saem como posts agendados usando mídia hospedada na sua biblioteca do Socialync ou uma URL pública de vídeo. Um arquivo de vídeo bruto não pode ser colado em um chat; envie-o no Socialync primeiro.
Referência completa, incluindo ordem de chamada recomendada, limites por plataforma e tratamento de erros: docs/tools.md.
Como o humano permanece no controle
O fluxo de trabalho pretendido é validar primeiro, rascunhar em segundo, publicar por último. Agentes criam rascunhos com create_post_draft ou schedule_post_draft; nada chega a uma rede social até que o rascunho seja aprovado no aplicativo, ou até que você confirme no chat e o agente chame approve_draft, publish_now ou publish_scheduled. Os posts saem por conexões OAuth que você autorizou no Socialync e podem ser revogadas a qualquer momento nas configurações da sua conta. Assistentes de IA ajudam você a rascunhar, agendar e publicar; eles não operam contas que você não conectou e aprovou, e não há modo de publicação autônoma sem supervisão.
Habilidade do agente
Uma habilidade OpenClaw que envolve este servidor é publicada no ClawHub:
openclaw skills install @jackvitick/social-media-scheduler
Links
- Site: socialync.io
- Visão geral do recurso MCP: socialync.io/features/mcp
- Guia de configuração do conector: socialync.io/mcp-connector-guide
- Documento de descoberta: socialync.io/.well-known/mcp
- Registro MCP oficial:
io.github.JackVitick/socialync - Termos de Serviço: socialync.io/terms-of-service
- Contrato de Desenvolvedor (API e MCP): socialync.io/developer-terms
- Política de Privacidade: socialync.io/privacy-policy
Suporte
Perguntas ou problemas: abra uma issue aqui ou envie um e-mail para support@socialync.io.
Siga o Socialync
- X: https://x.com/Socialync_io
- Instagram: https://www.instagram.com/socialync.io/
- TikTok: https://www.tiktok.com/@socialync.io
- YouTube: https://www.youtube.com/@Socialync-io
- LinkedIn: https://www.linkedin.com/company/socialync
- Threads: https://www.threads.com/@socialync.io
- Bluesky: https://bsky.app/profile/socialync.bsky.social