Planoly MCP

Servidor MCP Planoly

Conecte assistentes de IA ao Planoly — planeje, crie, agende e analise conteúdo de mídia social no Instagram, TikTok, YouTube, Pinterest, Facebook e muito mais, diretamente do Claude, Cursor ou qualquer cliente MCP.

Este é um servidor MCP remoto, hospedado pela Planoly:

https://mcp.planoly.com/mcp

Não há nada para instalar ou executar — você conecta seu cliente MCP à URL acima e faz login com sua conta Planoly via OAuth. Este repositório hospeda a documentação pública e os metadados de registro do servidor.

O que você pode fazer

• Criar e agendar posts em todos os seus canais conectados em uma única chamada — legenda/mídia compartilhada com substituições por plataforma, tags e colaboradores do Instagram, sons e configurações de privacidade do TikTok, visibilidade do YouTube, quadros do Pinterest e muito mais.
• Gerenciar seu calendário de conteúdo — listar rascunhos e posts agendados, editar legendas e configurações, reagendar (incluindo slots de Melhor Horário do Instagram) ou excluir.
• Trabalhar com sua biblioteca de mídia — navegar, pesquisar, organizar em pastas, visualizar mídia, importar de URLs ou enviar novos ativos.
• Analisar desempenho — análises de conta do Instagram, desempenho por post classificado pela métrica que você mais importa, pesquisa de contas públicas via Business Discovery e links de relatórios compartilháveis.
• Descobrir tendências — navegar pelos sons em alta da Biblioteca de Música Comercial do TikTok e anexá-los aos posts.

Consulte docs/examples.md para exemplos de prompts e fluxos de trabalho.

Primeiros passos

Claude Code

claude mcp add --transport http planoly https://mcp.planoly.com/mcp

Claude (claude.ai e Claude Desktop)

Vá para Configurações → Conectores → Adicionar conector personalizado e insira:

https://mcp.planoly.com/mcp

Cursor

Adicione a ~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto):

