Feedqube-Entwicklerdokumentation: MCP-Server und API-Schlüssel

Endpoint

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

Authentifizierung

• Anmeldung per OAuth 2.1, für Apps wie Claude und ChatGPT. Clients finden sie über den Server (Protected-Resource-Metadaten unter /.well-known/oauth-protected-resource).
• API-Schlüssel, für Skripte und Automatisierungen: sende bei jeder Anfrage Authorization: Bearer fq_…. Erstelle bis zu 10 Schlüssel unter Einstellungen → KI-Apps → API-Schlüssel und widerrufe sie dort jederzeit.

Ein Schlüssel handelt als dein Konto in allen Arbeitsbereichen, zu denen du gehörst. Halte ihn geheim.

Regeln

• Beiträge werden als Entwürfe erstellt. schedule_post plant einen Entwurf erst, nachdem der Nutzer im Chat zugestimmt hat; veröffentlichte Beiträge können über MCP nicht geändert werden.
• Daten im Format ISO 8601 mit Zeitzonen-Offset.
• Wenn du mehreren Arbeitsbereichen angehörst, gib die ID oder den Namen des Arbeitsbereichs an.
• Limits: 120 Anfragen pro Minute und 5000 pro Tag und Nutzer. Darüber gibt es HTTP 429 mit Retry-After.

Werkzeuge

• list_workspaces: Die Arbeitsbereiche, zu denen du gehörst.
• search_notes: Notizen nach Wörtern in Titel, Text oder Tags finden.
• get_note: Eine Notiz als Markdown lesen.
• create_note: Eine Notiz erstellen (Inhalt in Markdown).
• update_note: Eine Notiz bearbeiten, ergänzen, verschieben, taggen oder anheften.
• list_note_folders: Notizordner auflisten.
• create_note_folder: Einen Notizordner erstellen.
• list_apps: Verbundene Social-Media-Konten und ihre Limits.
• list_posts: Kalenderbeiträge zwischen zwei Daten (bis zu 100 Tage).
• create_post: Einen ENTWURF erstellen: Text, Zeit, Konto, Medien, private Notizen, Farbe, Format, TikTok-Optionen (beim Nutzer erfragt).
• update_post: Einen Entwurf ändern.
• delete_post: Einen Entwurf entfernen.
• get_stats: Aufrufe, Likes, Kommentare und Shares veröffentlichter Beiträge.
• list_media: Bilder und Videos in der Mediathek.
• schedule_post: Einen Entwurf zur Veröffentlichung planen, nachdem der Nutzer im Chat zugestimmt hat.
• unschedule_post: Einen geplanten Beitrag wieder zum Entwurf machen.
• delete_note: Eine Notiz in den Papierkorb verschieben (wiederherstellbar).
• create_media_folder: Einen Medienordner erstellen.
• update_media: Eine Mediendatei umbenennen oder in einen Ordner verschieben.
• list_ready_posts: Fertige Beiträge: fertige Beiträge ohne Datum.
• create_ready_post: Einen oder mehrere fertige Beiträge speichern (ohne Datum, nichts wird veröffentlicht).
• update_ready_post: Einen fertigen Beitrag ändern.
• delete_ready_post: Einen fertigen Beitrag löschen (nach Zustimmung des Nutzers).
• schedule_ready_post: Einen fertigen Beitrag in den Kalender legen und planen, nach Zustimmung des Nutzers im Chat.
• delete_media: Medien endgültig löschen (Inhaber/Admins, nach Zustimmung des Nutzers).
• upload_media: Ein Bild oder Video aus einem öffentlichen https-Link oder base64 zur Mediathek hinzufügen (bis zu 20 MB pro Bild, 1 GB pro Video).
• start_upload: Einen großen Upload vom Computer starten (bis zu 1 GB): liefert einen signierten Link für die Datei.
• finish_upload: Einen großen Upload abschließen und die Datei zur Mediathek hinzufügen.