Documentação para programadores: servidor MCP e chaves de API

Endpoint

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

Autenticação

• Início de sessão OAuth 2.1, para apps como o Claude e o ChatGPT. Os clientes descobrem-no a partir do servidor (metadados do recurso protegido em /.well-known/oauth-protected-resource).
• Chave de API, para scripts e automações: envie Authorization: Bearer fq_… em cada pedido. Crie até 10 chaves em Definições → Apps de IA → Chaves de API, e revogue-as aí quando quiser.

Uma chave age como a sua conta em todos os espaços de trabalho a que pertence. Mantenha-a secreta.

Regras

• Os posts são criados como rascunho. O schedule_post só agenda um rascunho onde o espaço de trabalho o permite e depois de o utilizador confirmar; posts publicados não podem ser alterados por MCP.
• As datas são ISO 8601 com fuso horário.
• Se pertencer a vários espaços, indique o id ou o nome do espaço.
• Limites: 120 pedidos por minuto e 5000 por dia por utilizador. Acima do limite recebe HTTP 429 com Retry-After.

Ferramentas

• list_workspaces: Os espaços de trabalho a que pertence.
• search_notes: Procura notas por palavras no título, texto ou etiquetas.
• get_note: Lê uma nota em Markdown.
• create_note: Cria uma nota (corpo em Markdown).
• update_note: Edita, acrescenta, move, etiqueta ou fixa uma nota.
• list_note_folders: Lista as pastas de notas.
• create_note_folder: Cria uma pasta de notas.
• list_apps: Contas sociais ligadas e os seus limites.
• list_posts: Posts do calendário entre duas datas (até 100 dias).
• create_post: Cria um post em RASCUNHO: texto, hora, conta, media, notas privadas, cor, formato, opções do TikTok (perguntadas ao utilizador).
• update_post: Altera um post em rascunho.
• delete_post: Remove um post em rascunho.
• get_stats: Visualizações, gostos, comentários e partilhas dos posts publicados.
• list_media: Imagens e vídeos da biblioteca de media.
• schedule_post: Agenda um rascunho para ser publicado à hora marcada, depois de o utilizador confirmar na conversa. Só onde o espaço de trabalho o permite (Definições → Apps de IA).
• unschedule_post: Volta a pôr uma publicação agendada como rascunho.
• delete_note: Envia uma nota para o lixo (pode ser recuperada).
• create_media_folder: Cria uma pasta de media.
• update_media: Muda o nome de um ficheiro de media ou move-o para uma pasta.
• delete_media: Apaga media de vez (donos/administradores, depois de o utilizador confirmar).
• list_ready_posts: Posts prontos: posts acabados, sem data.
• create_ready_post: Guarda um ou mais posts prontos (sem data, nada é publicado).
• update_ready_post: Altera um post pronto.
• delete_ready_post: Apaga um post pronto (depois de o utilizador confirmar).
• schedule_ready_post: Põe um post pronto no calendário e agenda-o, depois de o utilizador confirmar na conversa.
• upload_media: Junta uma imagem ou vídeo à biblioteca de media a partir de um link https público ou base64 (até 20 MB por imagem, 1 GB por vídeo).
• start_upload: Inicia um upload grande a partir do computador (até 1 GB): devolve um link assinado para enviar o ficheiro.
• finish_upload: Conclui um upload grande e junta o ficheiro à biblioteca de media.