Endpoint e login
Passo a passo para pessoas, com a lista de apps que aceitam conectores personalizados: Assistentes de IA. Detalhes legíveis por máquina: /auth.md e o server card em /mcp/server-card. Está no registro oficial de MCP como com.multiplegroupposter/multigroupposter (ficha no registro).
| Item | Valor |
|---|---|
| Endpoint | https://mcp.multiplegroupposter.com/mcp (Streamable HTTP, sem estado) |
| Autenticação | OAuth 2.1 com PKCE (S256). Registro dinâmico de cliente e documentos de metadados de client ID são suportados. Escopos: mgp, offline_access. |
| Descoberta | /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server. Uma chamada sem autenticação retorna 401 com um cabeçalho WWW-Authenticate que aponta para eles. |
| Vinculação | Na página de login, a pessoa digita um código de 8 dígitos da extensão (Ajuda, depois Conectar um assistente de IA, depois Pegar meu código; válido por 20 minutos). Em seguida a extensão pede que ela escolha o número que a página de login mostra. Uma escolha errada nega o pedido. |
| Tokens | Os refresh tokens duram 180 dias e se renovam com o uso. Desconectar na extensão remove os tokens e tudo o que o conector guardou. |
| Conta de teste | A página de login tem "Testar uma conta demo": duas listas de exemplo, nada chega ao Facebook e tudo é apagado após 3 dias. Use para testar um cliente. |
Ferramentas
Há também um prompt, post_to_groups, que conduz um post passo a passo. Toda ferramenta tem as indicações de somente leitura e destrutiva.
| Ferramenta | O que faz |
|---|---|
get_started | Estado da configuração: se a extensão está online e com login feito, o plano, as listas de grupos, os posts recentes e o próximo passo sugerido. Somente leitura. |
list_group_lists | As listas de grupos salvas (nome, número de grupos). Somente leitura. |
create_post | Cria um post para uma lista de grupos: texto (até 5.000 caracteres), nome da lista, até 10 media ids, primeiro comentário opcional (até 1.000), método fast ou safe, modo draft (padrão) ou publish_now. publish_now precisa de confirmed: true, dado só depois que a pessoa disse sim a um resumo. |
get_post_status | Status de um post (na fila, recebido, rascunho pronto, publicando, concluído, falhou) com o resultado e o link de cada grupo. Somente leitura. |
list_recent_posts | Os últimos 10 posts feitos pelo assistente. Confira antes de criar um post de novo depois de um erro pouco claro. Somente leitura. |
get_upload_link | Uma página web de uso único onde a pessoa envia fotos ou vídeos (funciona no celular, 24 horas). |
list_uploaded_media | Fotos e vídeos enviados, com os media ids. Somente leitura. |
add_media_from_url | Baixa uma foto ou um vídeo de um link https público (até 100 MB; JPG, PNG, GIF, WEBP, MP4, MOV). |
open_post_composer | Mostra um cartão no chat (MCP Apps) para adicionar fotos, editar o texto e escolher a lista. Ele cria um rascunho. |
Como a publicação funciona
- Rascunho é o padrão: o post espera na extensão até a pessoa conferir e clicar em Publicar.
- O servidor não publica nada. A extensão no Chrome da pessoa pega o trabalho e publica com a própria sessão do Facebook dela, o método e o ritmo dela. Se o Chrome estiver fechado, o trabalho espera.
- Publicar agora conta no plano grátis como qualquer outro post; rascunhos não contam.
- As mídias enviadas ficam guardadas 24 horas, e os posts 7 dias. Desconectar apaga tudo na hora.
Erros
Erros de ferramenta voltam como um resultado normal com isError: true e um corpo JSON {"error": "...", "next_step": "..."} (também em structuredContent). Um post que falhou tem um code: free_plan_used_up, not_signed_in, busy, list_missing, list_empty, media_missing, storage, off, disconnected, not_posted, lost ou error, e next_step diz o que falar para a pessoa.
Erros HTTP também são JSON: 401 {"error":"invalid_token"} com WWW-Authenticate, 404 {"error":"not found"}, 429 quando um limite de login é atingido.
Depois de um erro pouco claro, não chame create_post de novo: chame list_recent_posts primeiro, para que nada seja publicado duas vezes.
Neste site (WebMCP e a API de informações)
As páginas de multiplegroupposter.com também oferecem ferramentas WebMCP somente leitura para um agente no navegador (quando o navegador suporta WebMCP): get_pricing, get_limits, search_docs, get_install_link e get_mcp_connection_info. Elas só leem fatos deste site e não enviam nada para lugar nenhum.
Os mesmos fatos estão disponíveis em JSON em /api/v1/pricing/, /api/v1/limits/ e /api/v1/docs/?q=, descritos em /openapi.json. Não é preciso chave.
Para agentes de IA: cada página da documentação tem uma cópia em Markdown (adicione .md ao caminho), a seção inteira está indexada em /docs/llms.txt e /docs.json, e o servidor MCP é descrito em /docs/mcp/.