{
  "mcpServers": {
    "planoly": {
      "url": "https://mcp.planoly.com/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"planoly","type":"http","url":"https://mcp.planoly.com/mcp"}'

Outros clientes (somente stdio)

Para clientes que suportam apenas servidores stdio locais, faça a ponte com mcp-remote:

{
  "mcpServers": {
    "planoly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.planoly.com/mcp"]
    }
  }
}

No primeiro uso, seu cliente abre uma janela do navegador para você entrar no Planoly e aprovar o acesso. Se o estado de autenticação da ponte travar, limpe-o com rm -rf ~/.mcp-auth e reconecte.

Autenticação

O servidor usa o fluxo de autorização padrão do MCP — código de autorização OAuth 2.1 com tokens de atualização, descoberto automaticamente pelo cliente:

• Metadados de recurso protegido: https://mcp.planoly.com/.well-known/oauth-protected-resource/mcp
• Servidor de autorização: https://app.planoly.com/api/auth
• Escopos: openid, profile, email, offline_access

Os tokens são limitados ao seu usuário Planoly. As ferramentas que operam em um workspace recebem um workspaceId e aplicam a associação ao workspace em cada chamada — comece com list_workspaces para ver o que você pode acessar.

Detalhes completos em docs/authentication.md.

Ferramentas

Resumidas abaixo; detalhes em nível de parâmetro estão em docs/tools.md.

Workspaces e canais

Ferramenta	Descrição
list_workspaces	Lista os workspaces que sua conta pode acessar.
list_channels	Lista os canais sociais conectados de um workspace e seu estado de conexão, para que o agente saiba onde pode publicar.

Posts e agendamento

Ferramenta	Descrição
create_post	Cria um grupo de posts em um ou mais canais. Os alvos compartilham um conjunto de legenda/mídia ou substituem por plataforma, com configurações específicas para Instagram (tags, capa, colaboradores, primeiro comentário, som), TikTok (título, privacidade, conteúdo de marca, música), YouTube (título, visibilidade), Pinterest (quadro, título, link), Facebook e Amazon. Opcionalmente, agenda o grupo inteiro.
list_post_groups	Lista posts existentes (rascunhos, agendados, publicados) com legendas, datas de agendamento, mídia (incluindo IDs de ativos reutilizáveis) e miniaturas.
update_post	Edita um post existente — legenda, mídia, primeiro comentário e configurações por plataforma.
set_post_group_schedule	Agenda um rascunho, reagenda, agenda no próximo slot de Melhor Horário do Instagram ou reverte para rascunho. Posts com publicação automática são validados contra as regras da plataforma antes do agendamento.
delete_post_group	Exclui um grupo de posts em rascunho ou agendado.

Biblioteca de mídia e ativos

Ferramenta	Descrição
list_media_library	Navega e pesquisa na biblioteca de mídia — fotos, vídeos, carrosséis, notas, marcadores de URL e pastas.
get_media_preview	Retorna uma imagem em miniatura inline para um ativo, para que qualquer cliente MCP possa ver o conteúdo de uma foto ou vídeo.
create_media_library_folder	Cria uma pasta (opcionalmente aninhada) para organizar itens da biblioteca.
create_media_library_item	Salva mídia, uma nota ou um marcador de URL na biblioteca.
update_media_library_item	Edita o nome, título, descrição, link ou conjunto de mídia de uma entrada da biblioteca.
delete_media_library_item	Remove uma entrada da biblioteca (pastas em cascata; ativos subjacentes e posts não são afetados).
create_asset_from_url	Importa uma imagem/vídeo de uma URL na lista de permissões de hosts suportados (CDNs do Instagram/Facebook, Planoly, exportações do Canva e saídas de IA generativa suportadas).
request_asset_upload / confirm_asset_upload	Fluxo de upload com URL assinada para clientes que podem executar um HTTP PUT (por exemplo, um sandbox de execução de código).

Análises e pesquisa

Ferramenta	Descrição
get_instagram_analytics	Análises de conta Business do Instagram para um intervalo de datas — crescimento de seguidores, alcance, visualizações, interações, divisão de público e uma série diária.
list_post_performance	Desempenho de posts publicados no Instagram — alcance, visualizações, curtidas, comentários, compartilhamentos, salvamentos — classificado por uma métrica escolhida.
get_instagram_account_posts	Busca os posts recentes de uma conta pública Business/Criador do Instagram (legendas, mídia, engajamento público) para pesquisa e resumos.
create_post_report_share_link	Gera um link compartilhável e somente leitura para o relatório de desempenho de posts do workspace (expira em 14 dias).

Marcação no Instagram e sons do TikTok

Ferramenta	Descrição
search_instagram_locations	Pesquisa lugares para marcar em posts do Instagram.
search_instagram_products	Pesquisa o catálogo de uma loja conectada do Instagram para marcação de produtos.
list_tiktok_trending_sounds	Navega pelos sons em alta da Biblioteca de Música Comercial do TikTok por gênero, país e intervalo de datas.

Como a mídia chega aos posts

O modelo nunca carrega bytes de mídia durante a inferência. A mídia chega a um post por assetId, de uma de três fontes:

1. Mídia existente — pegue um assetId de list_media_library ou de outro post via list_post_groups.
2. De uma URL — create_asset_from_url faz o servidor buscar (somente hosts na lista de permissões).
3. Bytes locais — request_asset_upload → HTTP PUT os bytes → confirm_asset_upload, para clientes com um sandbox de execução de código.

Detalhes e restrições em docs/media.md.

Validação e requisitos de plano

Os posts são validados contra as regras de cada plataforma (tamanho da legenda, quantidade/tipo de mídia, proporção de aspecto, duração do vídeo) da mesma forma que o aplicativo Planoly valida — os erros retornam no momento da chamada da ferramenta com a violação exata, não no momento da publicação.

Algumas ferramentas correspondem a recursos premium do Planoly e exigem um workspace pago: sons em alta do TikTok, ferramentas da biblioteca de mídia, ferramentas de análise e marcação de produtos. Quando uma ferramenta exige upgrade, o erro inclui um link para a página de cobrança.

Documentação

• Referência de ferramentas — cada ferramenta, seus parâmetros e comportamento
• Autenticação — o fluxo OAuth, modelo de token, redefinição do estado de autenticação
• Manipulação de mídia — como os ativos entram e saem
• Exemplos de prompts — fluxos de trabalho para experimentar
• Solução de problemas — erros comuns e correções
• Changelog

Suporte e segurança

• Ajuda com produto e conta: Central de ajuda do Planoly · veja SUPPORT.md
• Bugs do servidor MCP e solicitações de recursos: issues
• Vulnerabilidades: relate em privado conforme SECURITY.md

A implementação do servidor não é open source; este repositório acompanha a documentação pública e os metadados do registro MCP (server.json) para o serviço hospedado.