---
tags: note
type: "note"
nature: concept             # Options : portrait, lieu, info, concept, script, process, tuto, none
ressource: false
univers: PERSO
projects:
  - "[[03_PROJETS/VPS-IA]]"
date: "[[01_JOURNAL/2026/2026-10-10]]"
priority: 10
---
# Note de synthèse : API, MCP et Skills dans les architectures IA

## 1\. Vue d'ensemble et architecture en couches

L'intégration d'une application métier avec un modèle de langage (LLM) repose sur une séparation claire des responsabilités à trois niveaux : la technique, les fonctionnalités et la méthode.

```excalidraw
url:00_INBOX/API-MCP-Skills_complementarite.excalidraw
height:500px
```


## 2\. Comparatif des composantes

| **Composante** | **Rôle principal** | **Nature** | **Niveau d'abstraction** |
| --- | --- | --- | --- |
| **API REST / OpenAPI** | Exposer les capacités système et la persistance des données. | Spécification / Documentation technique (JSON/YAML passif). | **Bas niveau** (technique, granulaire). |
| **MCP (Model Context Protocol)** | Fournir à l'IA une interface d'exécution sécurisée et prête à l'emploi. | Serveur d'outils dynamique (JSON-RPC via Stdio/SSE). | **Moyen niveau** (boutons fonctionnels). |
| **Skill** | Guider le raisonnement et la méthodologie de l'IA. | Consignes en langage naturel (Prompt / Markdown). | **Haut niveau** (processus, règles métier). |

## 3\. Détail des responsabilités

### A. API REST & OpenAPI (Le Moteur)

* **Définition :** OpenAPI décrit les contrats d'interface techniques de l'application (`GET /users/{id}`, `POST /invoices`).
* **Inconvénient pour l'IA :** Une spécification OpenAPI complète peut comporter des milliers de lignes, saturant inutilement la fenêtre de contexte du modèle. De plus, OpenAPI décrit des données mais n'exécute aucun appel HTTP par lui-même.

### B. Le MCP (Le Tableau de bord)

* **Définition :** Le MCP encapsule l'API sous forme d'outils (*Tools*) exécutables par l'agent IA.
* **Valeur ajoutée :**
    * **Combinaison d'actions :** Un outil MCP peut masquer la complexité en enchaînant plusieurs requêtes HTTP unitaires en un seul appel déterministe (ex: `creer_et_envoyer_facture()`).
        * **Gestion de la mémoire et sécurité :** Il n'expose que les fonctions nécessaires à l'IA et masque les clés d'API dans ses variables d'environnement.
    
### C. Le Skill (Le Manuel de pilotage)

* **Définition :** Fichier de directives ou prompt système qui explique à l'IA *quand*, *dans quel ordre* et *sous quelles conditions* utiliser les outils MCP.
* **Valeur ajoutée :** Il apporte du jugement métier (ex: *"Si le montant dépasse 1 000 €, demande d'abord confirmation avant d'actionner l'outil d'envoi"*).

## 4\. Exemple applicatif : Clôture de projet

Sur un système de facturation :

1. **API REST :**
* `GET /projects/{id}/hours` (récupère le relevé d'heures)
* `POST /invoices` (génère la facture brute)
* `POST /emails/send` (expédie le mail)

2. **MCP :**
* Fournit l'outil `generer_et_expedier_facture(projet_id)`. Le MCP traite la logique applicative sous le capot et renvoie un résultat simple : `{"status": "ok", "invoice_id": "FAC-2026-098"}`.

3. **Skill :**
* Contient les instructions métier : *"Pour clôturer un projet, contrôle le solde des heures, demande au MCP de générer la facture, puis mets à jour le statut du projet dans Silverbullet."*
    
## 5\. Synthèse

* **L'API** fournit l'accès technique aux données.
* **Le MCP** transforme les routes techniques en actions fonctionnelles simples et sécurisées.
* **Le Skill** donne à l'IA l'intelligence et le workflow pour accomplir sa mission (processus).