Skip to main content
AppSignal MCP est un point de terminaison HTTP public à https://appsignal.com/api/mcp. Authentifiez-vous une fois, puis ajoutez le point de terminaison à votre outil d’IA en suivant les instructions pour votre éditeur ou application.

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. La configuration la plus simple pour chaque agent de ce guide : chacun se connecte directement au point de terminaison.
  • 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.
Le formulaire du jeton comporte deux longues listes de cases à cocher : les applications auxquelles limiter le jeton, et les permissions à exposer. Chaque liste dispose d’une bascule Select all dans son en-tête qui coche ou décoche toutes les cases d’un coup.

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é dans la section Authentification.
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

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.

Claude app

L’application Claude — Claude.ai sur le web, ainsi que les applications de bureau et mobiles — se connecte à AppSignal MCP en tant que connecteur personnalisé via OAuth. Il n’y a pas d’option de jeton Bearer dans l’application.
  1. Dans Claude, ouvrez Settings, puis Connectors.
  2. Sélectionnez Browse, recherchez appsignal et ouvrez le connecteur AppSignal. S’il n’est pas répertorié, sélectionnez plutôt Add custom connector et saisissez l’URL https://appsignal.com/api/mcp.
  3. Sélectionnez Connect, puis effectuez la connexion à AppSignal lorsque vous y êtes invité.
  4. Démarrez une conversation et essayez une invite telle que « Lister mes applications AppSignal ». Vous pouvez connecter ou déconnecter AppSignal à tout moment depuis Settings → Connectors.
Les connecteurs personnalisés sont disponibles sur les plans Free, Pro, Max, Team et Enterprise ; Free est limité à un seul connecteur personnalisé. Sur Team et Enterprise, un administrateur de l’organisation gère les connecteurs disponibles. Consultez le guide des connecteurs personnalisés de Claude pour plus de détails.

Cursor

Ajoutez AppSignal depuis les paramètres de Cursor, ou en modifiant mcp.json directement. Pour l’ajouter depuis l’interface des paramètres :
  1. Ouvrez les paramètres de Cursor.
  2. Ouvrez l’onglet Customize, sélectionnez MCPs, puis sélectionnez + Add New MCP Server.
  3. Sélectionnez User, saisissez les valeurs ci-dessous dans le fichier JSON qui s’ouvre, puis enregistrez votre configuration.
Sélectionner User écrit dans ~/.cursor/mcp.json et rend AppSignal disponible partout. Le menu déroulant liste aussi vos workspaces ouverts sous Workspaces ; en choisir un écrit plutôt .cursor/mcp.json dans ce workspace, que vous pouvez committer pour que votre équipe le récupère.
Cursor se connecte au point de terminaison en streamable HTTP dans les deux cas. La différence réside dans la manière d’autoriser :
  • OAuth : laissez headers de côté. Cursor ouvre un onglet de navigateur où vous accordez l’accès et choisissez les scopes d’autorisation, puis termine la connexion.
  • Jeton Bearer : incluez l’en-tête Authorization. Cursor autorise avec les scopes configurés sur le jeton et se connecte sans ouvrir d’onglet.
Dans les deux cas, appsignal apparaît sous Connected dans la liste des MCPs avec un indicateur vert et un nombre d’outils une fois que ça fonctionne. Consultez la documentation MCP de Cursor pour le schéma complet.

Devin

Devin, anciennement Windsurf, se connecte à AppSignal depuis sa Cascade MCP marketplace. Vous pouvez modifier directement son fichier ~/.codeium/windsurf/mcp_config.json, ou suivre ces étapes depuis l’interface :
  1. Exécutez Devin: Cascade MCP Registry depuis la palette de commandes pour ouvrir la Cascade MCP marketplace.
  2. Sélectionnez Add custom MCP.
  3. Saisissez les valeurs ci-dessous dans le mcp_config.json qui s’ouvre, puis enregistrez.
  4. Sélectionnez le contrôle d’actualisation à côté du serveur pour le recharger.
