Zum Hauptinhalt springen
AppSignal MCP befindet sich derzeit in der Preview. Treten Sie unserer Discord-Community bei, um diese Implementierung mit zu testen und mitzugestalten.
Das Model Context Protocol (MCP) ermöglicht es KI-Agenten und KI-Code-Editoren wie Claude, Cursor, Windsurf, Zed, VS Code und GitHub Copilot, mit externen Tools und Datenquellen zu interagieren. AppSignal MCP gibt diesen Agenten direkten Zugriff auf Ihre Monitoring-Daten: Fehler, Traces, Logs, Metriken und mehr. AppSignal MCP ist ein öffentlicher HTTP-Endpunkt unter https://appsignal.com/api/mcp. Die meisten Agenten verbinden sich direkt damit. Wenn Sie lieber einen lokalen Proxy ausführen möchten — zum Beispiel in einer Umgebung, die ausgehenden Traffic einschränkt — ist ein optionales Docker-Image verfügbar.

​
Worauf Sie zugreifen können

AppSignal MCP bietet Lese- und Schreibzugriff auf Ihre Monitoring-Daten in sieben Bereichen. Jeder Bereich entspricht einer Berechtigung, die Sie bei der Authentifizierung konfigurieren können: Mit einem MCP-Token setzen Sie jeden Bereich auf read, write oder deaktiviert; mit OAuth werden alle Read- und Write-Tools auf einmal freigegeben. Was Sie zurückbekommen, hängt davon ab, was Ihre Apps an AppSignal senden. Wenn Ihre App keine Logs sendet, gibt get_log_lines nichts zurück. AppSignal MCP ist ein Gateway zu Daten, die AppSignal bereits hat. Es erfasst nicht selbst neue Daten.

​
Jetzt verfügbar

  • Fehlervorfälle (read + write): Exceptions auflisten und durchsuchen, Stack Traces inspizieren, Zustand und Schweregrad aktualisieren, Handler zuweisen und Notizen hinzufügen
  • Performance (read): Die langsamsten Actions ranken, Traces abrufen, Span-Bäume durchgehen und Span-Attribute inspizieren. Sample-basiert für Standard-Ruby- und Elixir-Apps; OpenTelemetry-Traces für Apps, die OTel-Daten senden
  • Anomalie-Erkennung (read + write): Alarme durchsuchen, bestehende Trigger auflisten und Trigger erstellen, aktualisieren oder archivieren
  • Logging (read + write): Logzeilen mit der Ausdruckssyntax von AppSignal abfragen und Log-Ingestion-Regeln einrichten: Filter-, Trigger- und Metrik-Aktionen. Besonders leistungsfähig, um eine Customer Journey über Log-Quellen, Fehler und Traces in einem einzigen Prompt zusammenzufügen — siehe Customer Journey rekonstruieren
  • Metriken (read): Metrikkategorien entdecken (einschließlich host_metrics), Metriknamen und Tags auflisten und Zeitreihen oder aggregierte Werte abrufen
  • Dashboards (read + write): Dashboards erstellen und Chart-Visualisierungen hinzufügen oder aktualisieren
  • App-Discovery (read): Ihre Anwendungen, Umgebungen, Namespaces, Benutzer, Notifier, Log-Quellen, Log-Line-Actions und Deploy-Marker auflisten
Die vollständige Liste der Tools, Parameter und Beispiel-Prompts finden Sie in der MCP Tool Reference.

​
Außerhalb des Toolset-Umfangs

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: Uptime-Ergebnisse werden als Metriken gespeichert (uptime_monitor_error_count und uptime_monitor_duration), sodass Sie sie bereits über die bestehenden Metrik-Tools (get_metric_names, get_metric_tags, get_metrics_timeseries und get_metrics_list) abfragen können. Dedizierte Tools zum Auflisten oder Erstellen von Uptime-Monitoren stehen derzeit nicht auf der Roadmap.
  • 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 zu senden, verwenden Sie die AppSignal-Integration in Ihrer Anwendung.

​
Auf der Roadmap, wenn Nachfrage besteht

  • Abfrage von Prozessmonitoren: Lesezugriff auf Cron- und Heartbeat-Prozessmonitor-Daten. Wir möchten das Interesse abschätzen, bevor wir dies hinzufügen.
Dies sind aktuelle Standpunkte, die sich mit der Weiterentwicklung der Arbeitsweise von Agenten ändern können. Wenn Sie mit dem aktuellen Toolset an eine Grenze stoßen, sagen Sie uns Bescheid in der Discord-Community, damit wir es gegen die Liste abwägen können.

​
Authentifizierung

