Référence des outils MCP - AppSignal Documentation

AppSignal MCP expose 24 outils répartis sur sept domaines : incidents d’erreur, performance, Anomaly detection, journalisation, métriques, tableaux de bord et découverte d’applications. Les outils comprennent à la fois des opérations de lecture et d’écriture. Pour des exemples de la façon dont ces outils se combinent pour une tâche, consultez les flux de travail AppSignal MCP.

Référence des outils

Chaque outil prend app_name et app_environment pour identifier l’application cible. Les deux sont mis en correspondance sans tenir compte de la casse, donc MyApp/Production et myapp/production se résolvent vers la même application. Si le nom ne correspond à aucune application à laquelle vous avez accès, l’outil renvoie une erreur qui liste les applications qui vous sont disponibles, afin que l’agent puisse réessayer avec un nom valide.

Découverte d’applications

`get_applications`

Obtenez toutes les applications AppSignal auxquelles l’utilisateur a accès. Retourne les applications au format app_name/app_environment. Utilisez-le d’abord pour découvrir les applications disponibles avant d’appeler d’autres outils. Aucun paramètre requis.

`get_app_resources`

Découvrez les ressources disponibles dans une application AppSignal — namespaces, tableaux de bord, utilisateurs, notifieurs, sources de journaux, actions de ligne de journal, marqueurs de déploiement et moniteurs de disponibilité. Particulièrement utile lors de la configuration de déclencheurs, de l’attribution d’incidents ou de la compréhension de la structure d’une application.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement (par exemple `production`, `staging`).
`sections`	non	Sections à récupérer : `users`, `notifiers`, `namespaces`, `dashboards`, `log_sources`, `log_line_actions`, `log_views`, `deploy_markers`, `uptime_monitors`. Retourne tout si non spécifié.
`deploy_marker_namespace`	non	N’afficher que les déploiements dans cet namespace (par exemple `web`).
`deploy_marker_revision`	non	N’afficher que les déploiements avec cette révision. Un préfixe court fonctionne (par exemple `a1b2c3d`).

La section deploy_markers retourne jusqu’à 100 déploiements récents, chacun avec sa révision complète et la plage horaire pendant laquelle il était actif. Restreignez-la avec deploy_marker_namespace ou deploy_marker_revision. Pour trouver les erreurs qu’un déploiement a introduites, passez sa révision à get_exception_incidents (ou utilisez revision: "last" pour le déploiement le plus récent). La section uptime_monitors liste chaque URL surveillée et ses paramètres. La disponibilité elle-même n’est pas stockée — elle est calculée à partir de métriques, donc interrogez le compteur uptime_monitor_error_count avec get_metrics_timeseries pour la calculer.

Incidents d’erreur

`get_exception_incidents`

Listez et recherchez les exceptions et erreurs AppSignal. Utilisez-le pour obtenir un aperçu des exceptions récentes, rechercher dans une période, trouver des incidents par état, ou vérifier quels incidents nécessitent attention. Retourne 50 incidents par page.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`namespaces`	non	Liste séparée par des virgules des namespaces à filtrer (par exemple `web,background`).
`start`	non	Début de la plage horaire au format ISO 8601. Par défaut, le déploiement le plus récent si omis.
`end`	non	Fin de la plage horaire au format ISO 8601. Requis si `start` est fourni.
`states`	non	États séparés par des virgules : `open`, `closed`, `wip`. Retourne tous les états si non spécifié.
`page`	non	Numéro de page (basé sur 1, par défaut 1).

`get_incident`

Obtenez des informations détaillées sur un incident AppSignal. Retourne l’état actuel, l’attribution, la première et la dernière occurrence, les messages d’erreur, les traces de pile ou les détails de l’alerte d’anomalie. Prend en charge les incidents d’exception et d’anomalie.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`number`	oui	L’ID numérique de l’incident affiché dans les URL et listes d’incidents AppSignal.

