# Intégration de modèles (MCP/Agent)

Cet article vous explique comment connecter FIRERPA aux grands modèles de langage (basé sur MCP ou des commandes). FIRERPA a implémenté en interne le protocole serveur MCP ainsi que la fonctionnalité native `tool-call` d'OpenAI, vous permettant d'écrire vos propres plugins MCP et de les servir via le port standard 65000, ou d'hériter de la classe `Agent` pour implémenter des appels `tools` entièrement automatiques.

## Commande Agent intégrée

Avec la commande `agent` intégrée, vous pouvez rapidement accomplir des tâches en langage naturel via un grand modèle de langage. Elle prend en charge n'importe quel fournisseur de services compatible avec l'API OpenAI + `toolcall` ou des services auto-hébergés. En combinaison avec le `crontab` intégré, vous pouvez programmer l'exécution de tâches en langage naturel.

```{hint}
La commande `agent` doit être utilisée dans le terminal intégré, et vous devez fournir une API et une clé valides. Les performances peuvent varier entre les différents grands modèles de langage, veuillez choisir celui qui vous convient le mieux. Nous recommandons gemini, openai, deepseek, glm, etc.
```

| Nom du paramètre | Type | Requis | Valeur par défaut | Description |
| :--- | :--- | :--- | :--- | :--- |
| `--api` | Chaîne (str) | Oui | - | Point de terminaison de l'API |
| `--model` | Chaîne (str) | Oui | - | Nom du modèle |
| `--temperature` | Flottant (float) | Non | `0.2` | Température d'échantillonnage du modèle |
| `--key` | Chaîne (str) | Oui | - | Clé d'API pour l'authentification |
| `--vision` | Booléen (bool) | Non | `False` | Activer le mode vision |
| `--imsize` | Entier (int) | Non | `1000` | Taille de l'image en mode vision |
| `--prompt` | Chaîne (str) | Oui | - | Instruction à exécuter par l'agent (Agent) |
| `--max-tokens` | Entier (int) | Non | `16384` | Nombre maximal de tokens à générer |
| `--step-delay` | Flottant (float) | Non | `0.0` | Délai entre les étapes |

```{attention}
Il est important de noter que l'adresse du paramètre API est l'adresse complète, et non la `base_url`. Généralement, il faut ajouter `/chat/completions` après la `base_url` pour former l'adresse API complète.
```

Une fois que vous avez les informations nécessaires, vous pouvez entrer la commande suivante dans le terminal du bureau à distance pour que l'IA contrôle automatiquement votre appareil.

```bash
agent --api https://generativelanguage.googleapis.com/v1beta/openai/chat/completions --key VOTRE_CLÉ_API --model gemini-2.5-flash --prompt "Aide-moi à ouvrir l'application Paramètres, nom du package com.android.settings, trouver les paramètres réseau et activer le mode avion"
```

Si votre invite de tâche est trop longue, vous pouvez également la fournir au modèle via un fichier.

```bash
agent --api https://generativelanguage.googleapis.com/v1beta/openai/chat/completions --key VOTRE_CLÉ_API --model gemini-2.5-flash --prompt /chemin/vers/prompt.txt
```

## Intégration de Claude & Cursor (MCP)

Cette section explique comment intégrer la fonctionnalité MCP de FIRERPA à votre client de grand modèle de langage. Nous fournissons des exemples uniquement pour Claude et Cursor, mais vous pouvez l'utiliser avec n'importe quel autre client prenant en charge le protocole MCP.

```{note}
Le service MCP intégré de FIRERPA prend en charge `tool-call`, `resource-read`, les `prompts`, ainsi que les notifications de progression et les journaux.
```

```{attention}
Veuillez noter que les protocoles de communication des serveurs 8.0 et 9.0 sont différents : 9.x utilise `streamable-http`, tandis que 8.x utilise `sse`.
```

### Installer l'extension officielle

Nous fournissons un service MCP officiel. Vous pouvez télécharger ce module d'extension sur <a href="https://github.com/firerpa/lamda/blob/HEAD/extensions/firerpa.py" target="_blank">extensions/firerpa.py</a>. Vous pouvez également vous référer à sa méthode d'écriture pour créer ou étendre vous-même les fonctionnalités du plugin. Après avoir téléchargé le script du plugin d'extension, téléversez-le dans le répertoire `/data/usr/modules/extension` de l'appareil via le bureau à distance ou un `push` manuel, puis redémarrez l'appareil ou le service FIRERPA.

```{attention}
Les scripts d'extension pour la version 8.0 et la version 9.0 ne sont pas compatibles. Veuillez vérifier attentivement la version de votre serveur et récupérer le script correspondant depuis la branche GitHub appropriée.
```

### Utiliser l'extension officielle

Pour **Claude**, vous devez d'abord accéder à la page des paramètres de Claude et suivre les étapes illustrées ci-dessous. Ensuite, suivez les instructions pour modifier le fichier de configuration `claude_desktop_config.json` de Claude et y ajouter la configuration de service MCP JSON suivante.


```json
{"mcpServers": {"firerpa": {"command": "npx", "args": ["-y", "supergateway", "--streamableHttp", "http://192.168.0.2:65000/firerpa/mcp/"]}}}
```

<p align="center">
<img src="/assets/images/claude-settings.png" alt="Exemple" width="auto">
</p>

Pour **Cursor**, vous devez ouvrir les Paramètres de Cursor (Cursor Settings), suivre les étapes illustrées et entrer la configuration suivante.

```json
{"mcpServers": {"firerpa": {"url": "http://192.168.0.2:65000/firerpa/mcp/"}}}
```

<p align="center">
<img src="/assets/images/cursor-settings.png" alt="Exemple" width="auto">
</p>

```{attention}
Veuillez vous assurer de remplacer le lien dans la configuration par l'adresse IP de votre propre appareil.
```

### Écrire une extension MCP

```{hint}
Documentation bientôt disponible.
```