MCP de l'espace de travail - Attlas Documentation

Les clés API Workspace permettent aux outils de développement externes et aux assistants IA (Claude Code, Cursor, Claude Desktop, VS Code et Codex) de se connecter à l’ensemble de votre espace de travail Attlas à l’aide du Model Context Protocol (MCP). Contrairement au point de terminaison MCP public du chat, les clés API Workspace sont des informations d’identification privées et limitées qui couvrent tous les chats, documents de connaissances, déclencheurs, contacts et analyses de votre espace de travail.

Après avoir connecté le MCP, nous vous recommandons d’installer les compétences Attlas. Elles apprennent à votre assistant la bonne façon d’utiliser ces outils, afin que des demandes comme « mettre notre page de tarification dans le chat avec des questions en dessous » ou « configurer mon nouveau chat » fonctionnent en une seule étape.

Démarrage rapide

Connectez votre assistant IA à votre espace de travail Attlas en trois étapes :

Créer une clé API

Dans le tableau de bord Attlas, ouvrez Paramètres de l’espace de travail.
Allez dans l’onglet Clés API (ou MCP).
Cliquez sur Créer une clé API.
Saisissez un nom (par ex. Cursor assistant ou Claude Code).
Choisissez vos autorisations (Écriture pour créer et modifier des ressources, ou Suppression si vous avez besoin de privilèges de suppression).
Cliquez sur Créer une clé et copiez immédiatement votre clé secrète (atk_...).

Votre clé API ne s’affiche qu’une seule fois. Conservez-la en lieu sûr. Attlas ne peut pas afficher à nouveau le secret une fois la boîte de dialogue fermée.

Configurez votre client IA

Le point de terminaison MCP de l’espace de travail est hébergé à l’adresse :

https://mcp.attlas.so

Sélectionnez votre outil d’IA ci-dessous pour copier la commande de configuration ou le fichier de configuration :

# Run in your terminal from your project directory:
claude mcp add attlas --transport http https://mcp.attlas.so \
  --header "Authorization: Bearer atk_your_api_key"

{
  "mcpServers": {
    "attlas": {
      "url": "https://mcp.attlas.so",
      "headers": {
        "Authorization": "Bearer atk_your_api_key"
      }
    }
  }
}

{
  "mcpServers": {
    "attlas": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.attlas.so",
        "--header",
        "Authorization: Bearer atk_your_api_key"
      ]
    }
  }
}

{
  "servers": {
    "attlas": {
      "type": "http",
      "url": "https://mcp.attlas.so",
      "headers": {
        "Authorization": "Bearer atk_your_api_key"
      }
    }
  }
}

[mcp_servers.attlas]
command = "npx"
args = [
  "mcp-remote",
  "https://mcp.attlas.so",
  "--header",
  "Authorization: Bearer atk_your_api_key"
]

Si vous utilisez Cursor, cliquez sur le bouton Ajouter à Cursor directement dans l’onglet Clés API d’Attlas pour configurer la connexion en un seul clic.

Vérifiez la connexion

Testez votre configuration en demandant à votre assistant :

List my Attlas chats

Votre assistant appellera l’outil list_chats et renverra la liste des chats avec leurs identifiants numériques.

Claude Web et Bureau (connecteur personnalisé)

Pour vous connecter depuis claude.ai ou l’application de bureau Claude, ajoutez Attlas en tant que connecteur personnalisé. Le point de terminaison de l’espace de travail s’authentifie avec une clé API, pas avec OAuth, donc quelques champs nécessitent des valeurs spécifiques.

Ouvrir la boîte de dialogue du connecteur personnalisé

Dans Claude, accédez à Paramètres → Connecteurs → Ajouter un connecteur personnalisé (Team et Enterprise : Paramètres de l’organisation → Connecteurs → Ajouter → Personnalisé).

Saisir l'URL

https://mcp.attlas.so

Définir l'authentification sur Aucun

