> ## 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.

# AppSignal MCP verwenden

Wie sich AppSignal MCP verhält, sobald es verbunden ist: was es protokolliert, was zu tun ist, wenn ein Tool-Aufruf fehlschlägt, und welche Teile von AppSignal es bewusst unangetastet lässt. Um zunächst einen Agenten zu verbinden, siehe [AppSignal MCP einrichten](/mcp/setup).

<h2 id="usage-logging-and-data-handling">
  Nutzung, Logging und Datenverarbeitung
</h2>

<h3 id="rate-limits-and-account-access">
  Rate Limits und Kontozugriff
</h3>

AppSignal wendet kein MCP-spezifisches Rate Limit an. Tool-Aufrufe laufen über dieselbe Infrastruktur wie der Rest von `appsignal.com` und teilen sich deren allgemeine Schutzmechanismen.

Was den Zugriff regelt, ist der Plan Ihres Kontos. Ein gesperrtes Konto oder ein kostenloses Konto, das die Testphase und das Nutzungslimit überschritten hat, erhält einen Fehler statt Daten — dieselbe Einschränkung, die auch der Rest der AppSignal-API verwendet.

<h3 id="what-appsignal-mcp-logs">
  Was AppSignal MCP protokolliert
</h3>

AppSignal protokolliert jeden Tool-Aufruf zur Sicherstellung der Zuverlässigkeit und zur Missbrauchsprävention: den Tool-Namen, die übergebenen Argumente sowie Ihre Konto- und Benutzer-IDs. `get_more_tools` protokolliert zusätzlich angefragte Fähigkeiten und jegliches Feedback, das Sie darüber einreichen. Ihre E-Mail-Adresse und Ihr Organisationsname können in der Antwort eines Tools auftauchen, aber das Log speichert IDs, nicht diese.

Da Argumente protokolliert werden, übergeben Sie keine Secrets in Freitext-Parametern wie z. B. Log-Abfragen. MCP-Logs unterliegen der allgemeinen [Log-Aufbewahrung](/logging) von AppSignal; es gibt kein separates Aufbewahrungsfenster für MCP.

<h3 id="data-handling-and-compliance">
  Datenverarbeitung und Compliance
</h3>

MCP liest und schreibt dieselben Daten wie der Rest von AppSignal und übernimmt daher die Datenverarbeitung von AppSignal. AppSignal ist GDPR-konform, ISO/IEC 27001-zertifiziert und hostet Daten in der EU. HIPAA-Abdeckung ist über ein Business Associate Agreement-Add-on verfügbar.

Die Details finden Sie unter [GDPR](/appsignal/gdpr), [Security](/appsignal/security) und [Business Add-ons](/support/business-add-ons).

<h2 id="troubleshooting">
  Fehlerbehebung
</h2>

<h3 id="the-server-won’t-connect-or-oauth-fails">
  Der Server verbindet sich nicht, oder OAuth schlägt fehl
</h3>

Weichen Sie auf ein Bearer Token aus. Erzeugen Sie ein [MCP-Token][appsignal-mcp-token] und verwenden Sie den Bearer-Token-Tab für Ihren Editor. In Claude Code:

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

Führen Sie anschließend `claude mcp list` aus, um zu bestätigen, dass AppSignal als verbunden angezeigt wird.

<h3 id="no-applications-show-up">
  Es werden keine Anwendungen angezeigt
</h3>

Ihre OAuth-Anmeldung hat eine andere Organisation autorisiert, oder Ihr MCP-Token ist nicht auf die erwarteten Anwendungen beschränkt. Bitten Sie den Agenten, *„meine AppSignal-Anwendungen aufzulisten"*. Wenn die Liste leer ist oder Anwendungen fehlen, melden Sie sich erneut an und wählen Sie die richtige Organisation, oder generieren Sie das Token neu mit den gewünschten Anwendungen.

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

`app_name` und `app_environment` werden ohne Berücksichtigung der Groß-/Kleinschreibung abgeglichen, müssen aber ansonsten mit einer App übereinstimmen, auf die Sie Zugriff haben. Der Fehler listet diese Anwendungen auf — versuchen Sie es erneut mit einem exakten Namen und einer Umgebung aus der Liste.

<h3 id="a-tool-call-reports-that-access-is-restricted">
  Ein Tool-Aufruf meldet, dass der Zugriff eingeschränkt ist
</h3>

Ihr Konto ist gesperrt, oder ein kostenloses Konto hat die Testphase und das Nutzungslimit überschritten. MCP verwendet dieselben Zugriffsregeln wie der Rest der AppSignal-API. Klären Sie den Plan- oder Abrechnungsstatus und versuchen Sie es erneut.

<h3 id="github-copilot-in-vs-code-shows-no-mcp-servers">
  GitHub Copilot in VS Code zeigt keine MCP server an
</h3>

Bei Copilot Business oder Enterprise sind MCP server standardmäßig deaktiviert und durch eine [Organisationsrichtlinie][copilot-policies] gesperrt. Ein Org-Owner setzt **Settings → Copilot → Policies → Features → MCP servers in Copilot** auf **Enabled** und stellt anschließend die Verbindung erneut her.