`update_incidents`

Mettez à jour en masse les incidents d’une application AppSignal. Utilisez-le pour modifier l’état d’incidents, mettre à jour la gravité ou attribuer et désattribuer des membres d’équipe sur plusieurs incidents à la fois. Utilisez get_app_resources avec sections: ["users"] pour trouver les ID utilisateur pour l’attribution.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`incidents`	non	Liste des numéros d’incident à mettre à jour (par exemple `[123, 456, 789]`).
`state`	non	`open`, `closed` ou `wip` (work in progress).
`severity`	non	`critical`, `high`, `low`, `none`, `informational` ou `untriaged`.
`assign_users`	non	Liste des ID utilisateur à attribuer comme gestionnaires.
`unassign_users`	non	Liste des ID utilisateur à retirer de l’incident.

`manage_incident_note`

Créez ou mettez à jour une note sur un incident AppSignal. Markdown est pris en charge. Utilisez-le pour ajouter des commentaires, mises à jour de statut, conclusions d’enquête ou étapes de résolution. Incluez une URL complète d’issue GitHub dans la note pour lier cette issue à l’incident, lorsque GitHub est configuré pour l’application.

Cet outil s’appelait auparavant create_incident_note. L’ancien nom fonctionne toujours comme alias, afin que les invites et configurations existantes continuent de fonctionner.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`number`	oui	L’ID numérique de l’incident.
`content`	oui	Contenu de la note. Le formatage Markdown est pris en charge.
`id`	non	ID d’une note existante à mettre à jour. Omettez pour créer une nouvelle note. Vous ne pouvez modifier que les notes que vous avez rédigées.

Performance

`get_performance`

Aperçu des performances : traces de performance basées sur des échantillons et actions lentes à partir des traces. Pour les applications Ruby et Elixir standard, retourne les traces de performance basées sur des échantillons. Pour les applications qui envoient également des traces OpenTelemetry, retourne en plus une liste classée d’actions avec la durée moyenne, le débit et le taux d’erreur. Les applications en cours de migration vers OpenTelemetry peuvent retourner les deux. Outils de suivi : utilisez get_incident pour inspecter un incident de performance spécifique, get_traces pour récupérer des traces pour une action lente, et update_incidents pour modifier l’état, la gravité ou les attributions.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`namespaces`	non	Namespaces séparés par des virgules. S’applique à la fois aux traces de performance et aux actions OpenTelemetry.
`start`	non	Début de la plage horaire au format ISO 8601. Par défaut, le déploiement le plus récent pour les traces basées sur des échantillons, ou il y a 24 heures pour les actions OpenTelemetry.
`end`	non	Fin de la plage horaire au format ISO 8601. Requis si `start` est fourni.
`states`	non	États séparés par des virgules : `open`, `closed`, `wip`. S’applique uniquement aux incidents basés sur des échantillons.
`revision`	non	Limiter à un déploiement spécifique. Utilisez `"last"` pour le déploiement le plus récent, ou passez un hash de révision. Ignoré lorsque `start`/`end` est fourni. Utilisez `get_app_resources(sections: ["deploy_markers"])` pour lister les révisions disponibles.
`page`	non	Numéro de page pour les incidents basés sur des échantillons (basé sur 1, par défaut 1). Les actions OpenTelemetry sont retournées sous forme de liste classée complète.

`get_traces`

Interrogez les traces de performance et d’erreur, inspectez les arbres de spans et consultez les détails des spans. Prend en charge deux types de traces :

Traces de performance — identifiées par le namespace et action_name. Utilisez-les pour enquêter sur des requêtes lentes.
Traces d’erreur — identifiées par digest. Obtenez le digest depuis get_incident ou get_exception_incidents, puis utilisez-le ici pour voir les traces d’erreur réelles.

Chaque type de trace prend en charge trois modes :

