> ## 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 AppSignal MCP is momenteel in preview. Sluit u aan bij onze{" "} Discord-community om te helpen deze implementatie te testen en vorm te geven. [Model Context Protocol (MCP)][mcp] stelt AI-agents en AI-code-editors zoals Claude, Cursor, Windsurf, Zed, VS Code en GitHub Copilot in staat om te interageren met externe tools en gegevensbronnen. AppSignal MCP geeft deze agents directe toegang tot uw monitoringdata: fouten, traces, logs, metrieken en meer. AppSignal MCP is een publiek HTTP-endpoint op `https://appsignal.com/api/mcp`. De meeste agents maken er direct verbinding mee. Als u liever een lokale proxy draait — bijvoorbeeld in een omgeving die uitgaand verkeer beperkt — is er een [optionele Docker-image][github-repo] beschikbaar. ## Wat u kunt benaderen AppSignal MCP biedt lees- en schrijftoegang tot uw monitoringdata in zeven gebieden. Elk gebied verwijst naar een permissie die u kunt configureren bij authenticatie: met een MCP-token stelt u elk gebied in op `read`, `write` of uitgeschakeld; met OAuth worden alle lees- en schrijftools tegelijk beschikbaar gemaakt. Wat u terugkrijgt, hangt af van wat uw apps naar AppSignal sturen. Als uw app geen logs verzendt, retourneert `get_log_lines` niets. AppSignal MCP is een gateway naar data die AppSignal al heeft. Het verzamelt zelf geen nieuwe data. ### Nu beschikbaar * **Foutincidenten** (lezen + schrijven): lijst en zoek uitzonderingen, inspecteer stacktraces, werk status en severity bij, wijs handlers toe en voeg notities toe * **Performance** (lezen): rangschik de langzaamste actions, haal traces op, loop door span-bomen en inspecteer span-attributen. Sample-gebaseerd voor standaard Ruby- en Elixir-apps; OpenTelemetry-traces voor apps die OTel-data versturen * **Anomaliedetectie** (lezen + schrijven): blader door alerts, lijst bestaande triggers en maak, werk bij of archiveer triggers * **Logging** (lezen + schrijven): bevraag logregels met AppSignals expressiesyntax, en stel ingestion-regels voor logs in: filter-, trigger- en metrics-acties. Bijzonder krachtig om een klantreis aan elkaar te rijgen over logbronnen, fouten en traces heen in één prompt — zie [een klantreis reconstrueren](/mcp/reference#reconstructing-a-customer-journey) * **Metrieken** (lezen): ontdek metriekcategorieën (waaronder `host_metrics`), lijst metrieknamen en tags en haal timeseries of geaggregeerde waarden op * **Dashboards** (lezen + schrijven): maak dashboards en voeg chart-visuals toe of werk ze bij * **App-ontdekking** (lezen): lijst uw applicaties, omgevingen, namespaces, gebruikers, notifiers, logbronnen, log line-acties en deploy markers Voor de volledige lijst met tools, parameters en voorbeeldprompts, zie de [MCP Tool Reference](/mcp/reference). ### Buiten de scope van de toolset Een paar AppSignal-functies worden bewust niet via toegewijde MCP-tools beschikbaar gesteld. In de meeste gevallen is er al een betere manier om de data te benaderen, of past een natuurlijke-taalinterface niet bij de taak. Elke beschikbare tool neemt ook ruimte in beslag in de context van uw agent, dus we houden de toolset liever gefocust dan elk onderdeel van de app na te bouwen. * **Uptime monitor-beheer**: uptime-resultaten worden opgeslagen als metrieken (`uptime_monitor_error_count` en `uptime_monitor_duration`), dus u kunt ze al bevragen via de bestaande metric-tools (`get_metric_names`, `get_metric_tags`, `get_metrics_timeseries` en `get_metrics_list`). Toegewijde tools voor het lijsten of aanmaken van uptime monitors staan momenteel niet op de roadmap. * **Beheer van notifiers, gebruikers en deploy markers**: het aanmaken of wijzigen hiervan vereist owner-level permissies en heeft echte gevolgen: een verkeerd geïnterpreteerde prompt kan de verkeerde persoon toegang geven of meldingen verkeerd routeren. Beheerderswerkzaamheden zoals deze worden beter afgehandeld in de AppSignal-UI, waar ze expliciet en goed auditeerbaar zijn. U kunt notifiers, gebruikers en deploy markers nog steeds lezen via `get_app_resources`. * **Aangepaste metric- en signaal-ingestion**: AppSignals ingestion-pad draait op toegewijde endpoints die geoptimaliseerd zijn voor high-throughput delivery, en AppSignal MCP is niet ontworpen om data te pushen. Om [aangepaste metrieken](/metrics/custom) te versturen, gebruikt u de AppSignal-integratie in uw applicatie. ### Op de roadmap als er vraag naar is * **Process monitor-query's**: leestoegang tot cron- en heartbeat-process monitor-data. We willen eerst de belangstelling peilen voordat we dit toevoegen. Dit zijn de huidige standpunten en deze kunnen veranderen naarmate de manier waarop agents werken evolueert. Als u tegen een muur loopt met de huidige toolset, laat het ons weten in de [Discord-community](https://discord.com/channels/1361347709839085671/1387797163513348146) zodat we het tegen de lijst kunnen afwegen. ## Authenticatie U heeft een [AppSignal-account][appsignal-sign-up] nodig om aan de slag te gaan. AppSignal MCP ondersteunt twee authenticatiemethoden — kies welke past bij de AI-agent die u configureert: * **OAuth** — meld u één keer aan met uw AppSignal-account. Toegang wordt verleend op applicatieniveau en stelt alle lees- en schrijftools tegelijk beschikbaar. Het aanbevolen pad voor GitHub Copilot CLI, en de eenvoudigste setup voor editors die remote MCP-servers native ondersteunen (Claude Code, VS Code) of die [`mcp-remote`][mcp-remote] als bridge kunnen draaien (Cursor, Windsurf, Zed). * **Bearer token** — genereer een langlevende [MCP-token][appsignal-mcp-token] met fijnmazige permissies per toolset. Elke token kan per gebied worden ingesteld op `read`, `write` of uitgeschakeld, beperkt tot specifieke applicaties, en geconfigureerd worden om automatisch nieuwe tools beschikbaar te stellen wanneer deze worden uitgebracht. Het beste wanneer u wilt beperken wat een agent kan doen. Als u begint en uw agent ondersteunt OAuth, is dat het snellere pad. Als u per-tool-permissies of per-app scoping nodig heeft, genereer dan in plaats daarvan een MCP-token. Om een Bearer token te genereren: 1. Selecteer uw profielpictogram. 2. Ga naar **Account Settings**. 3. Selecteer **MCP Tokens** om een nieuwe token aan te maken. ## Configuratie Configureer AppSignal MCP in de instellingen van uw AI-agent met behulp van het HTTP-endpoint `https://appsignal.com/api/mcp`. Elke sectie hieronder heeft tabs voor OAuth en Bearer token — kies welke u hierboven heeft ingesteld. OAuth-ondersteuning is nieuw in onze ondersteunde editors. Als de OAuth-tab een fout geeft voor uw editor, val dan terug op de Bearer token-tab en laat het ons weten in onze{" "} Discord-community zodat we deze instructies kunnen aanscherpen. ### Claude Code ```bash OAuth theme={null} claude mcp add --transport http appsignal https://appsignal.com/api/mcp ``` ```bash Bearer token theme={null} claude mcp add --transport http appsignal https://appsignal.com/api/mcp \ --header "Authorization: Bearer your-mcp-token" ``` Met OAuth start Claude Code de browsergebaseerde aanmeldflow de eerste keer dat AppSignal-tools worden aangeroepen. Zie de [Claude Code MCP-docs][claude-code-mcp] voor transport-flags en CLI-referentie. ### Cursor Bewerk `~/.cursor/mcp.json`: ```json OAuth theme={null} { "mcpServers": { "appsignal": { "command": "npx", "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"] } } } ``` ```json Bearer token theme={null} { "mcpServers": { "appsignal": { "url": "https://appsignal.com/api/mcp", "headers": { "Authorization": "Bearer your-mcp-token" } } } } ``` De OAuth-setup gebruikt [`mcp-remote`][mcp-remote] als lokale bridge naar het HTTP-endpoint. De browsergebaseerde aanmeldflow opent de eerste keer dat Cursor verbinding maakt. Zie de [Cursor MCP-docs][cursor-mcp] voor het volledige schema. ### Windsurf Bewerk `~/.codeium/windsurf/mcp_config.json`: ```json OAuth theme={null} { "mcpServers": { "appsignal": { "command": "npx", "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"] } } } ``` ```json Bearer token theme={null} { "mcpServers": { "appsignal": { "serverUrl": "https://appsignal.com/api/mcp", "headers": { "Authorization": "Bearer your-mcp-token" } } } } ``` Zie de [Windsurf MCP-docs][windsurf-mcp] voor het volledige schema en OAuth-notities. ### Zed Open uw Zed-instellingenbestand en voeg het `context_servers`-gedeelte toe: ```json OAuth theme={null} { "context_servers": { "appsignal": { "settings": {}, "enabled": true, "url": "https://appsignal.com/api/mcp" } } } ``` ```json Bearer token theme={null} { "context_servers": { "appsignal": { "settings": {}, "enabled": true, "url": "https://appsignal.com/api/mcp", "headers": { "Authorization": "Bearer your-mcp-token" } } } } ``` Wanneer de `Authorization`-header wordt weggelaten, start Zed de standaard MCP-OAuth-flow tegen AppSignal. Zie de [Zed MCP-docs][zed-mcp] voor het volledige `context_servers`-schema. ### VS Code Als u GitHub Copilot gebruikt en bent ingelogd onder een zakelijk account, zorg er dan voor dat u "MCP servers in Copilot" instelt op "Enabled" onder uw organisatie-instellingen > Copilot > Policies. GitHub Copilot-instellingen Voeg dit toe aan uw `.vscode/mcp.json`: ```json OAuth theme={null} { "servers": { "appsignal": { "type": "http", "url": "https://appsignal.com/api/mcp" } } } ``` ```json Bearer token theme={null} { "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}" } } } } ``` Met OAuth start VS Code de aanmeldflow de eerste keer dat AppSignal-tools worden gebruikt. Zie de [VS Code MCP-docs][vscode-mcp] voor input-variabelen en headers. ### GitHub Copilot CLI De GitHub Copilot CLI gebruikt OAuth voor MCP-authenticatie. Voer het volgende uit om AppSignal toe te voegen: ```bash Bash theme={null} copilot mcp add appsignal https://appsignal.com/api/mcp ``` Volg de OAuth-prompt om AppSignal te autoriseren. Eenmaal verbonden zijn AppSignal-tools beschikbaar in Copilot CLI-sessies. Zie de [GitHub Copilot CLI MCP-docs][copilot-cli-mcp] voor de interactieve `/mcp add`-flow en config-bestandslocatie. ## Hulp krijgen We moedigen u aan om u aan te sluiten bij onze [Discord-community][discord] waar u kunt: * Hulp krijgen bij het opzetten van AppSignal MCP * Feedback en suggesties delen * Contact maken met andere developers die AppSignal MCP gebruiken * Op de hoogte blijven van nieuwe functies en verbeteringen Zoek naar het toegewijde `#mcp`-kanaal waar ons team actief meekijkt en op vragen reageert. [appsignal]: https://www.appsignal.com [appsignal-sign-up]: https://appsignal.com/users/sign_up [appsignal-mcp-token]: https://appsignal.com/users/mcp_tokens [discord]: https://discord.gg/fT2cbMuQSJ [github-repo]: https://github.com/appsignal/appsignal-mcp [mcp]: https://modelcontextprotocol.io/introduction [mcp-remote]: https://www.npmjs.com/package/mcp-remote [claude-code-mcp]: https://code.claude.com/docs/en/mcp [cursor-mcp]: https://cursor.com/docs/mcp [windsurf-mcp]: https://docs.windsurf.com/windsurf/cascade/mcp [zed-mcp]: https://zed.dev/docs/ai/mcp [vscode-mcp]: https://code.visualstudio.com/docs/copilot/chat/mcp-servers [copilot-cli-mcp]: https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers