# MCP Trello

Copie du serveur Trello déjà utilisé : **`mcp-server-trello` version 1.0.4**. Le code du paquet installé est repris sans modification. Les clés personnelles ne sont pas incluses.

Ce dépôt contient le serveur JavaScript déjà compilé dans `build/`, son `package.json` original, sa documentation originale dans [README.upstream.md](README.upstream.md), sa [licence d'origine](LICENSE.upstream), et les exemples de configuration ci-dessous. Aucun lanceur supplémentaire n'est nécessaire.

## 1. Préparer Node.js

Installez Node.js avec npm, puis vérifiez :

```sh
node --version
npm --version
```

Utilisez une version LTS maintenue. Sous Windows, si PowerShell bloque `npm.ps1`, appelez `npm.cmd` ou `npx.cmd`.

## 2. Obtenir sa clé et son token Trello

Connectez-vous à Trello puis ouvrez la [gestion des Power-Ups](https://trello.com/power-ups/admin). Créez un Power-Up ou ouvrez celui que vous utilisez déjà. Dans l'onglet **API Key**, générez ou récupérez la clé API.

Utilisez ensuite le lien **Token** proposé par Trello pour autoriser votre compte. Vous pouvez aussi ouvrir cette adresse après avoir remplacé `VOTRE_CLE_API` localement :

```text
https://trello.com/1/authorize?expiration=30days&name=MCP%20Trello&scope=read,write&response_type=token&key=VOTRE_CLE_API
```

Cet exemple autorise la lecture et l'écriture pendant 30 jours. `scope=read` suffit pour la lecture seule. Conservez la clé et le token dans votre configuration personnelle. La procédure et les options sont décrites dans la [documentation officielle Trello](https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/).

## 3. Utiliser le serveur comme dans la configuration existante

La commande utilisée est :

```sh
npx -y mcp-server-trello
```

Le client MCP exécute cette commande avec les deux variables `TRELLO_API_KEY` et `TRELLO_TOKEN`. `npx` télécharge le paquet si nécessaire. Pour demander précisément la version copiée dans ce dépôt, utilisez `mcp-server-trello@1.0.4` à la place de `mcp-server-trello`.

### Configuration Codex

Adaptez [codex.example.toml](codex.example.toml) dans votre fichier personnel `~/.codex/config.toml` (sous Windows : `%USERPROFILE%\.codex\config.toml`). Si une section `trello` existe, modifiez-la sans en créer une seconde.

```toml
[mcp_servers.trello]
command = "npx"
args = ["-y", "mcp-server-trello"]

[mcp_servers.trello.env]
TRELLO_API_KEY = "VOTRE_CLE_API"
TRELLO_TOKEN = "VOTRE_TOKEN_TRELLO"
```

Sous Windows, utilisez `npx.cmd` ou le chemin absolu renvoyé par `Get-Command npx.cmd` si nécessaire. Les exemples utilisent des chemins portables au lieu du chemin personnel de l'installation d'origine. Redémarrez le serveur MCP ou le client après modification. Voir la [documentation MCP de Codex](https://developers.openai.com/codex/mcp).

### Configuration JSON pour Claude et les clients compatibles

Le fichier [mcp.example.json](mcp.example.json) contient cette entrée à intégrer à la configuration MCP personnelle de votre client :

```json
{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "mcp-server-trello"],
      "env": {
        "TRELLO_API_KEY": "VOTRE_CLE_API",
        "TRELLO_TOKEN": "VOTRE_TOKEN_TRELLO"
      }
    }
  }
}
```

Remplacez les valeurs uniquement dans votre configuration locale, puis redémarrez le client. Ne publiez pas cette copie remplie.

## 4. Exécuter directement la copie de ce dépôt

Cette alternative utilise le code `build/` présent ici :

```sh
git clone https://github.com/iamarketings/mcp-trello.git
cd mcp-trello
npm install --omit=dev --ignore-scripts
```

Le paquet d'origine conserve ses scripts de compilation, mais les sources TypeScript ne sont pas incluses dans sa distribution npm. `--ignore-scripts` évite de tenter de recompiler cette copie déjà compilée. Il ne faut pas lancer `npm run build` ici.

Dans la configuration MCP, gardez les mêmes variables `env`, remplacez `command` par `node` et `args` par le chemin absolu du fichier :

```json
"command": "node",
"args": ["C:/chemin/vers/mcp-trello/build/index.js"]
```

Sur macOS/Linux, utilisez le chemin absolu correspondant. Les accès viennent des variables d'environnement transmises par le client ; ce serveur ne charge pas automatiquement un fichier `.env`.

## 5. Vérifier dans le client

Demandez : « Liste mes tableaux Trello ». Vous pourrez ensuite afficher les listes et cartes, créer ou déplacer des cartes, gérer les membres et les étiquettes.

`TRELLO_BOARD_ID` peut être ajouté dans `env` comme tableau par défaut. Il est facultatif ; vous pouvez aussi utiliser `list_boards` puis `set_active_board`, ou fournir un `boardId` aux outils. Les droits restent ceux du compte et du token.

Le serveur communique en **STDIO** : le client lance un processus local. Il n'ouvre pas un site web. GitHub héberge cette copie du code et les explications d'installation.

## 6. Comment cette copie a été préparée et publiée

1. Reprendre l'entrée Trello configurée : `npx -y mcp-server-trello`.
2. Identifier sa version installée : `1.0.4`.
3. Copier les 21 fichiers du paquet installé, sans changer le code. La documentation et la licence d'origine sont renommées `README.upstream.md` et `LICENSE.upstream` pour conserver le README français et la licence déjà présents dans le dépôt GitHub.
4. Copier la structure de configuration en remplaçant les accès par des valeurs d'exemple et le chemin personnel de `npx` par sa commande portable.
5. Exclure les fichiers privés du dépôt et vérifier l'absence des clés personnelles avant l'envoi.
6. Enregistrer et publier les fichiers :

```sh
git add README.md README.upstream.md LICENSE.upstream package.json build .gitignore codex.example.toml mcp.example.json
git commit -m "Copy existing Trello MCP server and document setup"
git push origin main
```

Les clés ne sont ni dans cette copie ni dans les exemples. `.gitignore` exclut les configurations locales usuelles et les dépendances installées.

## Origine

Le serveur tiers est distribué sur [npm sous le nom mcp-server-trello](https://www.npmjs.com/package/mcp-server-trello/v/1.0.4). Son `package.json` désigne Jarad DeLorenzo comme auteur et [Infall-Insurance/mcp-server-trello](https://github.com/Infall-Insurance/mcp-server-trello) comme dépôt d'origine. Ces informations et sa licence MIT sont conservées telles quelles ; cette copie ne revendique pas la création du moteur.