Après avoir continué, Claude sonde l’URL et peut présélectionner Toujours requis, marqué Détecté. Il s’agit d’un faux positif : le serveur renvoie 401 à la sonde non authentifiée, et Claude interprète cela comme OAuth.Sélectionnez Aucun à la place. La description de cette option l’indique explicitement : « ou pour les serveurs qui utilisent une clé API plutôt qu’OAuth ». La section Client OAuth disparaît alors.

Ajouter la clé comme en-tête de requête

Ouvrez En-têtes de requête et ajoutez un en-tête :

Champ	Valeur
Nom	`authorization` (choisissez-le dans la liste ; les minuscules sont acceptées, les noms d’en-tête HTTP ne sont pas sensibles à la casse)
Valeur	`Bearer atk_your_api_key`
Requis	coché

Saisissez la valeur exactement comme le serveur l’attend, y compris le mot Bearer et un espace avant la clé. Claude envoie la valeur telle quelle et n’ajoute aucun schéma. atk_... seul est envoyé sous la forme Authorization: atk_... et le serveur le rejette avec une erreur 401.

Ajouter le connecteur

Cliquez sur Ajouter, puis activez Attlas depuis le menu + dans une conversation.

En-têtes de requête est une fonctionnalité bêta disponible pour un ensemble limité d’organisations. Si vous ne voyez pas cette section, connectez-vous avec Claude Code ou mcp-remote à la place (voir Démarrage rapide ci-dessus).

Dépannage

Symptôme	Cause	Correctif
La connexion échoue, Claude demande de se connecter avec OAuth	L’authentification est restée sur Toujours requis, ou la valeur de l’en-tête ne contient pas le préfixe `Bearer`	Supprimez le connecteur, puis ajoutez-le à nouveau avec Aucun et une valeur `Bearer atk_...` correcte
`401` à chaque appel	Clé incorrecte, révoquée ou malformée ; valeur envoyée sans `Bearer`	Vérifiez la clé dans l’onglet Clés API d’Attlas ; réajoutez le connecteur avec la valeur exacte
Outils manquants après la connexion	Le périmètre de la clé ne les inclut pas	Créez une clé avec le périmètre Écriture ou Suppression
Fonctionne dans Claude Code mais pas sur claude.ai	La bêta des en-têtes de requête n’est pas activée pour votre organisation	Utilisez Claude Code ou `mcp-remote`, ou contactez le support Claude pour demander l’accès

Portées des autorisations

Lors de la création d’une clé API, sélectionnez les autorisations correspondant à votre cas d’usage :

Portée	Libellé de l’interface	Ce qu’il peut faire
`read`	Lecture	Voir et rechercher des chats, documents, déclencheurs, contacts, conversations et analyses. Inclus par défaut sur toutes les clés.
`write`	Écriture	Créer et mettre à jour des documents, corrections, déclencheurs, contacts, image de marque, avatar, SEO et paramètres de chat. Inclut automatiquement les autorisations de Lecture.
`destructive`	Suppression	Supprimer définitivement des chats, documents, déclencheurs, contacts et conversations. Inclut automatiquement les autorisations d’Écriture et de Lecture.

N’accordez l’autorisation Suppression qu’aux flux de travail de confiance où un nettoyage automatisé ou une suppression de ressources est explicitement requis.

Exigences selon l’offre

Le serveur MCP de l’espace de travail fonctionne lui-même sur toutes les offres. Quelques actions suivent les mêmes limites d’offre que le tableau de bord :

Action	Exigence
Lire des métriques, des tendances, des classements ou générer un rapport	La plage ne remonte que jusqu’à la fenêtre d’historique de votre offre (Gratuit : 90 jours, Starter : 1 an, PRO : 2 ans). Les plages plus larges sont rognées à cette fenêtre.
Ajouter un lien vidéo YouTube, Instagram, TikTok, Facebook ou X à une base de connaissances	Starter ou PRO (transcription vidéo). Les liens de pages Web fonctionnent sur toutes les offres.
Supprimer le badge de marque Attlas (`update_branding`)	Module complémentaire Brand.
Personnaliser les métadonnées SEO du chat (`update_seo`)	Offre Basic ou supérieure.
Modifier les paramètres de base de données SQL connectée d’un chat	Starter ou PRO (intégrations avancées).