Mode liste — trouvez des traces et obtenez les ID de trace. Fournissez le namespace + action_name, ou digest.
Mode arbre — passez un trace_id pour voir tous les spans sous forme d’arbre compact.
Mode détail de span — passez trace_id et span_id pour les attributs de span complets, les événements et les informations de ressource.

Le flux de travail typique est : lister les traces → inspecter un arbre de trace → plonger dans un span.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`namespace`	oui (performance)	L’namespace dans lequel rechercher (par exemple `web`, `background`). Non nécessaire pour les traces d’erreur.
`action_name`	oui (performance)	Le nom de l’action (par exemple `BlogPostsController#index`). Non nécessaire pour les traces d’erreur.
`digest`	oui (erreur)	Le digest de l’incident d’exception. Bascule en mode trace d’erreur. Ne peut pas être combiné avec `namespace` ou `action_name`.
`trace_id`	non	Bascule en mode arbre. Retourne tous les spans pour cette trace.
`span_id`	non	Bascule en mode détail de span. Nécessite `trace_id`.
`start`	non	Début de la plage horaire au format ISO 8601. Par défaut, il y a 24 heures. Traces de performance uniquement.
`end`	non	Fin de la plage horaire au format ISO 8601. Par défaut, maintenant. Traces de performance uniquement.
`min_duration_ms`	non	Filtrer les traces plus lentes que ce seuil en millisecondes. Mode liste uniquement.
`limit`	non	Nombre maximum de traces à retourner (1–100, par défaut 25). Mode liste uniquement.

Anomaly detection

`get_anomaly_incidents`

Listez et recherchez les alertes de Anomaly detection AppSignal. Retourne 50 alertes par page, y compris les horodatages et valeurs pour chaque alerte.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`state`	non	`open`, `closed`, `warmup`, `cooldown` ou `archived`. Retourne tous les états si non spécifié.
`trigger_id`	non	Filtrer les incidents d’un déclencheur spécifique. Utilisez `get_triggers` pour trouver les ID de déclencheur.
`page`	non	Numéro de page (basé sur 1, par défaut 1).

`get_triggers`

Listez les déclencheurs de Anomaly detection pour une application AppSignal. Retourne les déclencheurs actifs (non archivés) avec leur configuration complète — conditions, notifieurs et liens vers les tableaux de bord. Utilisez-le pour trouver les ID de déclencheur avant d’appeler manage_trigger ou archive_trigger.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	non	Filtrer par nom de métrique (par exemple `response_time`, `error_rate`).
`kind`	non	Filtrer par type de déclencheur.
`tags`	non	Filtrer par tags, par exemple `[{"key": "hostname", "value": "web-1"}]`.
`page`	non	Numéro de page (basé sur 1, par défaut 1).

`manage_trigger`

Créer ou mettre à jour un déclencheur de Anomaly detection. Les déclencheurs sont immuables. Lorsque vous mettez à jour un déclencheur, AppSignal archive celui existant (fermant toutes ses alertes et incidents) et en crée un nouveau avec une référence de chaîne de versions. Fournissez tous les champs pour les opérations de création et de mise à jour. Utilisez get_metric_names et get_metric_tags pour découvrir les métriques et champs disponibles. Utilisez get_app_resources(sections: ["notifiers"]) pour trouver les ID de notifieur.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	oui	La métrique que ce déclencheur surveille.
`kind`	oui	Type de déclencheur. Utilisez `"Advanced"` pour les métriques personnalisées.
`field`	oui	Champ de métrique à comparer : `gauge`, `mean`, `p90`, `p95`, `counter` ou `count`.
`condition_value`	oui	Valeur seuil (par exemple `500.0` pour « response time > 500ms »).
`comparison_operator`	oui	`<`, `>`, `<=`, `>=`, `==` ou `!=`.
`warmup_duration`	oui	Minutes pendant lesquelles la condition doit être remplie avant qu’une alerte ne s’ouvre. Utilisez `0` pour immédiat.
`cooldown_duration`	oui	Minutes pendant lesquelles la condition ne doit plus être remplie avant qu’une alerte ne se ferme.
`id`	non	ID d’un déclencheur existant à mettre à jour. Si fourni, archive l’ancien déclencheur et en crée un nouveau.
`notifier_ids`	non	ID des notifieurs vers lesquels envoyer les alertes.
`tags`	non	Filtres de tags pour limiter quelles métriques sont incluses. Prend en charge les caractères génériques (`*`).
`name`	non	Nom d’affichage. Par défaut, le nom de la métrique si non fourni.
`description`	non	Description de ce que ce déclencheur surveille et de ce qu’il faut faire lorsqu’il se déclenche.
`dashboard_id`	non	ID du tableau de bord à lier dans les notifications.
`no_match_is_zero`	non	Si vrai, traiter les données métriques manquantes comme 0. Utile pour les compteurs qui peuvent ne pas signaler lorsqu’ils sont inactifs.
`format`	non	Format des données de la métrique (par exemple `duration`, `size`, `percent`).

