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,writeou 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.
- Sélectionnez votre icône de profil.
- Allez dans Account Settings.
- 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 HTTPhttps://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.
Claude Code
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.- Dans Claude, ouvrez Settings, puis Connectors.
- Sélectionnez Browse, recherchez
appsignalet ouvrez le connecteur AppSignal. S’il n’est pas répertorié, sélectionnez plutôt Add custom connector et saisissez l’URLhttps://appsignal.com/api/mcp. - Sélectionnez Connect, puis effectuez la connexion à AppSignal lorsque vous y êtes invité.
- 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.
Cursor
Ajoutez AppSignal depuis les paramètres de Cursor, ou en modifiantmcp.json directement.
Pour l’ajouter depuis l’interface des paramètres :
- Ouvrez les paramètres de Cursor.
- Ouvrez l’onglet Customize, sélectionnez MCPs, puis sélectionnez + Add New MCP Server.
- Sélectionnez User, saisissez les valeurs ci-dessous dans le fichier JSON qui s’ouvre, puis enregistrez votre configuration.
~/.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.
- OAuth : laissez
headersde 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.
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 :
- Exécutez Devin: Cascade MCP Registry depuis la palette de commandes pour ouvrir la Cascade MCP marketplace.
- Sélectionnez Add custom MCP.
- Saisissez les valeurs ci-dessous dans le
mcp_config.jsonqui s’ouvre, puis enregistrez. - Sélectionnez le contrôle d’actualisation à côté du serveur pour le recharger.
JSON Bearer token
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 :- 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. - Sélectionnez Add server, puis Add remote server.
- Saisissez
appsignalcomme nom ethttps://appsignal.com/api/mcpcomme URL. - Si vous utilisez un jeton plutôt qu’OAuth, ajoutez un en-tête
Authorization.
context_servers :
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 modifiantmcp.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 :
- Ouvrez Chat → Settings → MCP Servers.
- Sélectionnez + pour ajouter un serveur.
- Choisissez HTTP (HTTP or Server-Sent Events) comme type.
- Saisissez
https://appsignal.com/api/mcpcomme URL etappsignalcomme nom. - Choisissez de l’enregistrer pour votre utilisateur ou pour le workspace.
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 :
GitHub Copilot CLI
Le GitHub Copilot CLI utilise OAuth pour l’authentification MCP. Exécutez ce qui suit pour ajouter AppSignal :Bash
~/.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 :
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
Bash
/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 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 :
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/mcpdans une session pour inspecter le serveur et ses outils. - Codex : exécutez
codex mcp list. La colonne Auth afficheOAuthouBearer tokenpour un serveur correctement configuré. Dans une session,/mcpliste les serveurs connectés et leurs outils. - GitHub Copilot CLI : exécutez
copilot mcp list— AppSignal doit être listé avec le typehttp. - Gemini CLI : exécutez
/mcp listdans 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
appsignaldevient 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ù
appsignalapparaît sous Connected avec un indicateur vert et un nombre d’outils. - Devin : ouvrez la Cascade MCP marketplace, où
appsignalapparaît sous Installed comme Enabled avec son nombre d’outils.
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
#mcp où notre équipe surveille activement et répond aux questions.