Piloter mysaas.blog avec une IA

Lecture publique

Les tools préfixés public_ ne demandent aucun token. Ils ne retournent que les posts publiés, profils publics, commentaires publics, tags et catégories visibles sur le site.

Authentification

Les actions privées utilisent OAuth authorization code + PKCE ou une agent key personnelle. Dans ChatGPT, l'hôte lance OAuth et conserve le token : l'utilisateur ne colle jamais de bearer token dans la conversation. Les scopes séparent lecture, brouillon, média, publication, commentaires, SaaS et intégrations. Les accès reviewer OpenAI se créent et se révoquent depuis Admin → Reviewers ; Infisical reste réservé aux secrets serveur.

MCP tools

Façade ChatGPT

La façade dédiée /mcp/chatgpt propose 27 outils pour gérer le profil, les préférences éditoriales, les SaaS, les catégories, les tags, les sources, les commentaires, les intégrations, écrire, relire, traduire et piloter le cycle de vie d’un article. Elle expose cinq skills importables (manage-posts, manage-saas, manage-profile-and-editorial-preferences, manage-community-and-integrations et analytics), qui couvrent les sept workflows historiques. Le workflow accepte fr, en ou les deux dans un même brouillon : post_translate prépare une proposition non persistée, puis les médias, sources structurées, tags, catégories et relations SaaS sont validés avant la sauvegarde et la publication explicite. Les sources ne sont pas recopiées en bibliographie dans le body ; les citations contextuelles et les mentions SaaS utilisent des liaisons suivies.

REST API

Le contrat REST complet est machine-readable: chaque endpoint décrit ses paramètres, body JSON ou multipart, réponses, erreurs et scopes. Les modes publication now et schedule demandent posts:publish en plus de posts:write.

Post riche

Un post agentique n'est pas du Markdown brut. Il contient des traductions, du HTML editor sanitizé, une image SEO, des sources, des tags, une catégorie, des SaaS liés et un mode de publication.

{
  "translations": [{
    "locale": "fr",
    "title": "Build log",
    "excerpt": "Résumé SEO",
    "contentHtml": "<h2>...</h2>",
    "seoImage": { "mode": "manual", "mediaId": "cm..." }
  }],
  "tags": ["pricing", "seo"],
  "sources": [{ "url": "https://example.com", "label": "Source" }],
  "relatedSaasIds": ["cm..."],
  "publication": { "mode": "draft" }
}

Réponses et retries

Le REST utilise l'enveloppe ok/data/meta et les ressources se lisent dans data. MCP expose le structuredContent direct annoncé par outputSchema; il n'est pas enveloppé dans le contrat REST. Le endpoint MCP n'accepte que 2026-07-28 et ne fait aucun fallback 2025.

REST
{
  "ok": true,
  "data": { "post": { "id": "cm..." } },
  "meta": { "scopes": ["posts:read", "posts:write"] }
}

MCP tools/call
{
  "result": {
    "structuredContent": {
      "ok": true,
      "post": { "id": "cm..." },
      "meta": { "idempotency": { "key": "draft-2026-08-01-a", "replayed": false } }
    }
  }
}

Brouillons

Les brouillons se listent avec status=draft ou status=all, ou includeDrafts=true. Ces vues exigent posts:drafts:read. Un brouillon créé par erreur peut être archivé avec posts:delete.

GET /api/v1/posts?status=draft
GET /api/v1/posts?status=all
DELETE /api/v1/posts/{id}

Flux média

Importez ou uploadez une image, récupérez media.id, puis référencez mediaId dans seoImage ou data-media-id dans le HTML editor. Le serveur résout l'URL canonique depuis la médiathèque et conserve les métadonnées SEO omises lors d'un patch de traduction.

POST /api/v1/media/import
{ "url": "https://example.com/hero.png" }

{
  "translations": [{
    "seoImage": { "mode": "manual", "mediaId": "cm_media_123" },
    "contentHtml": "<img src=\"https://...\" data-media-id=\"cm_media_123\" alt=\"...\" />"
  }]
}

Permissions

La lecture des contenus publics ne nécessite pas de clé. Les actions d’écriture nécessitent OAuth ou une clé agent avec les scopes adaptés. La suppression utilise posts:delete, désactivé par défaut lors de la création d’une clé; elle archive le post, le retire des surfaces publiques et libère ses slugs.