LanaChat

API & MCP : connecter un assistant IA

Lecture de 7 minMis à jour Markdown

API & MCP (dans Users, en bas de la barre latérale) vous permet de connecter un assistant IA, comme Claude ou un autre client MCP, pour configurer et gérer votre espace de travail. MCP est une norme ouverte qui permet à un assistant d’utiliser des outils dans une application en votre nom. Les mêmes jetons d’accès ouvrent la REST API.

API et MCP : l’API REST, les webhooks et le serveur MCP pour assistants IA

Note Seuls le propriétaire de l’espace de travail et les propriétaires d’agence peuvent ouvrir cette page. Les autres voient « Owner access required ».

Ce dont vous avez besoin #

  • Le point de terminaison MCP, affiché en haut de la page. Appuyez sur Copy URL.
  • Un jeton d’accès qui précise ce que l’assistant peut faire.

Créer un jeton d’accès #

  1. Appuyez sur Create token.
  2. Donnez-lui un nom et choisissez ses accès : Workspace setup, ou Custom permissions pour cocher les permissions une par une (par exemple « Read fans and conversations » ou « Read sales »).
  3. Enregistrez. Le jeton est affiché une seule fois : appuyez sur Copy token, ou Copy client configuration pour obtenir une configuration prête à l’emploi pour votre assistant.
  4. Appuyez sur Done, I saved it.
Le panneau du nouveau jeton avec Copy token et Copy client configuration

Connecter votre assistant #

  1. Créez un accès dédié pour cet assistant (un jeton par outil connecté).
  2. Ajoutez la connexion HTTP MCP dans votre assistant, avec le point de terminaison et le jeton (étapes exactes ci-dessous).
  3. Demandez-lui ce qu’il peut voir, pour vérifier que les permissions sont correctes.
  4. Travaillez en brouillons : laissez-le préparer les modifications, testez-les, puis publiez.

Les mêmes étapes, avec le point de terminaison, l’en-tête et la configuration prêts à copier, se trouvent dans Connect your assistant en bas de la page API & MCP. Dans chaque exemple ci-dessous, remplacez l’URL par celle de votre espace de travail (Copy URL) et YOUR_MCP_TOKEN par votre jeton.

Claude Code #

Une commande dans votre terminal :

claude mcp add --transport http lanachat https://app.lanachat.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Puis tapez /mcp dans Claude Code : lanachat apparaît comme connecté, avec ses outils.

Cursor #

Ajoutez ceci dans ~/.cursor/mcp.json (pour tous les projets) ou .cursor/mcp.json (pour un projet), puis activez lanachat dans Settings › MCP :