Capacités et outils disponibles

Une fois connecté, votre assistant peut gérer tous les aspects de votre espace de travail :

Configuration du chat, image de marque et aperçu en direct

preview_chat : Afficher un aperçu interactif en direct de votre chat public dans les hôtes d’applications MCP sans consommer de crédits de messages ni affecter les analyses.
update_chat : Modifier la configuration du chat, les objectifs et les paramètres de comportement.
update_avatar : Définir l’avatar du chat à partir d’une URL d’image publique (hébergée automatiquement) ou d’un emoji.
update_branding : Afficher ou masquer le badge « Propulsé par Attlas » (nécessite le module complémentaire Brand).
update_seo : Définir le titre meta, la description meta et l’image de partage social (og:image).
update_social_links : Définir les liens de profils de réseaux sociaux (X, LinkedIn, Instagram, YouTube, TikTok, etc.) affichés sur le chat.
update_theme et list_theme_presets : Parcourir et appliquer des thèmes de couleurs visuels.
set_personality et list_archetypes : Personnaliser le ton et attribuer des archétypes de persona.

Connaissances et apprentissage continu

create_document : Ajouter des documents texte directement à la base de connaissances.
update_document : Modifier le contenu des documents texte avec ajustement automatique de l’équilibre des caractères.
ingest_url : Explorer des pages web ou transcrire des liens vidéo (YouTube, TikTok, Instagram, X).
clean_document : Reformater les documents importés grâce au nettoyage Markdown par IA.
create_correction : Apprendre au chat la réponse définitive aux questions auxquelles il a mal répondu ou n’a pas répondu auparavant.

Déclencheurs et capture de prospects

list_triggers, create_trigger, update_trigger, reorder_triggers : Gérer les boutons, les liens et les sections du chat public.
generate_questions : Produire des questions suggérées pour les visiteurs à partir des documents importés.
generate_and_nest : Générer des questions et les imbriquer sous un déclencheur parent en une seule opération.

Informations et signaux

list_signals : Examiner les questions manquées (weak_answer), les réponses mal notées (thumbs_down) et les abandons de visiteurs (left_after).
list_conversations et read_conversation : Inspecter les conversations des visiteurs et les transcriptions des messages.
get_metrics, get_timeseries, get_rankings : Récupérer les statistiques d’activité et les taux de conversion.
generate_report et read_report : Générer des synthèses structurées des performances du chat.

Surveillance de l’activité et journaux d’audit

Le tableau Activité récente en bas de l’onglet Clés API journalise chaque appel MCP effectué vers votre espace de travail :

Quand : Horodatage relatif de la requête.
Clé : Préfixe de la clé utilisée (atk_...).
Outil : L’outil MCP appelé (par ex. list_chats, create_document, delete_trigger).
Cible : La ressource concernée par l’opération.
Résultat : Badge de succès (ok) ou d’erreur.

Restaurer les éléments supprimés

Si un outil supprime temporairement un déclencheur ou un contact par erreur, cliquez sur Restaurer dans la ligne d’activité pour le réintégrer immédiatement dans votre espace de travail.

​Démarrage rapide

​Claude Web et Bureau (connecteur personnalisé)

​Dépannage

​Portées des autorisations

​Exigences selon l’offre

​Capacités et outils disponibles

​Configuration du chat, image de marque et aperçu en direct

​Connaissances et apprentissage continu

​Déclencheurs et capture de prospects

​Informations et signaux

​Surveillance de l’activité et journaux d’audit

​Restaurer les éléments supprimés

Démarrage rapide

Claude Web et Bureau (connecteur personnalisé)

Dépannage

Portées des autorisations

Exigences selon l’offre

Capacités et outils disponibles

Configuration du chat, image de marque et aperçu en direct

Connaissances et apprentissage continu

Déclencheurs et capture de prospects

Informations et signaux

Surveillance de l’activité et journaux d’audit

Restaurer les éléments supprimés