`archive_trigger`

Archiver un déclencheur de Anomaly detection et fermer toutes les alertes et incidents associés. Idempotent — n’effectue aucune opération si le déclencheur est déjà archivé. Utilisez get_triggers pour trouver l’ID du déclencheur.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`id`	oui	ID du déclencheur à archiver.

Journalisation

`get_log_lines`

Interrogez les lignes de journal en utilisant la syntaxe d’expression d’AppSignal. Prend en charge la correspondance exacte, contient, la négation, les comparaisons numériques, la logique booléenne et les attributs imbriqués. Retourne jusqu’à 100 lignes par appel, du plus récent au plus ancien par défaut. Pour les grandes plages horaires, divisez en plusieurs appels et itérez vers l’avant. Syntaxe de requête :

Modèle	Exemple
Correspondance exacte	`severity=error`
Contient	`message:timeout`
Ne contient pas	`message!:debug`
Non égal	`hostname!=web-1`
Comparaison numérique	`duration>100`
Logique booléenne	`severity=error AND (hostname=web-1 OR hostname=web-2)`
Valeurs entre guillemets	`group="background jobs"`
Attributs imbriqués	`user.id=123`

Champs disponibles : severity, hostname, group, message et tout attribut personnalisé.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`query`	oui	Requête d’expression. Utilisez une chaîne vide pour récupérer tous les journaux.
`source_ids`	non	ID des sources de journaux à interroger. Interroge toutes les sources si non spécifié. Utilisez `get_app_resources(sections: ["log_sources"])` pour trouver les ID de source.
`start`	non	Début de la plage horaire au format ISO 8601. Par défaut, une fenêtre de requête plus tôt.
`end`	non	Fin de la plage horaire au format ISO 8601. Par défaut, maintenant.
`limit`	non	Nombre de lignes de journal à retourner (1–100, par défaut 50).
`order`	non	`desc` (du plus récent au plus ancien, par défaut) ou `asc` (du plus ancien au plus récent).

`manage_log_line_action`

Créer ou mettre à jour une action de ligne de journal. Les actions de ligne de journal s’exécutent pendant l’ingestion des journaux, dans l’ordre que vous définissez. Il existe trois types :

filter — écarte les lignes de journal correspondantes afin qu’elles ne soient jamais stockées ni traitées
trigger — déclenche des alertes et incidents lorsque la requête correspond
metrics — extrait des métriques de compteur, jauge ou distribution à partir des lignes de journal correspondantes

