Aller au contenu

Serveur MCP Canopsis

Présentation

Le Model Context Protocol (MCP) est un protocole ouvert qui permet à un assistant IA (agent de code, chat, IDE...) de découvrir et d’appeler des outils exposés par un service tiers, de façon standardisée.

canopsis-mcp-server est un service Canopsis qui expose une partie du périmètre alarmes de Canopsis (consultation et actions courantes) à tout client compatible MCP : IDE, CLI agentique, assistant de chat, plateforme d’agents...

Techniquement, il s’agit d’un sidecar HTTP : un binaire autonome, déployé à côté de canopsis-internal-api, qui traduit les appels MCP en appels REST vers l’API Canopsis existante. Il n’ajoute aucune logique métier propre : c’est un adaptateur fin qui réutilise l’authentification, les permissions et les règles de validation déjà en place côté API.

Cette page rassemble tout ce qui concerne ce service : comment l’installer et le configurer, son modèle de sécurité, la liste des outils et ressources qu’il expose, puis, pour chaque client MCP supporté, comment s’y connecter.

Architecture

flowchart TB subgraph Clients["Clients MCP"] direction LR C1[VS Code] C2[GitHub Copilot CLI] C3[Claude Code / Claude Desktop] C4[Codex CLI / ChatGPT] C5[Copilot Studio] end Clients -->|"HTTP Streamable<br/>Authorization: Bearer authkey"| M[canopsis-mcp-server] M -->|"REST /internal/...<br/>+ en-têtes d'audit MCP"| A[Canopsis]

Le serveur MCP ne stocke ni ne valide de jeton lui-même : il relaie l’en-tête Authorization reçu du client vers l’API Canopsis, qui reste seule responsable de l’authentification et des permissions. Voir Sécurité et audit pour le détail.

Ce que le serveur expose

  • 8 outils (tools) : 5 en écriture (création/mise à jour d’alarme) et 3 en lecture. Voir le détail dans Référence des outils et ressources.
  • 3 ressources (resources) en lecture seule, adressées par une URI canopsis://alarms/....

Un commutateur global ("kill switch") permet de désactiver tous les outils d’écriture à chaud tout en conservant les outils et ressources de lecture actifs. Voir Sécurité et audit.

Portée de la version 1

Inclus :

  • create_alarm, ack_alarm, comment_alarm, snooze_alarm, associate_ticket_to_alarm
  • get_alarm_by_id, get_alarm_by_entity, search_alarms (mêmes sémantiques de filtrage que GET /internal/alarms)

Hors périmètre pour la v1 (pistes évoquées pour une version ultérieure) :

  • Workflow de validation humaine avant exécution d’une action ("approval workflow")
  • Orchestration transactionnelle multi-étapes avec retour arrière (rollback)
  • Mutations d’alarmes en masse (bulk)
  • Contrôles avancés de politique ou de limitation de débit, au-delà des protections déjà en place côté API

Dans cette section

Page Contenu
Installation et configuration Installer et démarrer le service (paquet RPM ou image Docker), fichier config.yml, variables d’environnement
Sécurité et audit Authentification, permissions, kill switch, en-têtes d’audit, recommandations d’exposition réseau
Référence des outils et ressources Détail de chaque tool/resource, format des réponses, taxonomie d’erreurs
Visual Studio Code Connexion depuis GitHub Copilot Chat dans VS Code
GitHub Copilot CLI Connexion depuis le CLI Copilot autonome
Microsoft 365 Copilot et Copilot Studio Déclarer le serveur comme outil d’un agent Copilot Studio
Claude Code Connexion depuis le CLI Claude Code
Claude Desktop Connexion depuis l’application de bureau Claude
Codex CLI et ChatGPT Connexion depuis Codex CLI, l’extension IDE Codex et l’application de bureau ChatGPT
Dépannage Points de contrôle en cas de connexion ou d’appel en échec

Assistant IA de Canopsis

L'assistant IA intégré à Canopsis peut lui aussi utiliser ce serveur MCP comme source d'outils, avec les modèles Gemini et OpenAI. Cette configuration se fait sur le modèle LLM et est documentée dans la page LLMs, plutôt que dans cette section, qui couvre la connexion de clients MCP externes.