AppSignal apparaît alors sous Installed comme Enabled, avec le nombre d’outils qu’il expose.
JSON Bearer token
Devin traite une entrée serverUrl comme un serveur streamable HTTP. L’entrée ci-dessus autorise avec un jeton MCP. Pour utiliser OAuth à la place, laissez headers de côté et Devin ouvre la connexion par navigateur lorsqu’il se connecte. Consultez la documentation MCP de Devin pour plus d’options de configuration.

Zed

Ajoutez AppSignal depuis les paramètres de Zed, ou en modifiant le fichier de paramètres directement. Pour l’ajouter depuis l’interface des paramètres :
  1. Ouvrez Settings → AI → General → MCP servers → Configure, ou exécutez agent: open settings depuis la palette de commandes (Cmd+Shift+P) et sélectionnez MCP servers.
  2. Sélectionnez Add server, puis Add remote server.
  3. Saisissez appsignal comme nom et https://appsignal.com/api/mcp comme URL.
  4. Si vous utilisez un jeton plutôt qu’OAuth, ajoutez un en-tête Authorization.
Pour modifier le fichier à la place, ouvrez la palette de commandes, exécutez zed: open settings file, et ajoutez une section context_servers :
Lorsque l’en-tête Authorization est omis, Zed initie le flux OAuth MCP standard contre AppSignal et met en cache la session dans votre porte-clés, afin que vous ne vous connectiez qu’une seule fois. Zed applique les changements de paramètres sans redémarrage. Consultez la documentation MCP de Zed pour le schéma complet de context_servers.

VS Code

Si vous utilisez GitHub Copilot sous un compte d’entreprise, assurez-vous que MCP servers in Copilot est défini sur Enabled dans les paramètres de votre organisation (Settings → Copilot → Policies → Features → MCP servers in Copilot). Ajoutez AppSignal depuis les paramètres de VS Code, ou en modifiant mcp.json directement. Un .vscode/mcp.json de workspace s’applique à un seul projet. Pour utiliser AppSignal sur tous les projets, placez plutôt le même bloc servers dans votre configuration au niveau utilisateur, que vous pouvez ouvrir avec MCP: Open User Configuration depuis la palette de commandes (Cmd+Shift+P). Pour l’ajouter depuis l’interface des paramètres :
  1. Ouvrez Chat → Settings → MCP Servers.
  2. Sélectionnez + pour ajouter un serveur.
  3. Choisissez HTTP (HTTP or Server-Sent Events) comme type.
  4. Saisissez https://appsignal.com/api/mcp comme URL et appsignal comme nom.
  5. Choisissez de l’enregistrer pour votre utilisateur ou pour le workspace.
VS Code écrit le serveur dans mcp.json et le liste sous User ou Workspace dans la vue MCP Servers. Ouvrez ce mcp.json pour voir l’entrée, où VS Code affiche son état d’exécution et son nombre d’outils au-dessus du nom du serveur. Pour modifier le fichier directement à la place, utilisez ces valeurs :
Avec OAuth, VS Code initie le flux de connexion la première fois que les outils AppSignal sont utilisés. VS Code démarre les serveurs MCP à la demande plutôt qu’au démarrage, donc AppSignal reste inactif jusqu’à ce que vous ouvriez Copilot Chat et l’utilisiez. 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
Suivez l’invite OAuth pour autoriser AppSignal. Une fois connecté, les outils AppSignal seront disponibles dans les sessions Copilot CLI. Le serveur est écrit dans ~/.copilot/mcp-config.json ; un .mcp.json au niveau du workspace fonctionne aussi. Exécutez copilot mcp list pour confirmer qu’AppSignal est enregistré avec le type http. Consultez la documentation MCP de GitHub Copilot CLI pour le flux interactif /mcp add.

Gemini CLI