L’ordre d’exécution est important : si un filtre écarte une ligne de journal, les actions suivantes ne la verront jamais. Un modèle courant consiste à placer les actions de métriques et de déclencheurs avant toute action de filtre. Utilisez reorder_log_line_actions pour modifier l’ordre après la création. Les nouvelles actions sont ajoutées à la fin de l’ordre d’exécution.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`name`	oui (création)	Nom de l’action (par exemple `"Drop health checks"`, `"Track error count"`).
`query`	oui (création)	Expression de requête à comparer aux lignes de journal.
`action_type`	oui (création)	`filter`, `trigger` ou `metrics`. Ne peut pas être modifié lors d’une mise à jour.
`id`	non	ID d’une action existante à mettre à jour. Si omis, crée une nouvelle action.
`source_ids`	non	ID des sources de journaux auxquelles cette action s’applique. S’applique à toutes les sources si non spécifié.
`log_line_metrics`	non	Définitions de métriques à extraire. Requis lors de la création d’une action `metrics`. Chaque métrique requiert `name` et `metric_type` (`counter`, `gauge` ou `distribution`). `gauge` et `distribution` requièrent également un `field` pour extraire la valeur. Lors d’une mise à jour, remplace toutes les définitions de métriques existantes.

`reorder_log_line_actions`

Modifier l’ordre d’exécution des actions de ligne de journal. Fournissez les ID d’action dans l’ordre souhaité. Les ID d’action non inclus sont ajoutés à la fin dans leur ordre relatif actuel. Utilisez get_app_resources(sections: ["log_line_actions"]) pour trouver les ID et voir l’ordre actuel.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`action_ids`	oui	Liste ordonnée des ID d’actions de ligne de journal. Le premier ID de la liste est exécuté en premier pendant l’ingestion.

`delete_log_line_action`

Supprimer définitivement une action de ligne de journal. Utilisez get_app_resources(sections: ["log_line_actions"]) pour d’abord trouver l’ID de l’action.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`id`	oui	ID de l’action de ligne de journal à supprimer.

Métriques

`discover_metrics`

