gilbert-mcp

Serveur Model Context Protocol (MCP) officiel de Gilbert.

Permet à Claude Desktop, Claude Code, Cursor, VS Code, Zed, Continue et tous les clients compatibles MCP d'accéder aux réunions, transcriptions et synthèses Gilbert d'un utilisateur — en lecture seule.

Installation rapide

Toutes les configs partagent la même commande : npx -y gilbert-mcp avec la variable GILBERT_API_KEY.

Claude Desktop

Éditez le fichier de configuration :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

config.json

{
  "mcpServers": {
    "gilbert": {
      "command": "npx",
      "args": ["-y", "gilbert-mcp"],
      "env": {
        "GILBERT_API_KEY": "glbrt_live_XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Redémarrez Claude Desktop. Vous pouvez maintenant demander :

« Liste mes réunions terminées cette semaine » « Résume-moi la réunion du 12 avril » « Trouve-moi la réunion où on a parlé de budget Q3 »

Claude Code

Terminal

claude mcp add gilbert --env GILBERT_API_KEY=glbrt_live_XXX -- npx -y gilbert-mcp

Cursor

Settings > Features > Model Context Protocol > Add MCP Server :

config.json

{
  "name": "gilbert",
  "command": "npx",
  "args": ["-y", "gilbert-mcp"],
  "env": { "GILBERT_API_KEY": "glbrt_live_XXXXXXXXXXXXXXXXXXXXXXXX" }
}

VS Code

.vscode/mcp.json (ou la commande MCP: Add Server) :

config.json

{
  "servers": {
    "gilbert": {
      "command": "npx",
      "args": ["-y", "gilbert-mcp"],
      "env": { "GILBERT_API_KEY": "glbrt_live_XXXXXXXXXXXXXXXXXXXXXXXX" }
    }
  }
}

Zed

Dans settings.json, sous context_servers :

config.json

{
  "context_servers": {
    "gilbert": {
      "command": { "path": "npx", "args": ["-y", "gilbert-mcp"], "env": { "GILBERT_API_KEY": "glbrt_live_XXX" } }
    }
  }
}

Docker (alternative)

Terminal

docker build -t gilbert-mcp .
docker run --rm -i -e GILBERT_API_KEY=glbrt_live_XXX gilbert-mcp

Obtenir une clé API

Contactez votre administrateur Gilbert pour qu'il génère une clé depuis la console admin. Scope minimum requis : meetings:read (lecture seule).

Tools exposés

Tous les tools sont en lecture seule (readOnlyHint).

Tool	Description
`list_meetings`	Liste paginée, filtres par statut/date
`get_meeting`	Détail complet d'une réunion (metadata + transcription + synthèse)
`get_transcript`	Transcription texte seule
`get_summary`	Synthèse markdown seule
`search_meetings`	Recherche full-text
`list_folders`	Liste les dossiers (nom + nombre de réunions)
`get_folder_meetings`	Réunions d'un dossier (et sous-dossiers)

Le contenu partagé avec l'utilisateur (réunions/dossiers d'autres personnes) n'est accessible que si la clé API porte le scope shared:read. Par défaut, une clé ne voit que le contenu de son propriétaire.

Variables d'environnement

GILBERT_API_KEY (requis) : clé au format glbrt_live_...
GILBERT_BASE_URL (optionnel) : défaut https://gilbert-assistant.ovh/api/v1

Confidentialité & sécurité

Ce serveur expose des transcriptions et synthèses de réunions (données potentiellement sensibles). Il s'exécute localement en stdio, n'ouvre aucun port entrant, ne journalise jamais la clé API et n'écrit aucune donnée de réunion sur disque. Voir SECURITY.md.

Développement

bash

git clone https://github.com/HugoF1234/Gilbert-mcp
cd Gilbert-mcp
npm install
GILBERT_API_KEY=glbrt_live_... npm run dev   # stdio
npm test                                     # build + smoke test (handshake MCP)

Voir CONTRIBUTING.md pour le process de release et docs/SUBMISSION.md pour le référencement dans les catalogues.

Licence

Support

Documentation API : https://gilbert-assistant.ovh/api/v1/docs
Contact : contact@lexiapro.fr