<h3 id="gemini-cli-lists-appsignal-as-disabled">
  Gemini CLI listet AppSignal als deaktiviert
</h3>

Gemini CLI deaktiviert MCP server in [Ordnern, denen Sie nicht vertraut haben][gemini-trusted-folders], und meldet `MCP servers are configured but disabled because this folder is untrusted`. Es unterdrückt in diesen Ordnern auch Server auf Benutzerebene, sodass selbst eine korrekte Konfiguration keine AppSignal-Tools liefert. Führen Sie `/permissions` innerhalb der CLI aus, um dem Ordner zu vertrauen, und führen Sie dann erneut `gemini mcp list` aus.

<h3 id="missing-any-tools">
  Ein erwartetes Tool fehlt
</h3>

Ein MCP-Token stellt nur die Tools bereit, die Sie beim Erstellen ausgewählt haben. Ein Token, das erstellt wurde, bevor ein Tool verfügbar wurde, enthält es nicht, es sei denn, Sie haben das Token so eingestellt, dass neue Tools automatisch bereitgestellt werden. Generieren Sie das Token neu, oder erstellen Sie eines, bei dem dieses Tool freigeschaltet ist. OAuth stellt das vollständige AppSignal-MCP-Toolset bereit, das für diese Anmeldung verfügbar ist — wechseln Sie also zu OAuth, wenn Sie alles möchten.

<h2 id="scope-and-roadmap">
  Umfang und Einschränkungen
</h2>

<h3 id="outside-the-toolset’s-scope">
  Außerhalb des Toolset-Umfangs
</h3>

Ein paar AppSignal-Funktionen werden absichtlich nicht über dedizierte MCP-Tools bereitgestellt. In den meisten Fällen gibt es bereits einen besseren Weg, auf die Daten zuzugreifen, oder eine Natural-Language-Schnittstelle ist für die Aufgabe nicht geeignet. Jedes bereitgestellte Tool nimmt auch Platz im Kontext Ihres Agenten ein, daher halten wir das Toolset lieber fokussiert, als jeden Teil der App zu spiegeln.

* **Uptime-Monitor-Verwaltung:** Das Erstellen oder Ändern von Uptime-Monitoren wird nicht bereitgestellt. Sie können Ihre Monitore und deren Einstellungen dennoch über [`get_app_resources`](/mcp/reference#get_app_resources) auflisten. Uptime-Ergebnisse werden als Metriken gespeichert: `uptime_monitor_error_count`, `uptime_monitor_duration` und die phasenweise erfasste `uptime_monitor_timing`. Sie können die Uptime selbst über die Metrik-Tools (`get_metric_names`, `get_metric_tags`, `get_metrics_timeseries` und `get_metrics_list`) berechnen.
* **Check-in-Monitore:** Anders als Uptime-Monitore werden Cron- und Heartbeat-Monitore über [`get_check_in_triggers`](/mcp/reference#get_check_in_triggers) und [`manage_check_in_trigger`](/mcp/reference#manage_check_in_trigger) bereitgestellt.
* **Notifier-, Benutzer- und Deploy-Marker-Verwaltung:** Das Erstellen oder Ändern dieser erfordert Berechtigungen auf Owner-Ebene und hat reale Konsequenzen: Ein falsch interpretierter Prompt könnte der falschen Person Zugriff gewähren oder Alarme falsch leiten. Admin-Operationen wie diese werden besser in der AppSignal-UI behandelt, wo sie explizit und leicht zu auditieren sind. Sie können Notifier, Benutzer und Deploy-Marker dennoch über `get_app_resources` lesen.
* **Benutzerdefinierte Metrik- und Signal-Ingestion:** Der Ingest-Pfad von AppSignal läuft über dedizierte Endpunkte, die für die Lieferung mit hohem Durchsatz optimiert sind, und AppSignal MCP ist nicht für das Pushen von Daten konzipiert. Um [Custom Metrics](/metrics/custom) zu senden, verwenden Sie die AppSignal-Integration in Ihrer Anwendung.

Wenn Sie mit dem aktuellen Toolset an eine Grenze stoßen, bitten Sie Ihren Agenten, `get_more_tools` aufzurufen, damit die Anfrage oder das Feedback protokolliert wird, und teilen Sie es uns anschließend in der [Discord-Community][discord] mit.

<h2 id="getting-help">
  Hilfe erhalten
</h2>

Wir ermutigen Sie, unserer [Discord-Community][discord] beizutreten, wo Sie:

* Hilfe bei der Einrichtung von AppSignal MCP erhalten
* Feedback und Vorschläge teilen
* Sich mit anderen Entwicklern austauschen, die AppSignal MCP verwenden
* Über neue Funktionen und Verbesserungen auf dem Laufenden bleiben

Suchen Sie nach dem dedizierten `#mcp`-Kanal, in dem unser Team aktiv mitliest und auf Fragen antwortet.

[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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.