Découvrez les catégories de métriques disponibles et leurs métriques pour la surveillance. Utilisez-le pour obtenir un aperçu de ce que vous pouvez surveiller, ou pour explorer une catégorie spécifique. Accepte également une référence dashboard:id pour afficher les métriques utilisées dans un tableau de bord spécifique.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_subject`	non	Nom de la catégorie de métrique (par exemple `performance_metrics`, `host_metrics`) ou une référence `dashboard:id`.

`get_metric_names`

Obtenez les noms de toutes les métriques pour l’application donnée. Retourne les noms des métriques sous forme de chaîne séparée par des virgules. Utilisez-les comme entrée pour get_metric_tags, get_metrics_timeseries et get_metrics_list.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.

`get_metric_tags`

Obtenez les tags et le type de métrique (Gauge, Counter, etc.) pour une métrique spécifique. Utilisez les résultats pour construire des requêtes valides avec get_metrics_timeseries et get_metrics_list.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	oui	Nom de la métrique. Utilisez `get_metric_names` pour trouver les métriques disponibles.

`get_metrics_timeseries`

Obtenez une série chronologique pour une métrique dans l’application donnée. Retourne des données point par point pour une plage horaire, un type de métrique et une combinaison de tags donnés. Les valeurs des tags prennent en charge la correspondance par caractère générique avec *.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	oui	Nom de la métrique.
`metric_type`	oui	`COUNT`, `COUNTER`, `GAUGE`, `MEAN`, `P90` ou `P95`. Utilisez `get_metric_tags` pour trouver le type valide.
`start`	oui	Début de la plage horaire au format ISO 8601.
`end`	oui	Fin de la plage horaire au format ISO 8601.
`tags`	non	Filtres de tags, par exemple `[{"key": "hostname", "value": "web"}]`. Prend en charge les caractères génériques ``.

`get_metrics_list`

Obtenez une valeur agrégée pour une métrique sur une plage horaire. Retourne une seule valeur agrégée plutôt qu’une série chronologique point par point. Utile pour les vues récapitulatives.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	oui	Nom de la métrique.
`metric_type`	oui	`COUNT`, `COUNTER`, `GAUGE`, `MEAN`, `P90` ou `P95`.
`start`	oui	Début de la plage horaire au format ISO 8601.
`end`	oui	Fin de la plage horaire au format ISO 8601.
`tags`	non	Filtres de tags, par exemple `[{"key": "hostname", "value": "frontend1"}]`.

Tableaux de bord

`manage_dashboard`

Créer ou mettre à jour un tableau de bord AppSignal. Cet outil gère uniquement les métadonnées du tableau de bord (titre et description). Utilisez create_dashboard_visual et update_dashboard_visual pour ajouter des graphiques.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`title`	oui	Titre du tableau de bord.
`description`	non	Description de l’objectif et du contenu du tableau de bord.
`id`	non	ID du tableau de bord pour mettre à jour un tableau de bord existant. Omettez pour en créer un nouveau.

`create_dashboard_visual`

Ajoutez un nouveau graphique à un tableau de bord existant. Deux types de visuels sont disponibles :

timeseries (par défaut) — un graphique en ligne ou en aire traçant une ou plusieurs métriques au fil du temps.
number — une tuile Big Number affichant une seule métrique agrégée, utile pour un total, la dernière lecture ou une moyenne en un coup d’œil.

Les deux s’affichent exactement comme si vous les aviez créés dans le constructeur de graphiques. Pour savoir à quoi sert chaque type de graphique, consultez les types de graphiques du tableau de bord. Utilisez discover_metrics ou get_metrics_list pour trouver d’abord les métriques disponibles. Ces paramètres s’appliquent aux deux types de visuels :

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`dashboard_id`	oui	ID du tableau de bord auquel ajouter le visuel.
`title`	oui	Titre du graphique.
`type`	non	`timeseries` (par défaut) ou `number`.
`description`	non	Contexte supplémentaire sur le visuel.
`format`	non	Format de valeur : `number`, `percent`, `duration`, `throughput` ou `size`.
`format_input`	non	Unité de la valeur entrante : `bit`, `byte`, `kilobit`, `kilobyte` ou `megabyte`. S’applique uniquement lorsque `format` vaut `size`.

Ces paramètres s’appliquent uniquement aux visuels timeseries :

Paramètre	Requis	Description
`metrics`	oui	Tableau des métriques à tracer. Chacune prend `name`, `fields` (un tableau d’objets tel que `[{"field": "mean"}]`, où le champ est `mean`, `p90`, `p95`, `count`, `gauge` ou `counter`) et optionnellement `tags`.
`display`	non	`line` (par défaut), `area` ou `area_relative`.
`line_label`	non	Étiquette personnalisée pour les lignes du graphique. Prend en charge les remplacements `%name%`, `%field%` et `%tag%`.
`draw_null_as_zero`	non	Indique s’il faut dessiner les points de données manquants comme zéro. Par défaut : `false`.
`min_y_axis`	non	Valeur minimale de l’axe Y.
`tags`	non	Tags globaux appliqués à chaque métrique de ce visuel.

Ces paramètres s’appliquent uniquement aux visuels number :

Paramètre	Requis	Description
`metric`	oui	La métrique unique à afficher. Prend `name`, `field` (`mean`, `p90`, `p95`, `count`, `gauge` ou `counter`), `aggregate` (`max`, `min`, `avg`, `sum`, `first` ou `last`) et optionnellement `tags`.

Une tuile Big Number prend une métrique et une agrégation sur la plage horaire sélectionnée du tableau de bord. Demandez-la en langage naturel :

Text

Add a Big Number chart to the "API Health" dashboard showing the mean
of request_latency_ms over the selected time range, formatted as a duration.

L’agent traduit cela en un appel create_dashboard_visual :

{
  "app_name": "MyApp",
  "app_environment": "production",
  "dashboard_id": "<DASHBOARD_ID>",
  "title": "Mean request latency",
  "type": "number",
  "format": "duration",
  "metric": {
    "name": "request_latency_ms",
    "field": "mean",
    "aggregate": "avg"
  }
}

MCP crée le visuel ; il n’ingère pas de métriques. La métrique à laquelle vous pointez un graphique doit déjà circuler vers AppSignal. Consultez les métriques personnalisées pour savoir comment les envoyer depuis votre application.

`update_dashboard_visual`

Mettez à jour un graphique existant sur un tableau de bord. Cela fonctionne à la fois pour les visuels timeseries et Big Number — le type est lu depuis le visuel existant, vous n’avez donc pas besoin de passer type. Tous les champs sont facultatifs sauf les identifiants, et les champs non spécifiés conservent leurs valeurs actuelles. Passer metrics ou metric remplace toute la définition de métrique de ce visuel plutôt que de la fusionner.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`visual_id`	oui	ID du visuel à mettre à jour.
`title`	non	Nouveau titre.
`description`	non	Nouvelle description. Définir sur une chaîne vide pour la supprimer.
`format`	non	Format de valeur : `number`, `percent`, `duration`, `throughput` ou `size`.
`format_input`	non	Unité de la valeur entrante : `bit`, `byte`, `kilobit`, `kilobyte` ou `megabyte`. S’applique uniquement lorsque `format` vaut `size`.
`metrics`	non	Visuels timeseries uniquement. Remplace tout le tableau de métriques.
`display`	non	Visuels timeseries uniquement. `line`, `area` ou `area_relative`.
`line_label`	non	Visuels timeseries uniquement. Prend en charge les remplacements `%name%`, `%field%` et `%tag%`.
`draw_null_as_zero`	non	Visuels timeseries uniquement. Indique s’il faut dessiner les points de données manquants comme zéro.
`min_y_axis`	non	Visuels timeseries uniquement. Valeur minimale de l’axe Y.
`tags`	non	Visuels timeseries uniquement. Tags globaux. Remplace les tags globaux existants si fourni.
`metric`	non	Visuels Big Number uniquement. Remplace toute la définition de métrique. Même forme que dans `create_dashboard_visual`.

Permissions des tokens

Chaque token MCP a des permissions configurables par ensemble d’outils : app, exceptions, performance, metrics, anomalies, dashboards, logging. Chaque ensemble d’outils peut être défini sur read, write ou désactivé. Les tokens peuvent également être limités à des applications spécifiques et configurés pour exposer automatiquement les nouveaux outils à mesure qu’ils sont ajoutés. Pour connaître les étapes de création, consultez Authentification.

Un outil manquant ?

En complément des jeux d’outils ci-dessus, AppSignal MCP expose get_more_tools, un outil de découverte et de retour d’expérience. Il ne débloque aucun outil caché aujourd’hui. À la place, il confirme la liste actuelle des outils et journalise ce que vous avez demandé, afin que l’équipe AppSignal puisse voir vers quelles capacités les utilisateurs se tournent. get_more_tools prend deux paramètres :

Paramètre	Requis	Description
`description`	oui	La capacité que vous recherchez, en langage naturel. Ce texte est journalisé comme votre demande de fonctionnalité.
`context`	oui	Pourquoi vous appelez l’outil. Suivi interne uniquement — cela ne change pas la réponse.

La plupart des agents n’y auront pas recours d’eux-mêmes, il faut donc demander explicitement : « Utilise l’outil AppSignal get_more_tools pour chercher un moyen d’exporter en masse les incidents au format CSV. » Le serveur répond que la liste complète des outils est déjà affichée et que votre demande a été journalisée sur votre compte et votre organisation. Rien de nouveau n’est renvoyé à l’agent — la valeur réside dans la demande journalisée.

Vous butez sur les limites du jeu d’outils actuel ? Demandez à votre agent d’appeler get_more_tools, puis publiez la même demande dans la communauté Discord afin que l’équipe AppSignal puisse l’évaluer.