Passer au contenu principal
AppSignal MCP est actuellement en aperçu. Rejoignez notre communauté Discord pour aider à tester et façonner cette implémentation.
Le Model Context Protocol (MCP) permet aux agents IA et aux éditeurs de code IA comme Claude, Cursor, Windsurf, Zed, VS Code et GitHub Copilot d’interagir avec des outils externes et des sources de données. AppSignal MCP donne à ces agents un accès direct à vos données de surveillance : erreurs, traces, logs, métriques, et plus encore. AppSignal MCP est un point de terminaison HTTP public à https://appsignal.com/api/mcp. La plupart des agents s’y connectent directement. Si vous préférez exécuter un proxy local — par exemple, dans un environnement qui restreint le trafic sortant — une image Docker optionnelle est disponible.

​
Ce à quoi vous pouvez accéder

AppSignal MCP expose un accès en lecture et en écriture à vos données de surveillance dans sept domaines. Chaque domaine correspond à une permission que vous pouvez configurer lors de l’authentification : avec un jeton MCP, définissez chaque domaine sur read, write ou désactivé ; avec OAuth, tous les outils de lecture et d’écriture sont exposés en même temps. Ce que vous récupérez dépend de ce que vos applications envoient à AppSignal. Si votre application n’envoie pas de logs, get_log_lines ne renverra rien. AppSignal MCP est une passerelle vers les données qu’AppSignal possède déjà. Il ne collecte pas de nouvelles données de lui-même.

​
Disponible maintenant

  • Incidents d’erreur (lecture + écriture) : lister et rechercher les exceptions, inspecter les traces de pile, mettre à jour l’état et la gravité, assigner des gestionnaires et ajouter des notes
  • Performance (lecture) : classer les actions les plus lentes, récupérer les traces, parcourir les arbres de spans et inspecter les attributs des spans. Basé sur des échantillons pour les applications Ruby et Elixir standard ; traces OpenTelemetry pour les applications envoyant des données OTel
  • Détection d’anomalies (lecture + écriture) : parcourir les alertes, lister les déclencheurs existants, et créer, mettre à jour ou archiver des déclencheurs
  • Logging (lecture + écriture) : interroger les lignes de log avec la syntaxe d’expression d’AppSignal, et configurer les règles d’ingestion de logs : actions de filtre, déclencheur et métriques. Particulièrement puissant pour assembler un parcours client à travers les sources de logs, les erreurs et les traces en une seule invite — voir reconstituer un parcours client
  • Métriques (lecture) : découvrir les catégories de métriques (y compris host_metrics), lister les noms et tags de métriques, et récupérer des séries temporelles ou des valeurs agrégées
  • Tableaux de bord (lecture + écriture) : créer des tableaux de bord, et ajouter ou mettre à jour des visuels de graphiques
  • Découverte d’application (lecture) : lister vos applications, environnements, namespaces, utilisateurs, notifieurs, sources de logs, actions de lignes de log et marqueurs de déploiement
Pour la liste complète des outils, paramètres et exemples d’invites, consultez la Référence des outils MCP.

​
Hors du périmètre du jeu d’outils

Quelques fonctionnalités AppSignal ne sont intentionnellement pas exposées via des outils MCP dédiés. Dans la plupart des cas, il existe déjà une meilleure façon d’accéder aux données, ou une interface en langage naturel n’est pas le bon choix pour le travail. Chaque outil exposé prend également de la place dans le contexte de votre agent, donc nous préférons garder le jeu d’outils ciblé plutôt que de refléter chaque partie de l’application.
  • Gestion des moniteurs de disponibilité : les résultats de disponibilité sont stockés sous forme de métriques (uptime_monitor_error_count et uptime_monitor_duration), donc vous pouvez déjà les interroger via les outils de métriques existants (get_metric_names, get_metric_tags, get_metrics_timeseries et get_metrics_list). Des outils dédiés pour lister ou créer des moniteurs de disponibilité ne sont pas à la feuille de route pour le moment.
  • Gestion des notifieurs, utilisateurs et marqueurs de déploiement : créer ou modifier ceux-ci nécessite des permissions de niveau propriétaire et a de réelles conséquences : une invite mal interprétée pourrait accorder l’accès à la mauvaise personne ou mal acheminer les alertes. Les opérations d’administration comme celles-ci sont mieux gérées dans l’interface AppSignal, où elles sont explicites et faciles à auditer. Vous pouvez toujours lire les notifieurs, utilisateurs et marqueurs de déploiement via get_app_resources.
  • Ingestion de métriques et de signaux personnalisés : le chemin d’ingestion d’AppSignal s’exécute sur des points de terminaison dédiés optimisés pour une livraison à haut débit, et AppSignal MCP n’est pas conçu pour pousser des données. Pour envoyer des métriques personnalisées, utilisez l’intégration AppSignal dans votre application.

​
Sur la feuille de route s’il y a de la demande

  • Interrogation des moniteurs de processus : accès en lecture aux données des moniteurs de processus cron et heartbeat. Nous aimerions évaluer l’intérêt avant d’ajouter cela.
Ce sont les positions actuelles et elles peuvent changer à mesure que la façon dont les agents fonctionnent évolue. Si vous heurtez un mur avec le jeu d’outils actuel, faites-le nous savoir dans la communauté Discord afin que nous puissions le peser par rapport à la liste.

​
Authentification

Vous avez besoin d’un compte AppSignal pour commencer. AppSignal MCP prend en charge deux méthodes d’authentification — choisissez celle qui convient à l’agent IA que vous configurez :
  • OAuth — connectez-vous avec votre compte AppSignal une seule fois. L’accès est accordé au niveau de l’application et expose tous les outils de lecture et d’écriture en même temps. Le chemin recommandé pour GitHub Copilot CLI, et la configuration la plus simple pour les éditeurs qui prennent en charge nativement les serveurs MCP distants (Claude Code, VS Code) ou qui peuvent exécuter mcp-remote comme passerelle (Cursor, Windsurf, Zed).
  • Jeton Bearer — générez un jeton MCP de longue durée avec des permissions fines par jeu d’outils. Chaque jeton peut être défini sur read, write ou désactivé par domaine, limité à des applications spécifiques, et configuré pour exposer automatiquement les nouveaux outils à mesure qu’ils sont livrés. Mieux lorsque vous souhaitez limiter ce qu’un agent peut faire.
Si vous débutez et que votre agent prend en charge OAuth, c’est le chemin le plus rapide. Si vous avez besoin de permissions par outil ou de limitation par application, générez plutôt un jeton MCP. Pour générer un jeton Bearer :
  1. Sélectionnez votre icône de profil.
  2. Allez dans Account Settings.
  3. Sélectionnez MCP Tokens pour créer un nouveau jeton.

​
Configuration

Configurez AppSignal MCP dans les paramètres de votre agent IA en utilisant le point de terminaison HTTP https://appsignal.com/api/mcp. Chaque section ci-dessous comporte des onglets pour OAuth et jeton Bearer — choisissez celui que vous avez configuré ci-dessus.
La prise en charge OAuth est nouvelle dans nos éditeurs pris en charge. Si l’onglet OAuth génère une erreur pour votre éditeur, repassez à l’onglet jeton Bearer et faites-le nous savoir dans notre communauté Discord afin que nous puissions resserrer ces instructions.

​
Claude Code

claude mcp add --transport http appsignal https://appsignal.com/api/mcp
Avec OAuth, Claude Code lance le flux de connexion basé sur le navigateur la première fois que les outils AppSignal sont invoqués. Consultez la documentation MCP de Claude Code pour les indicateurs de transport et la référence CLI.

​
Cursor

Modifiez ~/.cursor/mcp.json : 
{
  "mcpServers": {
    "appsignal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"]
    }
  }
}
La configuration OAuth utilise mcp-remote comme passerelle locale vers le point de terminaison HTTP. Le flux de connexion basé sur le navigateur s’ouvre la première fois que Cursor se connecte. Consultez la documentation MCP de Cursor pour le schéma complet.

​
Windsurf

Modifiez ~/.codeium/windsurf/mcp_config.json : 
{
  "mcpServers": {
    "appsignal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"]
    }
  }
}
Consultez la documentation MCP de Windsurf pour le schéma complet et les notes OAuth.

​
Zed

Ouvrez votre fichier de paramètres Zed et ajoutez la section context_servers : 
{
  "context_servers": {
    "appsignal": {
      "settings": {},
      "enabled": true,
      "url": "https://appsignal.com/api/mcp"
    }
  }
}
Lorsque l’en-tête Authorization est omis, Zed initie le flux OAuth MCP standard contre AppSignal. Consultez la documentation MCP de Zed pour le schéma complet de context_servers.

​
VS Code

Si vous exécutez GitHub Copilot et que vous êtes connecté sous un compte d’entreprise, assurez-vous de définir « MCP servers in Copilot » sur « Enabled » dans les paramètres de votre organisation > Copilot > Policies. Paramètres GitHub Copilot Ajoutez ceci à votre .vscode/mcp.json : 
{
  "servers": {
    "appsignal": {
      "type": "http",
      "url": "https://appsignal.com/api/mcp"
    }
  }
}
Avec OAuth, VS Code initie le flux de connexion la première fois que les outils AppSignal sont utilisés. Consultez la documentation MCP de VS Code pour les variables d’entrée et les en-têtes.

​
GitHub Copilot CLI

Le GitHub Copilot CLI utilise OAuth pour l’authentification MCP. Exécutez ce qui suit pour ajouter AppSignal :
Bash
copilot mcp add appsignal https://appsignal.com/api/mcp
Suivez l’invite OAuth pour autoriser AppSignal. Une fois connecté, les outils AppSignal seront disponibles dans les sessions Copilot CLI. Consultez la documentation MCP de GitHub Copilot CLI pour le flux interactif /mcp add et l’emplacement du fichier de configuration.

​
Obtenir de l’aide

Nous vous encourageons à rejoindre notre communauté Discord où vous pouvez :
  • Obtenir de l’aide pour la configuration d’AppSignal MCP
  • Partager des retours et des suggestions
  • Vous connecter avec d’autres développeurs utilisant AppSignal MCP
  • Rester à jour sur les nouvelles fonctionnalités et améliorations
Recherchez le canal dédié #mcp où notre équipe surveille activement et répond aux questions.