Gemini CLI lit les serveurs MCP depuis ~/.gemini/settings.json (au niveau utilisateur) ou .gemini/settings.json dans un projet. Ajoutez AppSignal sous mcpServers :
Omettez headers pour utiliser OAuth : lorsque le point de terminaison renvoie 401, Gemini CLI détecte le flux et ouvre la connexion dans le navigateur. Vous pouvez également ajouter le serveur en ligne de commande. Passez --transport http, car gemini mcp add utilise par défaut le transport stdio et stockerait sinon l’URL comme une commande à exécuter :
Bash
Pour utiliser un jeton plutôt qu’OAuth, passez-le comme en-tête :
Bash
Redémarrez votre session Gemini CLI après avoir ajouté le serveur, puis exécutez /mcp list pour confirmer la connexion. Consultez la documentation MCP de Gemini CLI pour le schéma complet de mcpServers et les commandes gemini mcp.

OpenAI Codex

Codex se connecte à AppSignal MCP en tant que serveur streamable HTTP. Il partage une seule configuration entre le CLI, l’extension IDE et l’application de bureau ChatGPT, donc vous ne configurez cela qu’une seule fois. Pour utiliser OAuth, ajoutez le serveur avec --url :
Bash
Codex ouvre la page d’autorisation AppSignal lors de l’ajout du serveur, il n’y a donc pas d’étape de connexion séparée. Sur cet écran, choisissez votre organisation et, éventuellement, les applications à exposer, en les laissant décochées pour toutes les exposer. Exécutez codex mcp login appsignal si vous devez vous authentifier à nouveau plus tard. Pour utiliser un jeton à la place, modifiez ~/.codex/config.toml (ou .codex/config.toml dans un projet). Définissez bearer_token_env_var sur le nom d’une variable d’environnement contenant un jeton MCP :
Définissez ensuite APPSIGNAL_MCP_TOKEN dans votre environnement. Consultez la documentation MCP de Codex pour http_headers, OAuth et le schéma complet de mcp_servers.

Vérifier la connexion

Après avoir ajouté le serveur, confirmez que votre agent peut l’atteindre avant de vous y fier.
  • Claude Code : exécutez claude mcp list — AppSignal doit apparaître comme ✔ Connected. Exécutez /mcp dans une session pour inspecter le serveur et ses outils.
  • Codex : exécutez codex mcp list. La colonne Auth affiche OAuth ou Bearer token pour un serveur correctement configuré. Dans une session, /mcp liste les serveurs connectés et leurs outils.
  • GitHub Copilot CLI : exécutez copilot mcp list — AppSignal doit être listé avec le type http.
  • Gemini CLI : exécutez /mcp list dans une session. Si AppSignal manque malgré une configuration correcte, vérifiez que vous avez approuvé le dossier.
  • Zed : ouvrez Settings → AI → MCP servers. L’indicateur à côté de appsignal devient vert et son infobulle affiche « Server is active ».
  • VS Code : ouvrez Copilot Chat et sélectionnez l’icône des outils. VS Code démarre les serveurs MCP à la demande, donc AppSignal reste inactif jusqu’à ce que quelque chose l’utilise.
  • Cursor : ouvrez la liste des MCPs dans les paramètres, où appsignal apparaît sous Connected avec un indicateur vert et un nombre d’outils.
  • Devin : ouvrez la Cascade MCP marketplace, où appsignal apparaît sous Installed comme Enabled avec son nombre d’outils.
Essayez ensuite une invite qui appelle un outil de lecture, telle que « Lister mes applications AppSignal ». Une liste de vos paires app_name/app_environment confirme que les outils fonctionnent. Si l’agent signale qu’aucune application n’est trouvée, vérifiez que vous avez autorisé la bonne organisation lors d’OAuth, ou que votre jeton MCP est limité aux applications attendues. Pour savoir ce qu’AppSignal MCP journalise, comment résoudre un appel d’outil qui échoue, et ce que le jeu d’outils laisse volontairement de côté, consultez Utiliser AppSignal MCP.

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.