Endpoint e inicio de sesión
Paso a paso para personas, con la lista de apps que admiten conectores personalizados: Asistentes de IA. Detalles legibles por máquina: /auth.md y la server card en /mcp/server-card. Está en el registro oficial de MCP como com.multiplegroupposter/multigroupposter (ficha del registro).
| Elemento | Valor |
|---|---|
| Endpoint | https://mcp.multiplegroupposter.com/mcp (Streamable HTTP, sin estado) |
| Autenticación | OAuth 2.1 con PKCE (S256). Se admiten tanto el registro dinámico de clientes como los documentos de metadatos de client ID. Scopes: mgp, offline_access. |
| Descubrimiento | /.well-known/oauth-protected-resource y /.well-known/oauth-authorization-server. Una llamada sin autenticar devuelve 401 con una cabecera WWW-Authenticate que apunta a ellos. |
| Vinculación | En la página de inicio de sesión, la persona escribe un código de 8 dígitos de la extensión (Ayuda, luego Conectar un asistente de IA, luego Obtener mi código; válido 20 minutos). Después la extensión le pide elegir el número que muestra la página de inicio de sesión. Si elige mal, se deniega la solicitud. |
| Tokens | Los refresh tokens duran 180 días y se renuevan con el uso. Desconectar en la extensión borra los tokens y todo lo que guardó el conector. |
| Cuenta de prueba | La página de inicio de sesión tiene "Probar una cuenta demo": dos listas de ejemplo, nada llega a Facebook y se borra a los 3 días. Úsala para probar un cliente. |
Herramientas
También hay un prompt, post_to_groups, que guía una publicación paso a paso. Cada herramienta tiene indicaciones de solo lectura y destructiva.
| Herramienta | Qué hace |
|---|---|
get_started | Estado de la configuración: si la extensión está en línea y con sesión iniciada, el plan, las listas de grupos, las publicaciones recientes y el siguiente paso sugerido. Solo lectura. |
list_group_lists | Las listas de grupos guardadas (nombre, número de grupos). Solo lectura. |
create_post | Crea una publicación para una lista de grupos: texto (hasta 5.000 caracteres), nombre de la lista, hasta 10 media ids, primer comentario opcional (hasta 1.000), método fast o safe, modo draft (por defecto) o publish_now. publish_now necesita confirmed: true, que solo se da después de que la persona haya dicho que sí a un resumen. |
get_post_status | Estado de una publicación (en cola, recogida, borrador listo, publicando, hecha, fallida) con el resultado y el enlace de cada grupo. Solo lectura. |
list_recent_posts | Las 10 últimas publicaciones hechas mediante el asistente. Consúltala antes de volver a crear una publicación tras un error poco claro. Solo lectura. |
get_upload_link | Una página web de un solo uso donde la persona sube fotos o vídeos (funciona en el teléfono, 24 horas). |
list_uploaded_media | Las fotos y vídeos subidos con sus media ids. Solo lectura. |
add_media_from_url | Descarga una foto o un vídeo desde un enlace https público (hasta 100 MB; JPG, PNG, GIF, WEBP, MP4, MOV). |
open_post_composer | Muestra una tarjeta en el chat (MCP Apps) para añadir fotos, editar el texto y elegir la lista. Crea un borrador. |
Cómo funciona la publicación
- Borrador es la opción por defecto: la publicación espera en la extensión hasta que la persona la revisa y pulsa Publicar.
- El servidor no publica nada. La extensión en el Chrome de la persona recoge el trabajo y lo publica con su propia sesión de Facebook, su método y su ritmo. Si Chrome está cerrado, el trabajo espera.
- Publicar ahora cuenta en el plan gratuito como cualquier otra publicación; los borradores no.
- Los archivos subidos se guardan 24 horas y las publicaciones 7 días. Al desconectar se borran al momento.
Errores
Los errores de las herramientas vuelven como un resultado normal con isError: true y un cuerpo JSON {"error": "...", "next_step": "..."} (también en structuredContent). Una publicación fallida tiene un code: free_plan_used_up, not_signed_in, busy, list_missing, list_empty, media_missing, storage, off, disconnected, not_posted, lost o error, y next_step dice qué decirle a la persona.
Los errores HTTP también son JSON: 401 {"error":"invalid_token"} con WWW-Authenticate, 404 {"error":"not found"}, 429 cuando se alcanza un límite de inicios de sesión.
Después de un error poco claro, no vuelvas a llamar a create_post: llama primero a list_recent_posts, para que nada se publique dos veces.
En este sitio web (WebMCP y la API de información)
Las páginas de multiplegroupposter.com también ofrecen herramientas WebMCP de solo lectura a un agente en el navegador (si el navegador admite WebMCP): get_pricing, get_limits, search_docs, get_install_link y get_mcp_connection_info. Solo leen datos de este sitio y no envían nada a ninguna parte.
Los mismos datos están disponibles en JSON en /api/v1/pricing/, /api/v1/limits/ y /api/v1/docs/?q=, descritos en /openapi.json. No hace falta clave.
Para agentes de IA: cada página de la documentación tiene una copia en Markdown (añade .md a la ruta), toda la sección está indexada en /docs/llms.txt y /docs.json, y el servidor MCP se describe en /docs/mcp/.