Este guia te mostra como conectar o servidor MCP da Socialinsider ao Claude e ao ChatGPT, assim você pode trazer Analytics da Socialinsider em tempo real para tuas conversas com IA, sem instalar nada localmente.
✅ O que você vai precisar:
Uma conta ativa da Socialinsider (disponível em todos os planos)
O servidor MCP da Socialinsider já está funcionando aqui:
💡 Funciona com qualquer ferramenta compatível com MCP - O MCP da Socialinsider funciona com Claude, ChatGPT e qualquer outro assistente ou ferramenta de IA que suporte o Model Context Protocol. Se tua ferramenta suporta MCP, só precisa colar a URL do servidor acima e seguir o mesmo fluxo OAuth.
Quando você inserir essa URL em um cliente compatível, será solicitado para entrar via fluxo seguro OAuth 2.0. Não precisa de chaves de API, tokens ou variáveis de ambiente.
Como funciona a autenticação
Na primeira vez que você usar a Socialinsider dentro do seu assistente de IA, o app vai:
Abrir uma janela de login da Socialinsider no seu navegador
Pedir para você aprovar o acesso
Retornar você ao app com a conexão pronta
Se você ficar preso em um loop de login, pule para Solução de Problemas.
Conectar ao Claude
Opção 1 - Web
Essa é a opção mais fácil.
Abre claude.ai
Clica em Customize (na barra de navegação)
3. Vai para 'Connectors'
4. Clica no ícone de 'mais' - 'add custom connector'
5. Cola a URL: https://mcp.socialinsider.io/mcp
6. Clica em 'Connect'
7. Entra na tua conta Socialinsider na janela do navegador que abrir, depois aprova o acesso. Vais ser redirecionado para o Claude automaticamente quando conectar.
8. Vê se o Socialinsider aparece agora na seção 'Connectors'
Agora podes começar uma nova conversa e testar 👇
"Mostra a taxa de engajamento do nosso perfil do Instagram no projeto 'Automotive' dos últimos 30 dias."
Opção 2 - Claude Desktop
O Claude Desktop suporta servidores MCP remotos.
Encontra teu arquivo de configuração:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\\\\Claude\\\\claude_desktop_config.json
2. Adiciona este bloco (cria o arquivo se não existir):
{
"mcpServers": {
"socialinsider": {
"type": "http",
"url": "https://mcp.socialinsider.io/mcp"
}
}
}
3. Salva o arquivo e reinicia o Claude Desktop
4. No primeiro uso, completa o login OAuth do Socialinsider na janela do navegador
Verifica a conexão (opcional): se o Claude Desktop mostrar as ferramentas do Socialinsider, está pronto.
💡Observação: Se as ferramentas não aparecerem, garante que estás numa versão recente do Claude Desktop (confere as notas de versão).
Opção 3 - Claude Code (CLI)
Se usares o Claude Code no terminal:
claude mcp add socialinsider https://mcp.socialinsider.io/mcp
No primeiro uso, o Claude Code abre uma janela do navegador para fazer o login OAuth. Depois de autorizar, as ferramentas estarão disponíveis nesse projeto.
Para verificar a conexão:
claude mcp list
Conecta ao ChatGPT
1. Abre o ChatGPT. Usar o navegador funciona muito bem. Não precisas do app para macOS/Windows.
2. Vai até as configurações da tua conta no pequeno ícone no canto esquerdo (em baixo).
3. Vai até Apps
4. Clica em 'Configurações avançadas'
5. Garante que 'Modo desenvolvedor' está ativado
6. Clica em 'Criar app'
7. Preenche os campos assim:
Nome: Socialinsider
Descrição: ferramenta de Social Media Analytics
Conexão:
https://mcp.socialinsider.io/mcp
Marca a última caixa e clica em ‘Criar’.
A partir daí, vai ser solicitado que conectes à tua conta Socialinsider. Usa as tuas credenciais de login para isso.
Depois disso, vais ver o Socialinsider na tua seção de Apps.
Para verificar a conexão, inicia um novo chat e clica no ícone ‘+’ → Mais. Deves ver o Socialinsider listado como conectado ao ChatGPT. Podes clicar nele.
Depois, começa a conversar e faz perguntas sobre os teus projetos no Socialinsider.
Exemplos de prompts
Usa linguagem natural – inclui apenas o projeto, o perfil e o período.
👉 Análise competitiva
"Compara a Engagement Rate de @netflix e @disneyplus no Instagram para o 1º trimestre de 2025 e diz qual gerou mais interações por post."
👉 Auditoria do teu perfil
"Obtém as análises dos últimos 30 dias do perfil da nossa página do Facebook no projeto ‘Acme Corp’ e resume a tendência de crescimento de seguidores."
👉 Conteúdo de destaque
"Busca os últimos 50 posts do nosso Instagram no projeto ‘Brand’ para março de 2025 e classifica-os pela Engagement Rate."
👉 Benchmark multiplataforma
"Compara a média de views por vídeo dos canais do YouTube no projeto ‘Competitors’ nos últimos 90 dias."
👉 Performance da campanha
"Mostra os posts marcados com a campanha 'Summer24' no projeto 'Marketing' para Instagram entre junho e agosto de 2024."
Ferramentas disponíveis
Após a conexão, teu assistente pode usar estas ferramentas do Socialinsider:
Ferramenta | O que faz |
| Lista perfis monitorados (opcionalmente filtrados por projeto) |
| Procura um perfil por URL ou usuário |
| Começa a monitorar um novo perfil (próprio ou concorrente) |
| Remove um perfil monitorado e seus dados históricos |
| Busca posts com métricas individuais (suporta paginação + campanhas) |
| Retorna Analytics diários (followers, engagement, reach, impressions) |
| Busca Stories do Instagram (somente contas comerciais próprias/autorizadas) |
| Lista grupos de marcas dentro de um projeto |
| Lista as tags de campanha disponíveis em um projeto |
Resolução de problemas
"Não autorizado" ou solicitações de login repetidas
Conclua o fluxo OAuth na janela do navegador que abrir (não feche antes de terminar)
Remove o servidor e adicione de novo para iniciar um novo login
Confere se o URL é exatamente: https://mcp.socialinsider.io/mcp
Erros de limite de taxa (429)
A mensagem de erro mostra quanto tempo esperar antes de tentar de novo
Reduz o intervalo de datas ou o número de perfis no teu pedido
Resposta truncada
Se a resposta for muito longa, usa paginação (from/size) para buscar em lotes menores
“Fuso horário inválido”
Usa um formato de fuso horário IANA, como UTC, America/New_York, Europe/London, Asia/Tokyo
Lista completa: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones