Skip to content

appsignal/appsignal-mcp

Repository files navigation

AppSignal MCP Server [beta]

This is the official AppSignal MCP server. It allows AI agents to access AppSignal's monitoring data, metrics, and tools and is currently in beta.

Join our Discord community to help test and shape this MCP implementation.

Prerequisites

Installation

Pull the Docker image:

docker pull appsignal/mcp:latest

Configuration

Claude

Configure Claude to use the AppSignal MCP server by editing the ~/Library/Application Support/Claude/claude_desktop_config.json file:

{
  "mcpServers": {
    "appsignal": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "APPSIGNAL_API_KEY", "appsignal/mcp"],
      "env": {
        "APPSIGNAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude code

To enable AppSignal MCP in Claude Code, run the following command:

claude mcp add appsignal -e APPSIGNAL_API_KEY=your_api_key_here -- docker run -i --rm -e APPSIGNAL_API_KEY appsignal/mcp

Cursor and Windsurf

To enable AppSignal MCP in Cursor or Windsurf, edit your configuration file.

For Cursor use ~/.cursor/mcp.json

For Windsurf use ~/.codeium/windsurf/mcp_config.json

Add the following configuration:

{
  "mcpServers": {
    "appsignal": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "APPSIGNAL_API_KEY", "appsignal/mcp"],
      "env": {
        "APPSIGNAL_API_KEY": "your-mcp-token"
      }
    }
  }
}

Zed

Open your Zed settings file and add the context_servers section:

{
  "context_servers": {
    "appsignal": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "APPSIGNAL_API_KEY",
          "appsignal/mcp"
        ],
        "env": {
          "APPSIGNAL_API_KEY": "your_api_key_here"
        }
      },
      "settings": {}
    }
  }
}

VSCode

If you are running GitHub Copilot, and are signed in under a company account, make sure to set "MCP servers in Copilot" to "Enabled" under your organization settings > Copilot > Policies.

GitHub Copilot Settings

Then add this config to your .vscode/mcp.json settings:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "appsignal_mcp_token",
      "description": "AppSignal MCP Token",
      "password": true
    }
  ],
  "servers": {
    "appsignal": {
      "command":  "docker"
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPSIGNAL_API_KEY",
        "appsignal/mcp"
      ],
      "env": {
        "APPSIGNAL_API_KEY": "${input:appsignal_mcp_token}"
      }
    }
  }
}

Development

To work on the MCP server:

  1. Start the TypeScript compiler in watch mode:

    npm run watch
  2. Run tests:

    npm test
  3. Use the MCP inspector for debugging:

    npm run inspector

Contributing

Thinking of contributing to our project? Awesome! 🚀

Please follow our Contributing guide in our documentation and follow our Code of Conduct.

Also, we would be very happy to send you Stroopwafles. Have look at everyone we send a package to so far on our Stroopwafles page.

Support

  • Join our Discord community to chat with other developers and the AppSignal team
  • Contact us to speak directly with the engineers working on AppSignal. They will help you get set up, tweak your code and make sure you get the most out of using AppSignal.

License

This project is licensed under the MIT License - see the LICENSE file for details.

About AppSignal

AppSignal provides real-time performance monitoring for your web applications. Track errors, monitor performance, measure client-side metrics, and receive alerts when things go wrong.

About

MCP protocol server

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Contributors 5