> ## Documentation Index > Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt > Use this file to discover all available pages before exploring further. # Servidor MCP de redes sociais para agentes de IA > Deixe o Claude, o Cursor, o Codex ou qualquer cliente MCP agendar publicações, responder mensagens e ler análises pelo servidor MCP remoto do Social media studio. ## O que é MCP? O [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) é 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 | Propriedade | Valor | | - | - | | **Endpoint completo** (Cursor / personalizado) | `https://api.so-me.studio/mcp` | | **Endpoint de diretório** (marketplaces, sem ferramentas de imagem/vídeo com IA) | `https://api.so-me.studio/mcp/directory` | | **Endpoint do diretório do Claude** (Claude Connectors Directory) | `https://api.so-me.studio/mcp/claude` | | **Transporte** | Streamable HTTP (somente POST) | | **Autenticação** | Cabeçalho `X-API-Key` **ou** OAuth 2.1 (PKCE) | | **Modo** | Sem estado (sem sessões) | > [!NOTE] > > 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. > [!NOTE] > > 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. | Propriedade | Valor | | - | - | | **URL** | `https://api.so-me.studio/mcp/claude` | | **Login** | OAuth 2.1 com PKCE. O Claude abre a página de login do Social media studio; nenhuma chave de API é necessária. | | **Espaço de trabalho** | O espaço de trabalho que você aprova na página de consentimento. Seu plano, suas permissões e seus limites de uso se aplicam. | 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. > [!NOTE] > > 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](https://so-me.studio/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. | Endpoint | Finalidade | | - | - | | `GET /.well-known/oauth-protected-resource/mcp/directory` | Metadados do recurso protegido do MCP de diretório | | `GET /.well-known/oauth-protected-resource/mcp/claude` | Metadados do recurso protegido do MCP do diretório do Claude | | `GET /.well-known/oauth-authorization-server` | Descoberta do servidor de autorização (PKCE S256) | | `GET /oauth/authorize` | Autorização + consentimento | | `POST /oauth/token` | Troca / renovação de token | | `POST /oauth/register` | Registro dinâmico de cliente (alternativa) | 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. > **Publicações (11 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_posts` | Lista publicações agendadas/publicadas com filtro por status e plataforma | > | `get_post` | Obtém uma publicação pelo ID | > | `create_post` | Cria uma nova publicação para qualquer plataforma conectada | > | `update_post` | Atualiza o conteúdo ou o agendamento de uma publicação existente | > | `schedule_post` | Agenda uma publicação existente para publicação futura | > | `unschedule_post` | Remove uma publicação do agendamento (volta para pendente) | > | `delete_post` | Exclui uma publicação | > | `retry_post` | Tenta novamente uma publicação com falha (muda o status de FAILED para PENDING) | > | `resubmit_post` | Reenvia para aprovação uma publicação rejeitada | > | `bulk_delete_posts` | Exclui várias publicações de uma vez | > | `get_calendar_posts` | Obtém as publicações de um intervalo de datas (visão de calendário) | > **Comentários da publicação (5 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_post_comments` | Lista os comentários de uma publicação | > | `add_post_comment` | Adiciona um comentário a uma publicação | > | `update_post_comment` | Atualiza um comentário existente de uma publicação | > | `delete_post_comment` | Exclui um comentário de uma publicação | > | `mark_comments_as_read` | Marca todos os comentários de uma publicação como lidos | > **Rascunhos (6 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_drafts` | Lista os rascunhos do seu espaço de trabalho | > | `get_draft` | Obtém um rascunho pelo ID | > | `create_draft` | Cria um novo rascunho | > | `update_draft` | Atualiza um rascunho existente | > | `delete_draft` | Exclui um rascunho | > | `convert_draft` | Converte um rascunho em publicação agendada | > **Contas (3 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_accounts` | Lista as contas de redes sociais conectadas | > | `get_account` | Obtém os detalhes de uma conta social conectada | > | `disconnect_account` | Desconecta (remove) uma conta social conectada | > **Mídia (13 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_media` | Lista os arquivos de mídia da sua biblioteca | > | `search_media` | Pesquisa arquivos de mídia pelo nome | > | `get_media_file` | Obtém um arquivo de mídia pelo ID | > | `delete_media` | Exclui um arquivo de mídia da biblioteca | > | `bulk_delete_media` | Exclui vários arquivos de mídia de uma vez | > | `list_media_folders` | Lista as pastas de mídia da biblioteca | > | `create_media_folder` | Cria uma nova pasta de mídia | > | `delete_media_folder` | Exclui uma pasta de mídia (e o conteúdo dela) | > | `move_media_file` | Move um arquivo de mídia para outra pasta ou para a raiz | > | `move_media_folder` | Move uma pasta para outra pasta pai ou para a raiz | > | `rename_media_file` | Renomeia um arquivo de mídia | > | `rename_media_folder` | Renomeia uma pasta de mídia | > | `presign_media_upload` | Gera URLs PUT pré-assinadas do S3 para enviar arquivos à biblioteca | > **Caixa de entrada (18 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_conversations` | Lista as conversas da caixa de entrada de todas as plataformas conectadas | > | `get_messages` | Obtém as mensagens de uma conversa | > | `reply_to_conversation` | Envia uma resposta em uma conversa | > | `update_conversation` | Atualiza o status da conversa (marcar como lida/vista, resolvida etc.) | > | `delete_conversation` | Exclui uma conversa | > | `list_saved_replies` | Lista os modelos de respostas salvas | > | `get_saved_reply` | Obtém uma resposta salva pelo ID | > | `create_saved_reply` | Cria um novo modelo de resposta salva | > | `update_saved_reply` | Atualiza uma resposta salva existente | > | `delete_saved_reply` | Exclui uma resposta salva | > | `subscribe_inbox` | Ativa a sincronização da caixa de entrada para uma conta social conectada | > | `unsubscribe_inbox` | Desativa a sincronização da caixa de entrada para uma conta social conectada | > | `edit_inbox_message` | Edita um comentário/mensagem na caixa de entrada social (Facebook/Instagram) | > | `delete_inbox_message` | Exclui um comentário/mensagem na caixa de entrada social (Facebook/Instagram) | > | `hide_inbox_message` | Oculta ou reexibe um comentário na caixa de entrada social (Facebook/Instagram) | > | `preview_bulk_reply` | Mostra uma prévia dos destinatários de uma resposta em massa antes do envio | > | `create_bulk_reply` | Envia uma resposta (com personalização opcional `{{name}}`) para muitas conversas de DM | > | `get_bulk_reply_batch` | Obtém o status e os resultados de um lote de respostas em massa | > **Aprovações (4 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_approvals` | Lista as publicações aguardando aprovação | > | `approve_post` | Aprova uma publicação que aguarda aprovação | > | `reject_post` | Rejeita uma publicação que aguarda aprovação (comentário de rejeição obrigatório) | > | `update_review_comment` | Atualiza o comentário de revisão/rejeição de uma publicação no fluxo de aprovação | > **Equipes (6 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_team_members` | Lista todos os membros da equipe do seu espaço de trabalho | > | `invite_team_member` | Convida um novo membro para o espaço de trabalho | > | `remove_team_member` | Remove um membro do espaço de trabalho | > | `update_member_role` | Atualiza a função de um membro da equipe | > | `list_team_invitations` | Lista os convites de equipe pendentes | > | `cancel_team_invitation` | Cancela um convite de equipe pendente | > **Links na bio (19 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_biolinks` | Lista todas as páginas de link na bio | > | `get_biolink` | Obtém os detalhes de uma página de link na bio | > | `create_biolink` | Cria uma nova página de link na bio | > | `update_biolink` | Atualiza uma página de link na bio existente | > | `delete_biolink` | Exclui uma página de link na bio | > | `publish_biolink` | Alterna o estado de publicação de um link na bio | > | `change_biolink_theme` | Troca um link na bio para um tema predefinido | > | `set_biolink_custom_theme` | Aplica cores de tema personalizadas a um link na bio | > | `list_biolink_buttons` | Lista os botões de uma página de link na bio | > | `create_biolink_button` | Adiciona um botão a uma página de link na bio | > | `update_biolink_button` | Atualiza um botão de uma página de link na bio | > | `delete_biolink_button` | Exclui um botão de uma página de link na bio | > | `reorder_biolink_buttons` | Reordena os botões de uma página de link na bio | > | `list_biolink_posts` | Lista as publicações da galeria de uma página de link na bio | > | `create_biolink_post` | Adiciona uma publicação de galeria a um link na bio | > | `update_biolink_post` | Atualiza uma publicação de galeria de um link na bio | > | `delete_biolink_post` | Exclui uma publicação de galeria de um link na bio | > | `reorder_biolink_posts` | Reordena as publicações da galeria de um link na bio | > | `get_biolink_analytics` | Obtém as análises de uma página de link na bio (visualizações, cliques) | > **Conteúdo com IA (10 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `generate_caption` | Gera uma legenda com IA para uma plataforma e um tom específicos | > | `generate_content` | Gera ou reescreve texto com IA de qualquer tipo (publicação, legenda, hashtag, título, bio, thread, e-mail etc.) | > | `generate_image` | Gera uma imagem com IA a partir de um prompt de texto | > | `generate_and_schedule` | Gera conteúdo com IA, cria uma publicação e a agenda em uma só chamada | > | `get_ai_history` | Obtém o histórico de prompts de geração com IA | > | `get_ai_credits` | Obtém os saldos e limites de créditos de IA (texto, imagem, vídeo UGC) do plano atual | > | `list_ai_image_providers` | Lista os provedores de geração de imagem com IA permitidos pelo plano atual | > | `list_generated_images` | Lista as imagens geradas com IA, com paginação | > | `get_generated_image` | Obtém os detalhes de uma imagem gerada com IA pelo ID | > | `delete_generated_image` | Exclui uma imagem gerada com IA | > **Vídeo com IA / UGC (9 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `generate_video` | Gera um vídeo UGC com IA a partir de um texto de gancho + avatar | > | `list_videos` | Lista os vídeos UGC gerados | > | `get_video` | Obtém um vídeo gerado pelo ID (inclui o status da geração) | > | `delete_video` | Exclui um vídeo gerado | > | `list_avatars` | Lista os avatares UGC disponíveis para geração de vídeo | > | `list_sounds` | Lista os sons/músicas disponíveis para geração de vídeo | > | `get_sound_genres` | Lista os gêneros de som de fundo disponíveis para vídeos UGC | > | `generate_hook_suggestions` | Gera sugestões de gancho/roteiro com IA para vídeos UGC | > | `list_ai_video_providers` | Lista os provedores de vídeo UGC com IA permitidos pelo plano atual | > **Análises (26 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `get_analytics_summary` | Busca as análises do espaço de trabalho: contagem de publicações por status e plataforma | > | `get_platform_analytics` | Obtém análises detalhadas de uma conta social conectada específica | > | `get_post_analytics` | Obtém as análises de uma publicação específica | > | `get_facebook_analytics` | Obtém as análises da página do Facebook | > | `get_facebook_posts_analytics` | Obtém as análises por publicação da página do Facebook | > | `get_facebook_videos_analytics` | Obtém as análises por vídeo da página do Facebook | > | `get_instagram_analytics` | Obtém as análises da conta do Instagram | > | `get_instagram_media_analytics` | Obtém as análises de mídia por publicação do Instagram | > | `get_instagram_stories_analytics` | Obtém as análises de stories do Instagram | > | `get_linkedin_analytics` | Obtém as análises da página do LinkedIn | > | `get_linkedin_posts_analytics` | Obtém as análises por publicação da página do LinkedIn | > | `get_youtube_analytics` | Obtém as análises do canal do YouTube | > | `get_youtube_videos_analytics` | Obtém as análises por vídeo do canal do YouTube | > | `get_twitter_analytics` | Obtém as análises da conta do Twitter/X | > | `get_twitter_content_analytics` | Obtém as análises de conteúdo do Twitter/X | > | `get_tiktok_analytics` | Obtém as análises da conta do TikTok | > | `get_whatsapp_analytics` | Obtém as análises da conta do WhatsApp Business | > | `get_bluesky_analytics` | Obtém as análises da conta do Bluesky | > | `get_mastodon_analytics` | Obtém as análises da conta do Mastodon | > | `get_reddit_account_analytics` | Obtém as análises da conta do Reddit | > | `get_reddit_submissions_analytics` | Obtém as análises dos envios (publicações) do Reddit | > | `get_pinterest_analytics` | Obtém as análises da conta do Pinterest | > | `get_pinterest_pins_analytics` | Obtém as análises por pin do Pinterest | > | `get_pinterest_top_pins_analytics` | Obtém os pins do Pinterest com melhor desempenho | > | `get_pinterest_top_video_pins_analytics` | Obtém os pins de vídeo do Pinterest com melhor desempenho | > | `get_gmb_analytics` | Obtém as análises do local no Google Business Profile (GMB) | > **Melhor horário para publicar (3 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `get_best_time_recommendations` | Lista as recomendações de melhor horário para publicar de todas as contas conectadas do espaço de trabalho | > | `get_best_time_recommendation` | Obtém a recomendação de melhor horário (mapa de calor + melhores janelas) de uma única conta | > | `recompute_best_time_recommendation` | Recalcula a recomendação de melhor horário de uma conta com base no histórico recente de engajamento | > **Modelos (3 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_templates` | Lista os modelos de conteúdo disponíveis por categoria | > | `get_template` | Obtém um modelo pelo ID | > | `render_template` | Renderiza um modelo com os valores de campo informados | > **Conhecimento (RAG) (6 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_knowledge` | Lista os documentos de conhecimento usados pelo assistente de IA (RAG) | > | `get_knowledge` | Obtém um documento de conhecimento com o texto extraído e os metadados | > | `create_knowledge` | Cria um documento de conhecimento a partir de um arquivo enviado ou de uma nota digitada | > | `update_knowledge` | Atualiza os metadados ou o corpo da nota de um documento de conhecimento | > | `reprocess_knowledge` | Tenta novamente a extração de um documento de conhecimento PDF/imagem/texto que falhou | > | `delete_knowledge` | Exclui um documento de conhecimento | > **Canva (4 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `get_canva_status` | Verifica se o Canva está conectado para o usuário autenticado | > | `list_canva_designs` | Lista os designs do Canva do usuário (paginado, com busca) | > | `export_canva_design` | Exporta um design do Canva como imagem (assíncrono; retorna o ID de um job de exportação) | > | `get_canva_export_status` | Consulta o status de um job de exportação de design do Canva | > **Ajuda e suporte (5 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `create_ticket` | Cria um ticket de suporte | > | `list_tickets` | Lista seus tickets de suporte | > | `get_ticket` | Obtém um ticket de suporte com detalhes | > | `send_ticket_message` | Envia uma mensagem em um ticket de suporte | > | `list_ticket_messages` | Lista todas as mensagens de um ticket de suporte | > **Notificações (5 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_notifications` | Lista as notificações no app do usuário autenticado | > | `get_unread_notification_count` | Obtém a contagem de notificações não lidas, opcionalmente por categoria | > | `mark_notification_read` | Marca uma notificação como lida | > | `mark_all_notifications_read` | Marca todas as notificações (opcionalmente dentro de uma categoria) como lidas | > | `archive_notification` | Arquiva (dispensa) uma notificação | > **Configurações e conta (9 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `get_profile` | Obtém seu perfil de usuário | > | `update_profile` | Atualiza o perfil do usuário autenticado (nome, senha, e-mail) | > | `get_organization` | Obtém os detalhes do espaço de trabalho/organização | > | `update_organization` | Atualiza o espaço de trabalho atual (nome, descrição, cor, fuso horário) | > | `get_usage` | Obtém o detalhamento de uso do período de faturamento atual | > | `get_user_preferences` | Obtém as preferências do usuário autenticado (configurações de notificação, fuso horário, preferências de interface) | > | `update_user_preferences` | Atualiza (mescla) as preferências do usuário autenticado | > | `get_current_tenant` | Obtém os detalhes do espaço de trabalho (tenant) ativo no momento | > | `get_billing` | Obtém as informações de assinatura e faturamento | > **Planos e faturamento (4 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `get_plans` | Obtém o catálogo de planos com preços e visibilidade | > | `get_plan_features` | Obtém a matriz de recursos de um plano específico | > | `get_subscription` | Obtém o status da assinatura atual do espaço de trabalho, o plano e os limites | > | `list_invoices` | Lista as faturas da assinatura atual | > **Chaves de API (3 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_api_keys` | Lista as chaves de API ativas do espaço de trabalho atual | > | `create_api_key` | Cria uma nova chave de API (a chave completa é retornada uma única vez) | > | `revoke_api_key` | Revoga uma chave de API | > **Espaços de trabalho / Tenants (4 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_tenants` | Lista os espaços de trabalho/tenants a que o usuário autenticado pertence | > | `create_tenant` | Cria um novo espaço de trabalho pertencente ao usuário autenticado | > | `delete_tenant` | Exclui um espaço de trabalho | > | `leave_tenant` | Sai de um espaço de trabalho do qual o usuário é membro | > **Indicações (2 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `get_referral_code` | Obtém o código de indicação do usuário autenticado | > | `get_referral_stats` | Obtém o código de indicação, o número de indicações, os créditos ganhos e a URL de compartilhamento | > **Introspecção do MCP (2 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `get_mcp_usage` | Obtém o uso de créditos MCP deste espaço de trabalho, os limites e o detalhamento por ferramenta no período atual | > | `list_mcp_tools` | Lista todas as ferramentas MCP disponíveis e seus custos em créditos | > **WhatsApp (6 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_whatsapp_templates` | Lista os modelos de mensagem do WhatsApp Business | > | `get_whatsapp_template` | Obtém um modelo de mensagem do WhatsApp pelo nome | > | `create_whatsapp_template` | Cria um modelo de mensagem do WhatsApp (enviado para aprovação da Meta) | > | `delete_whatsapp_template` | Exclui um modelo de mensagem do WhatsApp | > | `send_whatsapp_template` | Envia uma mensagem de modelo do WhatsApp para um destinatário | > | `upload_whatsapp_template_media` | Envia a mídia do cabeçalho (imagem/vídeo/documento) de um modelo | > **Webhooks (10 ferramentas)** > > | Ferramenta | Descrição | > | - | - | > | `list_webhook_subscriptions` | Lista as assinaturas de webhook | > | `get_webhook_subscription` | Obtém uma assinatura de webhook pelo ID | > | `create_webhook_subscription` | Cria uma assinatura de webhook para categorias de eventos | > | `update_webhook_subscription` | Atualiza uma assinatura de webhook (URL, categorias, estado ativo, regenerar segredo) | > | `delete_webhook_subscription` | Exclui uma assinatura de webhook | > | `test_webhook_subscription` | Envia um ping de teste para uma assinatura de webhook | > | `list_webhook_deliveries` | Lista os logs de entrega de webhooks, com filtros opcionais | > | `get_webhook_delivery` | Obtém um log de entrega de webhook com o payload completo e o status | > | `retry_webhook_delivery` | Tenta novamente uma entrega de webhook que falhou | > | `list_webhook_events` | Lista todos os tipos de evento de webhook disponíveis, por categoria | > **Auxiliares de integração (9 ferramentas)** > > 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. > > | Ferramenta | Descrição | > | - | - | > | `list_pinterest_boards` | Lista os quadros do Pinterest de uma conta (selecione um quadro antes de publicar) | > | `create_pinterest_board` | Cria um novo quadro do Pinterest | > | `list_reddit_subreddits` | Lista os subreddits dos quais a conta conectada do Reddit é membro | > | `list_reddit_flairs` | Lista os flairs de publicação disponíveis de um subreddit | > | `list_gmb_locations` | Lista os locais do Google Business Profile (GMB) de uma conta | > | `list_discord_channels` | Lista os canais do Discord disponíveis para uma conta em modo bot | > | `list_slack_channels` | Lista os canais do Slack de um workspace conectado | > | `list_telegram_chats` | Lista os chats/grupos do Telegram disponíveis para uma conta | > | `get_tiktok_creator_info` | Obtém as informações do criador/conta do TikTok (valida os recursos de 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: | Plataforma | Valor do enum | | - | - | | Twitter / X | `TWITTER` | | Instagram | `INSTAGRAM` | | LinkedIn | `LINKEDIN` | | Página do LinkedIn | `LINKEDIN_PAGE` | | Facebook | `FACEBOOK` | | TikTok | `TIKTOK` | | YouTube | `YOUTUBE` | | Threads | `THREADS` | | WhatsApp | `WHATSAPP` | | Dribbble | `DRIBBBLE` | | Pinterest | `PINTEREST` | > [!NOTE] > > 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`. ```bash Listar ferramentas theme={null} curl -X POST https://api.so-me.studio/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "X-API-Key: sk_live_your_api_key" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }' ``` ```bash Criar uma publicação agendada theme={null} curl -X POST https://api.so-me.studio/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "X-API-Key: sk_live_your_api_key" \ -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "create_post", "arguments": { "text": "Big news coming Friday!", "socialMedia": "TWITTER", "postType": "TEXT", "scheduledAt": "2026-06-20T15:00:00.000Z" } } }' ``` ```bash Gerar + agendar em uma única chamada theme={null} curl -X POST https://api.so-me.studio/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "X-API-Key: sk_live_your_api_key" \ -d '{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "generate_and_schedule", "arguments": { "platform": "LINKEDIN", "socialMedia": "LINKEDIN", "topic": "Why async standups beat daily meetings", "tone": "professional", "scheduledAt": "2026-06-21T09:00:00.000Z" } } }' ``` ## Guias de configuração Escolha seu agente de IA para começar: > **[Claude Code](/pt-BR/mcp/claude-code.md)** > > Ferramenta de programação com agentes da Anthropic > **[Claude Desktop](/pt-BR/mcp/claude-desktop.md)** > > Aplicativo para desktop da Anthropic > **[Cursor](/pt-BR/mcp/cursor.md)** > > Editor de código com IA em primeiro lugar > **[OpenAI Codex](/pt-BR/mcp/codex.md)** > > Agente de programação da OpenAI > **[Windsurf](/pt-BR/mcp/windsurf.md)** > > IDE com IA da Codeium > **[VS Code (Copilot)](/pt-BR/mcp/vscode.md)** > > Modo agente do GitHub Copilot > **[Gemini CLI](/pt-BR/mcp/gemini-cli.md)** > > Agente de terminal com IA do Google ## Solução de problemas > **401 Unauthorized** > > 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. > **405 Method Not Allowed em GET/SSE** > > 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. > **Limite de requisições excedido** > > 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. > **Créditos esgotados** > > Cada chamada de ferramenta MCP consome créditos. Confira os créditos restantes em **Configurações > MCP / ferramentas de IA**. > **Tempo limite da conexão** > > Aumente o tempo limite na sua configuração do MCP. Recomenda-se um valor de 30000 ms (30 segundos). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.