{
  "mcpServers": {
    "lanachat": {
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

VS Code (GitHub Copilot) #

Ajoutez ceci dans .vscode/mcp.json de votre projet :

{
  "servers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Claude Desktop #

Claude Desktop démarre des serveurs locaux depuis son fichier de configuration, il atteint donc LanaChat via le petit pont mcp-remote (Node.js 18 ou plus). Ouvrez Settings › Developer › Edit Config et ajoutez :

{
  "mcpServers": {
    "lanachat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lanachat.ai/mcp", "--header", "Authorization:${LANACHAT_AUTH}"],
      "env": { "LANACHAT_AUTH": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Redémarrez Claude Desktop ; les outils LanaChat apparaissent dans le menu des outils d’une nouvelle conversation.

ChatGPT et autres assistants #

Tout client MCP capable d’envoyer un en-tête sur une connexion HTTP fonctionne avec la configuration ci-dessus. Les connecteurs web qui n’offrent qu’une connexion OAuth (connecteurs ChatGPT, connecteurs personnalisés sur claude.ai) ne peuvent pas envoyer de jeton d’accès, ils ne peuvent donc pas encore se connecter.

Vérifier la connexion #

L’inspecteur MCP liste les outils ouverts par votre jeton, sans assistant :

npx @modelcontextprotocol/inspector

Choisissez Streamable HTTP, collez le point de terminaison, ajoutez l’en-tête Authorization: Bearer YOUR_MCP_TOKEN, puis Connect et List tools.

Gérer les jetons #

Le tableau Access tokens montre les permissions, la date d’expiration et le statut de chaque jeton. Utilisez Edit, Rotate (ou Renew) et Revoke. Show revoked tokens liste les anciens.

Attention Un jeton fonctionne comme un mot de passe. Révoquez-le dès que vous n’utilisez plus l’assistant ou si vous pensez qu’il a fuité.

Le point de terminaison MCP #

MethodPathDescriptionPermissionStatus
POSThttps://app.lanachat.ai/mcpLe serveur MCP (Streamable HTTP) : chaque appel d’outil passe iciany tokenPlanned
GEThttps://app.lanachat.ai/mcpOuvre le flux d’événements de la sessionany tokenPlanned
POSThttps://app.lanachat.ai/api/media/uploadsTéléchargements médias depuis un assistant, avec le même jetoncan_setupPlanned

L’URL exacte de votre espace de travail est affichée en haut de la page API & MCP (Copy URL). Le jeton va dans l’en-tête Authorization, comme pour l’API. Une configuration client ressemble à ceci :

{
  "mcpServers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Outils accessibles à l’assistant #

L’assistant ne voit que les outils autorisés par son jeton. Un outil qu’il ne peut pas utiliser n’est pas du tout listé. Lorsqu’il se connecte, le serveur envoie à l’assistant les arguments exacts de chaque outil (nom, type, requis), vous n’avez donc jamais à les taper vous-même. La dernière colonne est le point d’API qui fait la même chose, où ses paramètres sont documentés.

ToolCe qu’il faitPermissionMême chose dans l’API
list_creators, get_creatorLire les créatrices, leur identité et l’avancement de la configurationcan_setupGET /creators
update_creator, update_personaModifier l’identité d’une créatrice ou ses pages personacan_setup, can_engine pour la personaPUT …/identity, PATCH …/persona
list_accounts, update_accountLire les comptes Telegram, changer brain, market ou trafficcan_setupGET /accounts, PATCH /accounts/{id}
list_media, upload_media, update_media, create_media_folderAjouter des médias dans un Vault, les trier, suggérer des descriptions (montrées pour relecture avant sauvegarde)can_setup/media
list_scripts, draft_script, update_scriptLire les scripts et en rédiger de nouveaux : étapes, médias et prix Starscan_setup/scripts
list_members, update_memberLire et modifier les membres de l’équipecan_setup/members
get_brain, update_brain_draft, test_brainLire un brain, éditer son brouillon, le tester dans le Playgroundcan_engine/brains, /playground
publish_brainPublier un brouillon de brain ordinairecan_publishPOST /brains/{id}/publish
test_advanced_ai, tune_advanced_ai, publish_advanced_aiBrouillons, réglages et profils d’IA avancée (propriétaire de l’espace uniquement)can_ai_test, can_ai_tune, can_ai_publishAucun
list_experiment_reportsLire les rapports d’expériences commerciales (propriétaire de l’espace uniquement)can_commercial_reportsAucun
list_fans, get_conversationLire les fans et l’historique des conversationscan_fan_readGET /fans, GET /conversations/{id}/messages
import_fan_historyAjouter les fans et messages passés aux archives ; n’envoie jamais de messagecan_fan_importPOST /fans/import
list_salesLire les ventes enregistrées pour les rapportscan_sales_readGET /fans/{id}/sales, GET /stats

Note Désactiver Access AI configuration supprime aussi les permissions de publication, d’IA avancée et de rapports d’expériences. La configuration de l’espace et les permissions fans et ventes restent indépendantes. Aucun outil n’envoie de message à un fan.

Que lui demander #

Parlez-lui comme à un collègue qui connaît la Console. Quelques exemples de requêtes efficaces :

  • « Liste mes créatrices et dis-moi lesquelles ont une configuration inachevée. »
  • « Lis la persona de Lea et suggère trois réponses types pour les fans qui demandent si elle est réelle. Ne sauvegarde rien. »
  • « Rédige un script de reconquête pour Lea : trois étapes sur deux jours, la dernière une offre payante à 250 Stars. Laisse-le inactif. »
  • « Télécharge les photos dans ce dossier vers le Vault de Lea, dans un dossier appelé Beach, et suggère une description pour chacune. »
  • « Modifie le brouillon du brain de Lea pour que la première offre arrive après 6 messages, teste-le dans le Playground avec un fan anglophone, et montre-moi les réponses avant publication. »
  • « Combien chaque créatrice a-t-elle vendu hier, et quel lien de tracking a apporté le plus d’acheteurs cette semaine ? »

Astuce Demandez-lui de travailler en brouillons et de vous montrer le résultat avant publication. Publier nécessite un jeton avec Publish AI Brain drafts : laissez-le désactivé si vous voulez garder le dernier mot.

Points de terminaison des jetons #

La page ci-dessus appelle ces routes ; le guide équipe liste les mêmes actions dans l’API publique (/v1/tokens).

MethodPathDescriptionPermissionStatus
GET/api/mcp/tokensListe les jetons, leurs permissions, expiration et statutownerPlanned
POST/api/mcp/tokensCrée un jeton (affiché une fois)ownerPlanned
PUT/api/mcp/tokens/{id}Modifie son nom ou ses permissionsownerPlanned
POST/api/mcp/tokens/{id}/rotateFait tourner le secretownerPlanned
DELETE/api/mcp/tokens/{id}Le révoqueownerPlanned

Ces routes Console prennent et renvoient les permissions sous forme de champs booléens (can_setup, can_engine, can_publish, can_ai_test, can_ai_tune, can_ai_publish, can_commercial_reports, can_fan_read, can_fan_import, can_sales_read). La création d’un jeton répond { "token": "…", "grant": { … } } : token est le secret, affiché une fois ; grant est l’accès avec son id, name, scope, enabled, created et expires (secondes Unix). La rotation révoque l’ancien accès et répond un nouveau token et grant. Un nom manquant répond 400, un id inconnu 404, un accès révoqué 409.

Plus d’infos sur la page fonctionnalité API et MCP.

Les dernières nouvelles de Lana sur Telegram

Nouveautés et invitations à la bêta, en premier sur le canal.