> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser AppSignal MCP

Comment AppSignal MCP se comporte une fois connecté : ce qu'il journalise, quoi faire quand un appel d'outil échoue, et quelles parties d'AppSignal il laisse délibérément de côté. Pour connecter un agent au préalable, consultez [Configurer AppSignal MCP](/mcp/setup).

<h2 id="usage-logging-and-data-handling">
  Utilisation, journalisation et traitement des données
</h2>

<h3 id="rate-limits-and-account-access">
  Limites de débit et accès au compte
</h3>

AppSignal n'applique aucune limite de débit spécifique à MCP. Les appels d'outils passent par la même infrastructure que le reste de `appsignal.com` et partagent ses protections générales.

Ce qui contrôle l'accès, c'est le plan de votre compte. Un compte verrouillé, ou un compte gratuit ayant dépassé sa période d'essai et sa limite d'utilisation, reçoit une erreur au lieu de données — la même restriction que le reste de l'API AppSignal utilise.

<h3 id="what-appsignal-mcp-logs">
  Ce qu'AppSignal MCP journalise
</h3>

AppSignal journalise chaque appel d'outil pour la fiabilité et la prévention des abus : le nom de l'outil, les arguments que vous passez, et les IDs de votre compte et utilisateur. `get_more_tools` journalise également la capacité que vous avez demandée. Votre e-mail et le nom de votre organisation peuvent apparaître dans la réponse d'un outil, mais le journal stocke des IDs, pas ces informations.

Comme les arguments sont journalisés, ne passez pas de secrets dans les paramètres en texte libre tels que les requêtes de logs. Les logs MCP suivent la [rétention des logs](/logging) générale d'AppSignal ; il n'y a pas de fenêtre de rétention distincte pour MCP.

<h3 id="data-handling-and-compliance">
  Traitement des données et conformité
</h3>

MCP lit et écrit les mêmes données que le reste d'AppSignal, il hérite donc du traitement des données d'AppSignal. AppSignal est conforme au GDPR, certifié ISO/IEC 27001, et héberge les données dans l'UE. La couverture HIPAA est disponible via un module complémentaire Business Associate Agreement.

Pour plus de détails, consultez [GDPR](/appsignal/gdpr), [Sécurité](/appsignal/security) et [Modules complémentaires Business](/support/business-add-ons).

<h2 id="troubleshooting">
  Dépannage
</h2>

<h3 id="the-server-won’t-connect-or-oauth-fails">
  Le serveur ne se connecte pas, ou OAuth échoue
</h3>

Repassez à un jeton Bearer. Générez un [jeton MCP][appsignal-mcp-token] et utilisez l'onglet jeton Bearer pour votre éditeur. Dans Claude Code :

```bash Bash theme={null}
claude mcp add --transport http appsignal https://appsignal.com/api/mcp \
  --header "Authorization: Bearer <YOUR_MCP_TOKEN>"
```

Exécutez ensuite `claude mcp list` pour confirmer qu'AppSignal apparaît comme connecté.

<h3 id="no-applications-show-up">
  Aucune application n'apparaît
</h3>

Votre connexion OAuth a autorisé une autre organisation, ou votre jeton MCP n'est pas limité aux applications attendues. Demandez à l'agent de *« lister mes applications AppSignal »*. Si la liste est vide ou incomplète, reconnectez-vous et choisissez la bonne organisation, ou régénérez le jeton avec ces applications sélectionnées.

<h3 id="”application-not-found”">
  « Application not found »
</h3>

`app_name` et `app_environment` sont mis en correspondance sans tenir compte de la casse, mais ils doivent par ailleurs correspondre à une application à laquelle vous avez accès. L'erreur liste ces applications — réessayez avec un nom et un environnement exacts issus de la liste.

<h3 id="a-tool-call-reports-that-access-is-restricted">
  Un appel d'outil signale que l'accès est restreint
</h3>

Votre compte est verrouillé, ou un compte gratuit a dépassé sa période d'essai et sa limite d'utilisation. MCP utilise les mêmes règles d'accès que le reste de l'API AppSignal. Résolvez le plan ou l'état de facturation, puis réessayez.

<h3 id="github-copilot-in-vs-code-shows-no-mcp-servers">
  GitHub Copilot dans VS Code n'affiche aucun serveur MCP
</h3>

Sur Copilot Business ou Enterprise, les serveurs MCP sont désactivés par défaut et contrôlés par une [politique d'organisation][copilot-policies]. Un propriétaire d'organisation doit définir **Settings → Copilot → Policies → Features → MCP servers in Copilot** sur **Enabled**, puis reconnectez-vous.

<h3 id="gemini-cli-lists-appsignal-as-disabled">
  Gemini CLI indique qu'AppSignal est désactivé
</h3>

Gemini CLI désactive les serveurs MCP dans les [dossiers auxquels vous n'avez pas accordé votre confiance][gemini-trusted-folders], et signale `MCP servers are configured but disabled because this folder is untrusted`. Il masque aussi les serveurs de niveau utilisateur dans ces dossiers, si bien qu'une configuration correcte ne produit malgré tout aucun outil AppSignal. Exécutez `/permissions` dans la CLI pour faire confiance au dossier, puis exécutez à nouveau `gemini mcp list`.

<h3 id="missing-any-tools">
  Un outil que vous attendez est manquant
</h3>

Un jeton MCP n'expose que les jeux d'outils que vous avez sélectionnés lors de sa création. Un jeton créé avant qu'un outil soit livré ne l'inclura pas, sauf si vous avez configuré le jeton pour exposer automatiquement les nouveaux outils. Régénérez le jeton, ou créez-en un avec le jeu d'outils activé. OAuth expose tous les outils de lecture et d'écriture, donc passez à OAuth si vous voulez tout.

<h2 id="scope-and-roadmap">
  Périmètre et feuille de route
</h2>

<h3 id="outside-the-toolset’s-scope">
  Hors du périmètre du jeu d'outils
</h3>

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é** : la création ou la modification de moniteurs de disponibilité n'est pas exposée. Vous pouvez toutefois lister vos moniteurs et leurs paramètres via [`get_app_resources`](/mcp/reference#get_app_resources). Les résultats de disponibilité sont stockés sous forme de métriques (`uptime_monitor_error_count` et `uptime_monitor_duration`), donc vous pouvez calculer vous-même la disponibilité via les outils de métriques (`get_metric_names`, `get_metric_tags`, `get_metrics_timeseries` et `get_metrics_list`).
* **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](/metrics/custom), utilisez l'intégration AppSignal dans votre application.

<h3 id="on-the-roadmap-if-there’s-demand">
  Sur la feuille de route s'il y a de la demande
</h3>

* **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][discord] afin que nous puissions le peser par rapport à la liste.

<h2 id="getting-help">
  Obtenir de l'aide
</h2>

Nous vous encourageons à rejoindre notre [communauté Discord][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.

[appsignal-mcp-token]: https://appsignal.com/users/mcp_tokens

[discord]: https://discord.gg/fT2cbMuQSJ

[copilot-policies]: https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies

[gemini-trusted-folders]: https://google-gemini.github.io/gemini-cli/docs/cli/trusted-folders.html