AppSignal MCP einrichten - AppSignal Documentation

AppSignal MCP ist ein öffentlicher HTTP-Endpunkt unter https://appsignal.com/api/mcp. Authentifizieren Sie sich einmal und fügen Sie den Endpunkt dann mit der Anleitung für Ihren Editor oder Ihre App zu Ihrem KI-Tool hinzu.

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:

Wählen Sie Ihr Profil-Symbol aus.
Gehen Sie zu Account Settings.
Wählen Sie MCP Tokens, um ein neues Token zu erstellen.

Das Token-Formular enthält zwei lange Checklisten: die Anwendungen, auf die das Token beschränkt werden soll, und die freizugebenden Berechtigungen. Jede Liste hat in ihrer Kopfzeile einen Select all-Umschalter, der alle Kästchen auf einmal aktiviert oder leert.

Konfiguration

Konfigurieren Sie AppSignal MCP in den Einstellungen Ihres KI-Agenten unter Verwendung des HTTP-Endpunkts https://appsignal.com/api/mcp. Jeder der folgenden Abschnitte hat Tabs für OAuth und Bearer Token — wählen Sie das aus, was Sie im Abschnitt Authentifizierung 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

claude mcp add --transport http appsignal https://appsignal.com/api/mcp \
  --header "Authorization: Bearer your-mcp-token"

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"]
    }
  }
}

{
  "mcpServers": {
    "appsignal": {
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-mcp-token"
      }
    }
  }
}

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"]
    }
  }
}

{
  "mcpServers": {
    "appsignal": {
      "serverUrl": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-mcp-token"
      }
    }
  }
}

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"
    }
  }
}

{
  "context_servers": {
    "appsignal": {
      "settings": {},
      "enabled": true,
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-mcp-token"
      }
    }
  }
}

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.

Fügen Sie dies zu Ihrer .vscode/mcp.json hinzu:

{
  "servers": {
    "appsignal": {
      "type": "http",
      "url": "https://appsignal.com/api/mcp"
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "appsignal_mcp_token",
      "description": "AppSignal MCP Token",
      "password": true
    }
  ],
  "servers": {
    "appsignal": {
      "type": "http",
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:appsignal_mcp_token}"
      }
    }
  }
}

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.

Gemini CLI

Gemini CLI liest MCP server aus ~/.gemini/settings.json (auf Benutzerebene) oder aus .gemini/settings.json in einem Projekt. Fügen Sie AppSignal unter mcpServers hinzu:

{
  "mcpServers": {
    "appsignal": {
      "httpUrl": "https://appsignal.com/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "appsignal": {
      "httpUrl": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-mcp-token"
      }
    }
  }
}

Lassen Sie headers weg, um OAuth zu verwenden: Wenn der Endpunkt 401 zurückgibt, erkennt Gemini CLI den Flow und öffnet die browserbasierte Anmeldung. Sie können den Server auch über die Kommandozeile mit gemini mcp add appsignal https://appsignal.com/api/mcp hinzufügen. Siehe die Gemini CLI MCP-Dokumentation für das vollständige mcpServers-Schema und die gemini mcp-Befehle.

Claude app

Die Claude app — Claude.ai im Web sowie die Desktop- und Mobile-Apps — verbindet sich über OAuth als custom connector mit AppSignal MCP. In der App gibt es keine Bearer-Token-Option.

Öffnen Sie in Claude Settings und dann Connectors.
Wählen Sie Browse, suchen Sie nach appsignal und öffnen Sie den AppSignal-Connector. Wenn er nicht aufgeführt ist, wählen Sie stattdessen Add custom connector und geben Sie die URL https://appsignal.com/api/mcp ein.
Wählen Sie Connect und schließen Sie dann die AppSignal-Anmeldung ab, wenn Sie dazu aufgefordert werden.
Starten Sie einen Chat und probieren Sie einen Prompt wie „Liste meine AppSignal-Anwendungen auf” aus. Sie können AppSignal jederzeit über Settings → Connectors verbinden oder trennen.

Custom connectors sind in den Plänen Free, Pro, Max, Team und Enterprise verfügbar; Free ist auf einen custom connector begrenzt. Bei Team und Enterprise verwaltet ein Organisations-Admin die verfügbaren Connectors. Weitere Details finden Sie im Leitfaden für custom connectors von Claude.

OpenAI Codex

Codex verbindet sich als streamable HTTP server mit AppSignal MCP. Fügen Sie es über die Codex app hinzu und authentifizieren Sie sich mit OAuth, oder konfigurieren Sie es in einer Datei mit einem Bearer Token. So fügen Sie es in der Codex app hinzu:

Öffnen Sie Settings, dann MCP servers, und wählen Sie Add server.
Wählen Sie den Transport Streamable HTTP, geben Sie den Namen appsignal und die URL https://appsignal.com/api/mcp ein und speichern Sie dann.
Wählen Sie Authenticate neben dem AppSignal-Server.
Wählen Sie auf dem AppSignal-Autorisierungsbildschirm Ihre Organisation und optional die freizugebenden Anwendungen aus (lassen Sie sie deaktiviert für alle), und wählen Sie dann Allow access.

Um Codex stattdessen über eine Datei zu konfigurieren, bearbeiten Sie ~/.codex/config.toml (oder .codex/config.toml in einem Projekt). Setzen Sie bearer_token_env_var auf den Namen einer Umgebungsvariable, die ein MCP-Token enthält:

[mcp_servers.appsignal]
url = "https://appsignal.com/api/mcp"
bearer_token_env_var = "APPSIGNAL_MCP_TOKEN"

Setzen Sie anschließend APPSIGNAL_MCP_TOKEN in Ihrer Umgebung. Siehe die Codex MCP-Dokumentation für http_headers, OAuth und das vollständige mcp_servers-Schema.

Verbindung überprüfen

Nachdem Sie den Server hinzugefügt haben, bestätigen Sie, dass Ihr Agent ihn erreichen kann, bevor Sie sich darauf verlassen.

Claude Code: Führen Sie claude mcp list aus — AppSignal sollte als ✔ Connected angezeigt werden — oder führen Sie /mcp innerhalb einer Sitzung aus, um den Server und seine Tools zu inspizieren.
Andere Editoren: Öffnen Sie das MCP- oder Context-Server-Panel in den Einstellungen des Editors, wo AppSignal als verbunden erscheinen sollte.

Probieren Sie dann einen Prompt aus, der ein Read-Tool aufruft, wie z. B. „Liste meine AppSignal-Anwendungen auf”. Eine Liste Ihrer app_name/app_environment-Paare bestätigt, dass die Tools funktionieren. Wenn der Agent meldet, dass keine Anwendungen vorhanden sind, prüfen Sie, ob Sie während OAuth die richtige Organisation autorisiert haben oder ob Ihr MCP-Token auf die erwarteten Anwendungen beschränkt ist.

Nutzung, Logging und Datenverarbeitung

Rate Limits und Kontozugriff

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.

Was AppSignal MCP protokolliert

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 die von Ihnen angefragte Fähigkeit. 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 von AppSignal; es gibt kein separates Aufbewahrungsfenster für MCP.

Datenverarbeitung und Compliance

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, Security und Business Add-ons.

Fehlerbehebung

Der Server verbindet sich nicht, oder OAuth schlägt fehl

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

Bash

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.

Es werden keine Anwendungen angezeigt

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.

„Application not found”

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.

Ein Tool-Aufruf meldet, dass der Zugriff eingeschränkt ist

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.

GitHub Copilot in VS Code zeigt keine MCP server an

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

Ein erwartetes Tool fehlt

Ein MCP-Token stellt nur die Toolsets 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 mit dem aktivierten Toolset. OAuth stellt alle Lese- und Schreibtools bereit — wechseln Sie also zu OAuth, wenn Sie alles möchten.

Umfang und Roadmap

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: Das Erstellen oder Ändern von Uptime-Monitoren wird nicht bereitgestellt. Sie können Ihre Monitore und deren Einstellungen dennoch über get_app_resources auflisten. Uptime-Ergebnisse werden als Metriken gespeichert (uptime_monitor_error_count und uptime_monitor_duration), sodass Sie die Uptime selbst über die Metrik-Tools (get_metric_names, get_metric_tags, get_metrics_timeseries und get_metrics_list) berechnen können.
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.

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.

​Authentifizierung

​Konfiguration

​Claude Code

​Cursor

​Windsurf

​Zed

​VS Code

​GitHub Copilot CLI

​Gemini CLI

​Claude app

​OpenAI Codex

​Verbindung überprüfen

​Nutzung, Logging und Datenverarbeitung

​Rate Limits und Kontozugriff

​Was AppSignal MCP protokolliert

​Datenverarbeitung und Compliance

​Fehlerbehebung

​Der Server verbindet sich nicht, oder OAuth schlägt fehl

​Es werden keine Anwendungen angezeigt

​„Application not found”

​Ein Tool-Aufruf meldet, dass der Zugriff eingeschränkt ist

​GitHub Copilot in VS Code zeigt keine MCP server an

​Ein erwartetes Tool fehlt

​Umfang und Roadmap

​Außerhalb des Toolset-Umfangs

​Auf der Roadmap, wenn Nachfrage besteht

​Hilfe erhalten

Authentifizierung

Konfiguration

Claude Code

Cursor

Windsurf

Zed

VS Code

GitHub Copilot CLI

Gemini CLI

Claude app

OpenAI Codex

Verbindung überprüfen

Nutzung, Logging und Datenverarbeitung

Rate Limits und Kontozugriff

Was AppSignal MCP protokolliert

Datenverarbeitung und Compliance

Fehlerbehebung

Der Server verbindet sich nicht, oder OAuth schlägt fehl

Es werden keine Anwendungen angezeigt

„Application not found”

Ein Tool-Aufruf meldet, dass der Zugriff eingeschränkt ist

GitHub Copilot in VS Code zeigt keine MCP server an

Ein erwartetes Tool fehlt

Umfang und Roadmap

Außerhalb des Toolset-Umfangs

Auf der Roadmap, wenn Nachfrage besteht

Hilfe erhalten