Pular para o conteúdo principal

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto para conectar ferramentas de IA a serviços externos. O servidor MCP do Social media studio permite que agentes de IA criem, agendem e gerenciem publicações de redes sociais diretamente.

Detalhes da conexão

Conectores personalizados (Cursor, conector personalizado do Claude com uma chave colada) podem continuar usando X-API-Key. As listagens em marketplaces usam OAuth: a listagem no Claude Connectors Directory usa a URL do diretório do Claude (veja abaixo), e os outros marketplaces usam a URL de diretório, que exclui as ferramentas de imagem/vídeo com IA.
A URL MCP de diretório filtra as ferramentas de geração de imagem e vídeo com IA (política do diretório do Claude). As ferramentas de IA para legendas/texto e de agendamento continuam disponíveis. O catálogo completo fica em /mcp.

Claude directory connector

O Social media studio (da So-me Studio) tem um endpoint próprio para o Claude. A listagem no Claude Connectors Directory e o plugin do Social media studio para o Claude usam esse endpoint, e você pode adicioná-lo hoje como conector personalizado por URL (Customize > Connectors > Add custom connector). Ele dá ao Claude as mesmas 28 ferramentas de publicação dos plugins do ChatGPT e do Grok. O conector cobre:
  • Publicação e agendamento — criar, atualizar, agendar, cancelar o agendamento, tentar novamente e excluir publicações, além de ler o calendário
  • Rascunhos — criar, editar, excluir e converter rascunhos em publicações
  • Biblioteca de mídia e upload — navegar, pesquisar e enviar imagens e vídeos
  • Verificações de mídia — conferir os arquivos com as regras de mídia de cada plataforma antes de publicar
  • Opções da publicação — encadeamentos (threads), um primeiro comentário e configurações de privacidade e interação do TikTok
  • Destinos — contas conectadas, quadros do Pinterest e canais do Discord e do Slack
Ele não cobre análises, caixa de entrada, faturamento, administração de contas nem geração de imagem e vídeo com IA. Publicações no Reddit e no Google Business Profile não são compatíveis nesta versão.
O caminho para desenvolvedores não muda: use https://api.so-me.studio/mcp com o cabeçalho X-API-Key para o catálogo completo de ferramentas.

OAuth (clientes de diretório)

O Social media studio é compatível com MCP OAuth 2.1 com PKCE (S256), metadados de recurso protegido e registro dinâmico de clientes / metadados do servidor de autorização compatíveis com CIMD. O guia Auth.md, legível por agentes, descreve o fluxo PKCE completo de cliente público. A URL dele e o método user_authorization compatível também são publicados no bloco agent_auth dos metadados do OAuth. As ferramentas de escrita continuam condicionadas ao plano (acesso à API Standard, Advanced ou Lifetime), tanto em sessões com chave de API quanto com OAuth.

Ferramentas disponíveis

Depois de conectado, seu agente de IA pode chamar 205 ferramentas, agrupadas abaixo por área. Cada ferramenta consome um pequeno número de créditos MCP por chamada (1 = leitura, 2 = escrita/alteração, 3 = análises, 5 = texto com IA, 8 = imagem com IA, 10 = ações compostas com IA). Use list_mcp_tools para obter a lista atualizada com o custo em créditos de cada ferramenta e get_mcp_usage para ver seus créditos MCP restantes.
Essas ferramentas resolvem destinos de publicação específicos de cada plataforma (quadros, subreddits, canais, locais) para que você escolha um destino antes de criar uma publicação.

Plataformas compatíveis

O enum socialMedia / platform usado pelas ferramentas de publicação e de conteúdo com IA (create_post, create_draft, generate_caption, generate_and_schedule, generate_hook_suggestions etc.) aceita estes valores:
As ferramentas de análises e de auxílio de integração cobrem mais destinos do que o enum de publicações acima — incluindo Bluesky, Mastodon, Reddit, Google Business Profile (GMB), Discord, Slack e Telegram. Use list_accounts para descobrir todas as contas conectadas e o accountId de cada uma e passe esse ID para as ferramentas de análises ou de auxílio de integração específicas da plataforma.

Tipos de publicação

O parâmetro postType de create_post, update_post, create_draft e update_draft aceita: TEXT, IMAGE, MULTIPLE_IMAGES, VIDEO, CAROUSEL, REEL, STORY (padrão: TEXT).

Status das publicações

O filtro status de list_posts aceita: POSTED, SCHEDULED, PENDING, FAILED, PENDING_APPROVAL, REJECTED.

Exemplos de requisições

O servidor MCP fala JSON-RPC 2.0 sobre Streamable HTTP. A maioria dos agentes cuida disso por você, mas é possível chamá-lo diretamente com curl.

Guias de configuração

Escolha seu agente de IA para começar:

Claude Code

Ferramenta de programação com agentes da Anthropic

Claude Desktop

Aplicativo para desktop da Anthropic

Cursor

Editor de código com IA em primeiro lugar

OpenAI Codex

Agente de programação da OpenAI

Windsurf

IDE com IA da Codeium

VS Code (Copilot)

Modo agente do GitHub Copilot

Gemini CLI

Agente de terminal com IA do Google

Solução de problemas

Confira se a sua chave de API está correta e ativa. O cabeçalho deve ser exatamente X-API-Key (diferencia maiúsculas de minúsculas). Gere uma nova chave em Configurações > API se necessário.
O servidor MCP do Social media studio roda em modo sem estado usando Streamable HTTP. Somente requisições POST são aceitas. Confira se o seu agente está configurado com transporte HTTP, e não SSE.
As chamadas de ferramentas MCP têm limite por minuto conforme o plano. Confira seu uso em Configurações > MCP / ferramentas de IA e faça upgrade se precisar.
Cada chamada de ferramenta MCP consome créditos. Confira os créditos restantes em Configurações > MCP / ferramentas de IA.
Aumente o tempo limite na sua configuração do MCP. Recomenda-se um valor de 30000 ms (30 segundos).