Documentación para desarrolladores de Feedqube: servidor MCP y claves API

Endpoint

• URL: https://app.feedqube.com/api/mcp
• Transporte: Streamable HTTP (POST).

Autenticación

• Inicio de sesión OAuth 2.1, para apps como Claude y ChatGPT. Los clientes lo descubren desde el servidor (metadatos del recurso protegido en /.well-known/oauth-protected-resource).
• Clave API, para scripts y automatizaciones: envía Authorization: Bearer fq_… en cada petición. Crea hasta 10 claves en Ajustes → Apps de IA → Claves API y revócalas ahí cuando quieras.

Una clave actúa como tu cuenta en todos los espacios de trabajo a los que perteneces. Mantenla en secreto.

Reglas

• Las publicaciones se crean como borradores. schedule_post solo programa un borrador después de que el usuario lo confirme en el chat; las publicaciones publicadas no se pueden cambiar por MCP.
• Las fechas son ISO 8601 con desfase horario.
• Si perteneces a varios espacios de trabajo, indica el id o el nombre del espacio.
• Límites: 120 peticiones por minuto y 5000 al día por usuario. Por encima del límite recibes HTTP 429 con Retry-After.

Herramientas

• list_workspaces: Los espacios de trabajo a los que perteneces.
• search_notes: Busca notas por palabras del título, el texto o las etiquetas.
• get_note: Lee una nota en Markdown.
• create_note: Crea una nota (contenido en Markdown).
• update_note: Edita, amplía, mueve, etiqueta o fija una nota.
• list_note_folders: Lista las carpetas de notas.
• create_note_folder: Crea una carpeta de notas.
• list_apps: Cuentas sociales conectadas y sus límites.
• list_posts: Publicaciones del calendario entre dos fechas (hasta 100 días).
• create_post: Crea un BORRADOR: texto, hora, cuenta, archivos, notas privadas, color, formato, opciones de TikTok (preguntadas al usuario).
• update_post: Cambia un borrador.
• delete_post: Quita un borrador.
• get_stats: Vistas, me gusta, comentarios y compartidos de las publicaciones publicadas.
• list_media: Imágenes y vídeos de la biblioteca multimedia.
• schedule_post: Programa un borrador para que se publique a su hora, después de que el usuario lo confirme en el chat.
• unschedule_post: Vuelve a poner como borrador una publicación programada.
• delete_note: Mueve una nota a la papelera (se puede recuperar).
• create_media_folder: Crea una carpeta multimedia.
• update_media: Cambia el nombre de un archivo o lo mueve a una carpeta.
• list_ready_posts: Publicaciones listas: publicaciones terminadas, sin fecha.
• create_ready_post: Guarda una o más publicaciones listas (sin fecha, no se publica nada).
• update_ready_post: Cambia una publicación lista.
• delete_ready_post: Elimina una publicación lista (tras la confirmación del usuario).
• schedule_ready_post: Pone una publicación lista en el calendario y la programa, tras la confirmación del usuario en el chat.
• delete_media: Elimina archivos definitivamente (propietarios/admins, tras la confirmación del usuario).
• upload_media: Añade una imagen o un vídeo a la biblioteca desde un enlace https público o base64 (hasta 20 MB por imagen, 1 GB por vídeo).
• start_upload: Inicia una subida grande desde el ordenador (hasta 1 GB): devuelve un enlace firmado al que enviar el archivo.
• finish_upload: Termina una subida grande y añade el archivo a la biblioteca.