appsignal

AppSignal MCP サーバー

MCP についてまだご存じないですか？最新情報を手軽に入手するには、PulseMCP の週刊ニュースレターをお読みください。

---

これは、MCP クライアントと AppSignal のアプリケーションパフォーマンス監視およびエラー追跡機能を連携する MCP（Model Context Protocol）サーバーです。アラートの詳細取得、ログの検索、指定した時間範囲内のログ取得ができます。

AppSignal は、開発者がアプリケーションのパフォーマンスを監視し、エラーを追跡して問題をデバッグできる、包括的な APM（アプリケーションパフォーマンス監視）ソリューションです。このサーバーは AppSignal の REST API に直接接続します。利用を開始するには、AppSignal の API キーを取得するためにサインアップする必要があります。

このプロジェクトは AppSignal とは正式に提携していません。

目次

• 主な特長
• 機能
• 利用のヒント
• 例
• セットアップ
  • チートシート
  • Claude Desktop
    • 手動セットアップ

主な特長

リアルタイム監視との連携：アプリケーションのアラート、エラー、ログに Claude やその他の MCP クライアントから直接アクセスでき、シームレスなデバッグと監視のワークフローを実現します。

強力なログ検索：柔軟なクエリオプションを使ってアプリケーションログを検索できるため、特定の問題やパターンを簡単に見つけられます。

時間範囲を指定したログ取得：特定の日時範囲内のログを取得して、インシデントの詳細な分析や、時間が重要な問題のデバッグに役立てられます。

コンテキスト切り替えが不要：アラートの確認やログの検索のために会話を離れる必要はありません。すべて MCP クライアントに直接統合されています。

機能

このサーバーは macOS 上の Claude Desktop で構築およびテストされています。ほかの MCP クライアントでも動作するはずです。

ツール名	説明
get_apps	利用可能な AppSignal アプリケーションの一覧を取得します。
select_app_id	以降の操作で使用する AppSignal アプリケーション ID を選択します。
get_exception_incident	特定の例外インシデントに関する詳細情報を取得します。
get_exception_incident_sample	特定の例外インシデントの発生サンプルを取得します。
get_log_incident	特定のログインシデントに関する詳細情報を取得します。
get_anomaly_incident	特定の異常インシデントに関する詳細情報を取得します。
search_logs	柔軟なクエリパラメーターとフィルターを使ってアプリケーションログを検索します。
get_log_incidents	オプションの状態フィルター（OPEN、CLOSED、WIP）を指定して、ログインシデントの一覧を取得します。
get_exception_incidents	オプションの状態フィルター（OPEN、CLOSED、WIP）を指定して、例外インシデントの一覧を取得します。
get_anomaly_incidents	オプションの状態フィルター（OPEN、CLOSED、WIP）を指定して、異常インシデントの一覧を取得します。

使用上のヒント

• すべてのログ検索で柔軟なクエリ構文を利用できます。完全一致するフレーズやキーワードを検索したり、AppSignal のクエリ言語を使用したりできます。
• アラート ID は、AppSignal ダッシュボードまたはアラート通知から確認できます。
• ツールを組み合わせて問題を調査してください。まずアラートの詳細を取得し、次に関連するログを検索します。
• リストツール（get_log_incidents、get_exception_incidents、get_anomaly_incidents）では、状態によるフィルタリングが可能です。
  • OPEN：対応が必要な進行中のインシデント
  • CLOSED：解決済みのインシデント
  • WIP：調査中の作業中インシデント
• 状態フィルターを指定しない場合、リストツールはデフォルトで OPEN のインシデントのみを返します。

開発

テスト

このプロジェクトでは、ユニットテストに Vitest を使用しています。テストはプルリクエストおよび main ブランチへのプッシュ時に自動的に実行されます。

ローカルでのテスト実行

# Install dependencies
npm run install-all

# Run tests once
npm run test:run

# Run tests in watch mode (recommended for development)
npm test

# Run tests with UI
npm run test:ui

テストの構成

テストは tests/ ディレクトリにあります。

• tests/functional/ - 各コンポーネントの機能テスト
• tests/integration/ - AppSignal API をモックした統合テスト
• tests/manual/ - 実際の AppSignal API にアクセスする手動テスト（CI では実行されません）
• tests/mocks/ - モックの実装とテストデータ

テストの方法について詳しくは、tests/README.md を参照してください。

手動テスト

手動テストは、実際の AppSignal API との完全な統合を検証するエンドツーエンドのシステムテストです。これらのテストは次のとおりです。

• 実際の API 認証情報が必要です（APPSIGNAL_API_KEY 環境変数）
• 実際の AppSignal 本番 API にアクセスします（モックではありません）
• 現実的なワークフローで実際の API 呼び出しを連続して実行します
• API のレート制限や外部サービスへの依存を避けるため、CI では実行されません
• AppsignalClient のコード、または外部 API とやり取りするコードを変更したときに実行してください

手動テストスイートでは、次のワークフローに沿ってテストします。

1. API キーを使用して、利用可能なすべてのアプリを一覧表示します
2. 最初のアプリを自動的に選択します
3. そのアプリのログを検索します
4. さまざまな検索パターンとエラーシナリオをテストします
5. 実際の API レスポンスを示す詳細なコンソール出力を表示します

手動テストを実行するには：

# Copy .env.example to .env and add your API key
cp .env.example .env
# Edit .env to add your real API key

# Run manual tests
npm run test:manual

# Run manual tests in watch mode
npm run test:manual:watch

テスト結果：

• SUCCESS ✅ - 重要なテストがすべて成功し、正常な一連の処理が完了しました
• WARNING ⚠️ - 基本機能は動作していますが、一部の機能を完全に検証できませんでした（例：利用可能なデータがない、または API の制限がある）
• FAILURE ❌ - 統合に明確な不具合があります

テストは AppSignal のデータと API の制限に合わせて自動的に調整されます。

セットアップ

前提条件

• Node.js v24.2.0（nvm をインストール済みの場合は nvm use を使用してください）
• AppSignal API キー

チートシート

環境変数	説明	必須	デフォルト値	例
APPSIGNAL_API_KEY	AppSignal API キーです。appsignal.com で取得してください	Y	N/A	your-api-key-here
APPSIGNAL_APP_ID	AppSignal アプリケーション ID	N	N/A	5f3e4d2c1b0a9f8e7d6c5b4a

Claude Desktop

AppSignal の API キーとアプリケーション ID を用意してください。

その後、以下から希望するサーバーの設定方法に進んでください。MCP サーバーを初めて使用する場合は、Claude Desktop アプリケーションを用意し、公式の MCP セットアップ手順に従ってください。

手動セットアップ

ターミナルで npx コマンドを実行するには、お使いのマシンで Node が動作している必要があります。Node がインストールされていない場合は、nodejs.org からインストールできます。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json ファイルを編集し、以下を追加してください。

{
  "mcpServers": {
    "appsignal": {
      "command": "npx",
      "args": ["-y", "appsignal-mcp-server"],
      "env": {
        "APPSIGNAL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop を再起動すれば、準備完了です！