Parcourir la documentation

Brancher un assistant d'IA

Donner à Claude, Cursor ou un autre assistant l'accès à un atelier, par le serveur MCP de Typoza et une clé d'API.

Un assistant d'IA qui parle MCP — le protocole que Claude, Cursor et bien d'autres savent parler — peut travailler dans votre atelier : lire vos articles, en écrire un brouillon, ajouter une image, lire vos statistiques. Il le fait avec une clé d'API que vous créez pour lui, et rien de plus.

L'adresse et la clé

Adresse du serveur: https://mcp.typoza.com/mcp
Transport: HTTP, sans session
Clé: À créer dans Réglages → Intégrations — voir Les clés d'API
En-tête: Authorization: Bearer typ_live_…

Créez une clé par assistant, et nommez-la d'après lui : « Claude Code sur le portable ». Le jour où vous l'arrêtez, vous savez laquelle révoquer.

Claude Code

Dans un terminal :

claude mcp add --transport http typoza https://mcp.typoza.com/mcp \
  --header "Authorization: Bearer typ_live_…"

Puis demandez-lui, par exemple, « Qui suis-je dans Typoza ? » : il appelle get_me et répond avec le nom de l'atelier et le rôle de la clé.

Cursor, et les autres clients

La plupart des clients lisent un fichier de configuration JSON. Pour Cursor, ~/.cursor/mcp.json :

{
  "mcpServers": {
    "typoza": {
      "url": "https://mcp.typoza.com/mcp",
      "headers": { "Authorization": "Bearer typ_live_…" }
    }
  }
}

Tout client qui accepte une adresse et un en-tête Authorization se branche de la même façon. Ceux qui ne proposent qu'une connexion par compte, sans en-tête à renseigner, ne se branchent pas encore : Typoza ne connaît pour l'instant que la clé d'API.

Ce que l'assistant peut faire

Les mêmes opérations que l'API publique, une par outil, avec les mêmes droits : list_posts, get_post, create_post, update_post, submit_post, publish_post, unpublish_post, list_media, upload_media, get_stats, les catégories, les mots-clés et les pages.

Quelques différences avec un script :

Une image vient d'une adresse. L'assistant ne joint pas de fichier : il donne l'adresse publique d'une image, que Typoza va chercher et range dans la médiathèque.
Une erreur lui est rendue, pas cachée. Un champ manquant, un rôle insuffisant, un slug pris : l'assistant lit le code et le message, et corrige sa demande.
Un client prudent demande avant d'agir. Chaque outil dit s'il ne fait que lire, et unpublish_post se déclare destructeur : la plupart des clients vous demandent alors confirmation.

Rien ne se supprime, et la Lettre n'est pas là : l'assistant ne peut ni effacer un article ni écrire à vos abonnés.

Le bon rôle pour un assistant

Auteur: Il écrit et publie ses propres articles — ceux créés avec la clé — et lit ce qui est publié
Relecteur: Il lit, y compris la file de relecture, et n'écrit rien
Éditeur: Il touche à tout le contenu, aux catégories, aux mots-clés et aux pages

Un assistant qui aide à écrire n'a besoin que d'Auteur. Voir Les rôles.

Ce que voit son fournisseur

Ce que l'assistant lit dans votre atelier part chez son fournisseur — Anthropic pour Claude, par exemple —, sous la politique de ce fournisseur. Typoza ne reçoit que les requêtes faites avec votre clé, et n'envoie rien d'autre. Voir la confidentialité.

Chaque écriture de l'assistant entre au journal d'activité de l'atelier, à votre nom et avec le nom de la clé. Voir Le journal d'activité.