# Connectez une IA à votre projet

Configurez MCP et une clé API pour qu'un agent puisse lire ou modifier les modèles de projet.

Vous pouvez laisser l'IA inspecter la structure du modèle, expliquer les entrées ou modifier une conception dans votre projet via **MCP (bêta)**. La connexion expose les outils Tembuilder à votre application d'IA ; une clé API du projet détermine les opérations qu'il peut effectuer.

## 1. Choisissez la connexion pour votre tâche

Tembuilder fournit deux connexions MCP :

| Connexion | Objectif | Clé requise |
| --- | --- | --- |
| Documents MCP · `/docs/mcp` | Rechercher et lire la documentation publique. | Non. |
| Projet MCP · `/mcp` | Lisez ou modifiez les modèles de projet et Assets. | Oui. |

Pour les questions de documentation, ajoutez un serveur sur `https://<api-host>/docs/mcp` à votre application AI sans clé API. Utilisez l'hôte API affiché sur la page **MCP (bêta)** de votre projet. Les étapes ci-dessous configurent le projet MCP.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Docs MCP lit les conseils · Le projet MCP travaille sur des modèles">
<div class="sim-stage"><div class="ds-columns"><div class="sim-panel"><div class="ds-head"><strong>Documents MCP</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>/docs/mcp</span><small>Guides publics</small></div><div class=""><span>Touche API</span><small>Non requis</small></div></div></div><div class="sim-panel"><div class="ds-head"><strong>Projet MCP</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>/mcp</span><small>Modèles · Assets</small></div><div class=""><span>Touche API</span><small>À l'échelle du projet</small></div></div></div></div></div>
<figcaption>Docs MCP lit les conseils · Le projet MCP travaille sur des modèles</figcaption>
</figure>

## 2. Créer une clé de projet API

Dans le projet prévu, ouvrez **API Keys** et créez une clé avec les autorisations appropriées :

- `mcp:read` : inspectez les modèles, les ressources et le contexte de création.
- Ajoutez `mcp:write` : autorisez la création, la copie et la sauvegarde via des outils d'écriture.

La clé détermine à quel projet l'IA peut accéder. Mettez-le dans la configuration de connexion de votre application IA ; il n'est pas nécessaire qu'il apparaisse dans votre invite d'édition.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Touches API → mcp:read · ajouter mcp:write pour l'édition">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Touches API · MCP</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class=""><span>mcp:lire</span><small>Lire le contenu</small></div><div class="sim-focus"><span>mcp:écrire</span><small>Créer et enregistrer des modifications</small></div></div></div></div>
<figcaption>Touches API → mcp:read · ajouter mcp:write pour l'édition</figcaption>
</figure>

## 3. Ajoutez le serveur à votre application IA

Ouvrez les paramètres MCP ou les connexions d'outils dans votre application AI. Utilisez le point de terminaison affiché sur la page **MCP (bêta)** de votre projet et un en-tête `ApiKey`. Exemple de configuration :

```json
{
  "mcpServers": {
    "tembuilder-project": {
      "url": "https://<api-host>/mcp",
      "headers": { "ApiKey": "<YOUR_API_KEY>" }
    }
  }
}
```

Ceci est un exemple de configuration HTTP à distance ; l'emplacement des paramètres et le format exact dépendent du client. Le point de terminaison utilise l'origine API plutôt que l'URL du tableau de bord. Les clients utilisant l'autorisation doivent envoyer `Authorization: ApiKey ...`, plutôt que Bearer.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Page MCP → copier le point de terminaison et configurer la connexion">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>MCP · Projet</strong><div class="wf-actions"></div></div><div class="ds-code sim-focus"><code>https://&lt;api-host&gt;/mcp</code><code>ApiKey: &lt;YOUR_API_KEY&gt;</code></div></div></div>
<figcaption>Page MCP → copier le point de terminaison et configurer la connexion</figcaption>
</figure>

## 4. Commencez par lire un modèle

Après vous être connecté, essayez cette requête :

> Lisez les capacités et listez les modèles du projet. Pour le modèle que je sélectionne, expliquez sa structure et Parameters sans changer le contenu.

Une fois que l'IA a trouvé le modèle souhaité, décrivez la modification souhaitée et demandez-lui d'inspecter un aperçu avant de l'enregistrer. Ouvrez ensuite le modèle dans l'éditeur pour examiner son contenu et ses données.

Le projet MCP prend en charge la création, l'édition et les aperçus visuels de modèles. Pour utiliser les modifications dans un PDF final, [enregistrez et publiez dans l'application](/docs/fr/publishing/save-publish/), puis [exécutez un render](/docs/fr/renders/preview-render/). MCP ne dispose d'aucun outil de publication ou de travaux PDF conservés.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="workspace_capabilities → template_list → template_context">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>MCP · outils</strong><div class="wf-actions"></div></div><div class="wf-tools"><div class="wf-tool"><small>01</small><code>workspace_capabilities</code><span>Capacités de connexion</span></div><div class="wf-tool"><small>02</small><code>template_list</code><span>Rechercher des modèles de projet</span></div><div class="wf-tool"><small>03</small><code>template_context</code><span>Structure de révision et de modèle</span></div><div class="wf-tool sim-focus"><small>04</small><code>template_read</code><span>Sources ou schéma pertinents</span></div></div></div></div>
<figcaption>workspace_capabilities → template_list → template_context</figcaption>
</figure>