Sie benötigen ein AppSignal-Konto, um zu beginnen. AppSignal MCP unterstützt zwei Authentifizierungsmethoden — wählen Sie diejenige, die zum KI-Agenten passt, den Sie konfigurieren:
  • OAuth — Melden Sie sich einmal mit Ihrem AppSignal-Konto an. Der Zugriff wird auf Anwendungsebene gewährt und stellt alle Lese- und Schreibtools auf einmal bereit. Der empfohlene Weg für die GitHub Copilot CLI und die einfachste Einrichtung für Editoren, die remote MCP-Server nativ unterstützen (Claude Code, VS Code) oder die mcp-remote als Brücke ausführen können (Cursor, Windsurf, Zed).
  • Bearer Token — Erzeugen Sie ein langlebiges MCP-Token mit feingranularen Berechtigungen pro Toolset. Jedes Token kann pro Bereich auf read, write oder deaktiviert gesetzt werden, auf bestimmte Anwendungen begrenzt und so konfiguriert werden, dass neue Tools automatisch bereitgestellt werden, sobald sie verfügbar sind. Am besten geeignet, wenn Sie einschränken möchten, was ein Agent tun darf.
Wenn Sie anfangen und Ihr Agent OAuth unterstützt, ist das der schnellere Weg. Wenn Sie pro-Tool-Berechtigungen oder pro-App-Begrenzung benötigen, erzeugen Sie stattdessen ein MCP-Token. So erzeugen Sie ein Bearer Token:
  1. Wählen Sie Ihr Profil-Symbol aus.
  2. Gehen Sie zu Account Settings.
  3. Wählen Sie MCP Tokens, um ein neues Token zu erstellen.

​
Konfiguration

Konfigurieren Sie AppSignal MCP in den Einstellungen Ihres KI-Agenten unter Verwendung des HTTP-Endpunkts https://appsignal.com/api/mcp. Jeder Abschnitt unten hat Tabs für OAuth und Bearer Token — wählen Sie das aus, was Sie oben eingerichtet haben.
OAuth-Unterstützung ist in unseren unterstützten Editoren neu. Wenn der OAuth-Tab für Ihren Editor fehlschlägt, weichen Sie auf den Bearer-Token-Tab aus und teilen Sie uns das in unserer Discord-Community mit, damit wir diese Anweisungen anpassen können.

​
Claude Code

claude mcp add --transport http appsignal https://appsignal.com/api/mcp
Mit OAuth startet Claude Code den browserbasierten Anmeldevorgang beim ersten Aufruf der AppSignal-Tools. Siehe die Claude Code MCP-Dokumentation für Transport-Flags und CLI-Referenz.

​
Cursor

Bearbeiten Sie ~/.cursor/mcp.json: 
{
  "mcpServers": {
    "appsignal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"]
    }
  }
}
Die OAuth-Einrichtung verwendet mcp-remote als lokale Brücke zum HTTP-Endpunkt. Der browserbasierte Anmeldevorgang öffnet sich beim ersten Verbindungsaufbau von Cursor. Siehe die Cursor MCP-Dokumentation für das vollständige Schema.

​
Windsurf

Bearbeiten Sie ~/.codeium/windsurf/mcp_config.json: 
{
  "mcpServers": {
    "appsignal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"]
    }
  }
}
Siehe die Windsurf MCP-Dokumentation für das vollständige Schema und OAuth-Hinweise.

​
Zed

Öffnen Sie Ihre Zed-Einstellungsdatei und fügen Sie den Abschnitt context_servers hinzu: 
{
  "context_servers": {
    "appsignal": {
      "settings": {},
      "enabled": true,
      "url": "https://appsignal.com/api/mcp"
    }
  }
}
Wenn der Authorization-Header weggelassen wird, initiiert Zed den Standard-MCP-OAuth-Flow gegen AppSignal. Siehe die Zed MCP-Dokumentation für das vollständige context_servers-Schema.

​
VS Code

Wenn Sie GitHub Copilot verwenden und unter einem Firmenkonto angemeldet sind, stellen Sie sicher, dass „MCP servers in Copilot” unter den Einstellungen Ihrer Organisation > Copilot > Policies auf „Enabled” gesetzt ist. GitHub Copilot-Einstellungen Fügen Sie dies zu Ihrer .vscode/mcp.json hinzu: 
{
  "servers": {
    "appsignal": {
      "type": "http",
      "url": "https://appsignal.com/api/mcp"
    }
  }
}
Mit OAuth initiiert VS Code den Anmeldevorgang beim ersten Aufruf der AppSignal-Tools. Siehe die VS Code MCP-Dokumentation für Eingabevariablen und Header.

​
GitHub Copilot CLI

Die GitHub Copilot CLI verwendet OAuth für die MCP-Authentifizierung. Führen Sie Folgendes aus, um AppSignal hinzuzufügen:
Bash
copilot mcp add appsignal https://appsignal.com/api/mcp
Folgen Sie der OAuth-Aufforderung, um AppSignal zu autorisieren. Sobald die Verbindung hergestellt ist, sind die AppSignal-Tools in Copilot-CLI-Sitzungen verfügbar. Siehe die GitHub Copilot CLI MCP-Dokumentation für den interaktiven /mcp add-Flow und den Speicherort der Konfigurationsdatei.

​
Hilfe erhalten

Wir ermutigen Sie, unserer Discord-Community 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.