Social Neuron MCP Server

@socialneuron/mcp-server

91 ferramentas MCP públicas para gerenciamento de mídias sociais com IA. Crie conteúdo, agende publicações, acompanhe análises e otimize o desempenho — tudo a partir do Claude Code ou de qualquer cliente MCP.

Início Rápido

1. Autentique-se

npx -y @socialneuron/mcp-server login --device

Isso abre seu navegador para autorizar o acesso. Requer um plano Social Neuron Pro ou superior. Consulte preços.

2. Adicione ao Claude Code

claude mcp add socialneuron -- npx -y @socialneuron/mcp-server

{
  "mcpServers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

{
  "servers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "socialneuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}

3. Comece a usar

Pergunte ao Claude: "O que devo publicar esta semana?" ou "Agende meu vídeo mais recente para YouTube e TikTok"

O Que Você Pode Fazer

Pergunte coisas como estas ao Claude:

• "Gere 5 ideias de conteúdo sobre moda sustentável para a Geração Z"
• "Crie um anúncio em vídeo de 30 segundos para o lançamento do meu produto"
• "Agende esta publicação para X e Bluesky às 9h de amanhã"
• "Mostre-me meu conteúdo de melhor desempenho neste mês"
• "Quais são os tópicos em alta no meu nicho agora?"
• "Verifique minhas análises e sugira melhorias"
• "Configure o piloto automático para publicar 3 vezes por semana"

Categorias de Ferramentas

O endpoint hospedado e o servidor npm stdio expõem cada um 91 ferramentas públicas. Suas superfícies diferem intencionalmente: o HTTP hospedado inclui os MCP Apps Content Calendar e Analytics Pulse, enquanto o stdio inclui 2 ferramentas locais de captura de tela em vez disso. A contagem hospedada ao vivo é publicada pelo cartão do servidor. Um pequeno conjunto de ferramentas de serviço internas usadas pela automação do próprio Social Neuron é registrado, mas não faz parte da superfície pública.

Essas ferramentas estão disponíveis para agentes de IA (Claude, Cursor, etc.) por meio do protocolo MCP.

Ciclo de Vida do Conteúdo

Gerenciamento e Otimização

Utilitários

MCP Apps Interativos (HTTP hospedado)

Os apps são renderizados apenas em hosts MCP que suportam a extensão MCP Apps. Todos os dados subjacentes e operações de escrita permanecem como ferramentas comuns com escopo, portanto, hosts sem interface interativa podem usar os mesmos fluxos de trabalho por meio de chamadas de texto/ferramenta.

Autenticação

Três métodos de autenticação, em ordem de recomendação:

Código de Dispositivo (Recomendado)

npx -y @socialneuron/mcp-server login --device

Abre o navegador, você aprova e a CLI recebe a chave de API automaticamente.

Fluxo de Navegador

npx -y @socialneuron/mcp-server login

Fluxo OAuth baseado em navegador.

Colar Chave de API

npx -y @socialneuron/mcp-server login --paste

Gere uma chave em socialneuron.com/settings/developer e cole-a.

As chaves são armazenadas no chaveiro do seu sistema operacional (macOS Keychain, Linux secret-tool) ou em um arquivo de fallback criado com permissões somente do proprietário, onde o sistema operacional suportar.

Usuários do Windows: O arquivo de fallback (~/.config/social-neuron/credentials.json) não tem aplicação forte de permissões no NTFS. Para uso em produção no Windows, defina a variável de ambiente SOCIALNEURON_API_KEY em vez disso.

Preços

O acesso MCP/API requer um plano Pro ou superior:

Cadastre-se em socialneuron.com/pricing.

Escopos

Cada chave de API herda escopos do seu plano. As ferramentas exigem escopos específicos para serem executadas.

Referência da CLI

Esses comandos são executados diretamente no seu terminal — sem necessidade de agente de IA. Úteis para scripts, CI/CD e verificações rápidas.

Após a instalação global (npm i -g @socialneuron/mcp-server), use socialneuron-mcp diretamente. Caso contrário, prefixe com npx @socialneuron/mcp-server.

# Auth
socialneuron-mcp login [--device|--paste]
socialneuron-mcp logout

# Deterministic CLI (no LLM)
socialneuron-mcp sn publish --media-url <url> --caption <text> --platforms <list> --confirm
socialneuron-mcp sn status --job-id <id>
socialneuron-mcp sn posts --days 7 --platform youtube
socialneuron-mcp sn refresh-analytics
socialneuron-mcp sn preflight --check-urls
socialneuron-mcp sn oauth-health --json
socialneuron-mcp sn oauth-refresh --platform instagram
socialneuron-mcp sn quality-check --content "your text here"
socialneuron-mcp sn autopilot
socialneuron-mcp sn usage
socialneuron-mcp sn loop
socialneuron-mcp sn credits

# Agent-native CLI v2
socialneuron-mcp sn tools [--module ideation] [--scope mcp:write]  # List/filter available tools
socialneuron-mcp sn info                                            # Version, auth, credits, tool count
socialneuron-mcp sn plan list|view|approve                          # Content plan management
socialneuron-mcp sn preset list|show|save|delete                    # Platform presets (6 built-in)

# Interactive REPL
socialneuron-mcp repl

# Add --json to any command for machine-readable output

Fluxo de Automação (Loop E2E)

O loop completo de conteúdo autônomo usando ferramentas MCP:

1. get_loop_summary — avalie o estado do projeto (quantidade de conteúdo, publicações agendadas, insights)
2. plan_content_week — gere um plano de conteúdo com base em insights e tendências
3. generate_video / generate_image — crie ativos de mídia a partir do plano
4. check_status — consulte trabalhos assíncronos até que os ativos estejam prontos
5. schedule_post — distribua conteúdo para plataformas conectadas
6. (aguarde a coleta de análises) — os dados da plataforma são obtidos automaticamente
7. refresh_platform_analytics — acione uma atualização manual de análises
8. get_performance_insights — leia o que funcionou e o que não funcionou
9. Volte ao passo 1 com novos insights

Cada iteração produz conteúdo mais inteligente à medida que os dados de desempenho alimentam a etapa de planejamento.

Segurança

• Todas as chaves de API são submetidas a hash antes do armazenamento — nunca armazenamos chaves em texto simples
• Credenciais armazenadas no chaveiro do seu sistema operacional (macOS Keychain, Linux secret-tool) ou em variável de ambiente
• Proteção SSRF em todos os parâmetros de URL com prevenção de rebinding de DNS
• Limitação de taxa por usuário com limites por ferramenta para operações caras
• A detecção de loop de agente evita automação descontrolada
• Defina DO_NOT_TRACK=1 para desativar a telemetria anônima de uso

Consulte SECURITY.md para nossa política de divulgação de vulnerabilidades e detalhes de segurança de credenciais.

Telemetria

Este pacote coleta métricas operacionais de uso (nome da ferramenta, duração, sucesso/falha) para melhorar a confiabilidade. Ele não envia entradas de ferramentas, saídas, conteúdo gerado, chaves de API, e-mails ou corpos de erro upstream. Quando uma implantação configura POSTHOG_PSEUDONYMIZATION_KEY, o identificador do usuário é pseudonimizado por HMAC; caso contrário, uma chave efêmera por processo impede correlação estável entre sessões.

Para desativar: Defina DO_NOT_TRACK=1 ou SOCIALNEURON_NO_TELEMETRY=1 no seu ambiente.

Nenhum conteúdo pessoal, chave de API ou payload de solicitação é coletado.

Exemplos

Consulte o repositório de exemplos para modelos de fluxo de trabalho orientados por prompts:

• Planejamento semanal de lote de conteúdo
• Reaproveitamento de conteúdo multiplataforma
• Revisão de desempenho e loops de otimização
• Geração de conteúdo alinhado à marca
• Automação de engajamento em comentários

Links

• Social Neuron
• Para Desenvolvedores
• Documentação
• Exemplos
• Protocolo de Agente
• Configurações de Desenvolvedor
• Preços

Licença

MIT - consulte LICENSE