Swonkie

🆕 Servidor MCP

O que é MCP?

Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA e ferramentas de automação chamem serviços externos como ferramentas nativas — sem copiar e colar, sem integrações personalizadas. Quando você conecta o Swonkie via MCP, seu agente de IA pode consultar suas análises, gerenciar posts, mover conteúdo por fluxos de aprovação e publicar — tudo a partir de uma conversa natural ou fluxo de trabalho automatizado.

O servidor MCP do Swonkie usa o transporte Streamable HTTP, o que significa que ele funciona em ferramentas de IA hospedadas na nuvem (Claude.ai, ChatGPT) e clientes locais (Claude Desktop, n8n) sem executar nenhum processo local.

---

O Que Você Pode Fazer

Uma vez conectado, um agente de IA pode:

• Listar seus perfis sociais conectados e perfis de concorrentes
• Obter análises diárias e insights por post para qualquer perfil ou concorrente
• Criar, atualizar e excluir posts (com legendas por rede, mídia e opções específicas da plataforma)
• Agendar posts, enviá-los para revisão da equipe, aprovar ou rejeitar
• Gerenciar sua biblioteca de mídia (enviar e referenciar imagens/vídeos em posts)
• Criar e listar etiquetas para organização de conteúdo

---

Pré-requisitos

• Um workspace Swonkie com acesso à API habilitado
• Um cliente de API criado em Configurações → Workspace → API
• Uma chave de API visível — as chaves são mostradas apenas imediatamente após a criação ou após uma rotação. Se sua chave estiver oculta, gire-a para revelar uma nova.

---

URL do Seu Servidor MCP

https://mcp.swonkie.dev/mcp?apiId=YOUR_APP_ID&apiKey=YOUR_API_KEY

Você tem duas URLs — uma por slot de chave (Primária e Secundária). Use URLs diferentes para clientes diferentes para que você possa girar uma independentemente sem quebrar a outra.

Segurança: Trate a URL do MCP como uma senha. Ela contém sua chave de API ativa embutida na URL. Não a compartilhe publicamente nem a envie para o controle de versão. Adicionaremos suporte a OAuth em breve.

Encontre seu ID de aplicativo e chaves em Configurações → Workspace → API. A URL do MCP é exibida automaticamente assim que seu cliente de API é configurado.

---

Ferramentas Disponíveis

O servidor MCP do Swonkie expõe 17 ferramentas organizadas em cinco grupos.

Perfis

Ferramenta	O que faz
swonkie_profiles_list	Lista seus perfis sociais conectados. Suporta paginação (skip, take até 20), busca por texto e filtragem por rede. Os IDs de perfil desta ferramenta são necessários para as ferramentas de análise e posts.
swonkie_competitors_list	Lista perfis de concorrentes monitorados. Mesmos parâmetros de swonkie_profiles_list. Os IDs de concorrentes alimentam as ferramentas de análise de concorrentes.

Análises

Ferramenta	O que faz
swonkie_profile_insights_daily	Retorna métricas diárias agregadas para um dos seus perfis conectados em um intervalo de datas. Requer profileId, since (ISO 8601), until (ISO 8601) e metrics[].
swonkie_profile_insights_posts	Retorna métricas por post para um dos seus perfis conectados em um intervalo de datas. Mesmos parâmetros dos insights diários.
swonkie_competitor_insights_daily	Retorna métricas diárias agregadas para um concorrente monitorado. Requer um profileId de concorrente de swonkie_competitors_list.
swonkie_competitor_insights_posts	Retorna métricas por post para um concorrente monitorado. Mesmos parâmetros dos insights diários de concorrentes.

Os nomes de métricas disponíveis dependem do seu plano e da rede conectada. Consulte docs.swonkie.dev para a lista completa.

Posts

Ferramenta	O que faz
swonkie_posts_list	Lista posts no seu workspace com filtros opcionais: intervalo de datas, estágios do fluxo de trabalho, tipos de post, IDs de perfil, IDs de etiqueta e busca por texto livre.
swonkie_posts_get	Carrega um único post por ID. Retorna o payload completo do post.
swonkie_posts_create	Cria um post. Requer type e profileIds[]. Suporta legendas por rede, anexos de mídia, pré-visualizações de link, horário de publicação agendado, opções específicas da plataforma (carrosséis do Facebook, sinalizações do TikTok, etc.), briefings e etiquetas.
swonkie_posts_update	Atualiza um post existente. Mesmo esquema da criação — esta é uma substituição completa, não um patch parcial. Requer postId, type e profileIds[].
swonkie_posts_delete	Exclui permanentemente um post por ID.
swonkie_posts_validate	Executa regras de validação de publicação em um post e retorna se ele está pronto para ir ao ar, junto com quaisquer mensagens de validação.
swonkie_posts_stage_change	Move um post pelo fluxo de trabalho de aprovação. Consulte Estágios do Fluxo de Trabalho abaixo.

Tipos de post: STATUS, MEDIA, STORY, LINK, REEL

Etiquetas

Ferramenta	O que faz
swonkie_labels_list	Lista etiquetas do workspace. Paginado. Use IDs de etiqueta ao criar ou filtrar posts.
swonkie_labels_create	Cria uma nova etiqueta. O nome deve ter de 1 a 50 caracteres.

Mídia

Ferramenta	O que faz
swonkie_media_get	Retorna metadados de um item de mídia enviado por ID.
swonkie_media_create	Inicia um envio de mídia — cria uma entrada na biblioteca de mídia e retorna detalhes do envio. Siga com swonkie_media_upload_confirm após o arquivo ser enviado. destinationType é POST_MEDIA ou POST_LINK.
swonkie_media_upload_confirm	Finaliza o processamento após um arquivo ser enviado ao backend de armazenamento.
swonkie_media_delete	Remove um item de mídia da biblioteca.

---

Estágios do Fluxo de Trabalho

Use swonkie_posts_stage_change para mover um post pelo pipeline de aprovação de conteúdo.

Estágio	O que faz
publishNow	Publica o post imediatamente
schedule	Agenda o post para o horário de publishAt
unschedule	Remove o horário agendado e retorna o post para rascunho
teamReview	Envia o post para a fila de revisão da equipe
approve	Aprova o post (a partir de um estado de revisão)
reject	Rejeita o post (a partir de um estado de revisão)

---

Redes Suportadas

Os seguintes códigos de rede são aceitos em filtros de perfil, profileIds de post e slots de legenda/mídia por rede:

Código	Rede
facebook	Facebook
instagram / instagram_v2	Instagram
meta_ads	Meta Ads
linkedin	LinkedIn
youtube	YouTube
pinterest	Pinterest
google_my_business	Google Business Profile
tiktok	TikTok
threads	Threads
twitter	X (Twitter)
tumblr	Tumblr
blogger	Blogger
wordpress / wordpressorg	WordPress

---

Conexão Rápida

Claude.ai (web)

1. Vá para Conectores do Claude.ai
2. Clique em + → Adicionar conector personalizado
3. Digite um nome, ex.: Swonkie
4. Cole a URL do seu servidor MCP e clique em Adicionar

---

Claude Desktop (UI)

1. Abra o Claude Desktop → Personalizar → Conectores (ou use o link profundo claude://settings/connectors)
2. Clique em + → Adicionar conector personalizado
3. Digite um nome, ex.: Swonkie
4. Cole a URL do seu servidor MCP e clique em Adicionar

---

Claude Desktop (arquivo de configuração)

1. Certifique-se de que o Claude Desktop esteja atualizado: Menu Claude → Verificar atualizações...
2. Abra Configurações → Desenvolvedor → Editar configuração (ou use claude://settings/developer)
3. Adicione o seguinte ao seu arquivo de configuração:

{
  "mcpServers": {
    "swonkie": {
      "type": "http",
      "url": "https://mcp.swonkie.dev/mcp?apiId=YOUR_APP_ID&apiKey=YOUR_API_KEY"
    }
  }
}

4. Salve o arquivo e reinicie o Claude Desktop

---

ChatGPT

1. Vá para Configurações → Aplicativos → Avançado e habilite o Modo Desenvolvedor (ou abra diretamente)
2. Vá para Conectores e clique em Criar aplicativo (ou abra diretamente)
3. Digite um nome, ex.: Swonkie
4. Cole a URL do seu servidor MCP como a URL do conector

---

n8n

1. Abra seu fluxo de trabalho e adicione um nó MCP Client (documentação MCP do n8n)
2. Defina o transporte como Streamable HTTP
3. Cole a seguinte configuração nas configurações do nó:

{
  "transport": "streamable-http",
  "url": "https://mcp.swonkie.dev/mcp?apiId=YOUR_APP_ID&apiKey=YOUR_API_KEY"
}

---

Outros clientes MCP

1. Abra ou crie seu arquivo de configuração MCP (ex.: .mcp.json, mcp.json ou o equivalente do seu cliente)
2. Adicione a seguinte entrada à seção mcpServers:

{
  "mcpServers": {
    "swonkie": {
      "type": "http",
      "url": "https://mcp.swonkie.dev/mcp?apiId=YOUR_APP_ID&apiKey=YOUR_API_KEY"
    }
  }
}

3. Salve o arquivo e reinicie seu cliente

---

Melhores Práticas de Segurança

• Use chaves separadas por cliente. Atribua a URL Primária a uma ferramenta e a URL Secundária a outra. Se uma for comprometida, você pode girá-la sem afetar a outra.
• Gire se exposta. Vá para Configurações → Workspace → API e gire a chave afetada. A nova chave se torna válida imediatamente; a antiga é invalidada.
• Nunca compartilhe URLs MCP publicamente. A URL contém sua chave de API ativa. Não a publique em repositórios públicos, canais do Slack ou tickets de suporte.
• Revogue girando. Não há ação separada de revogação — girar uma chave é a forma de invalidar uma URL.