Provides error management capabilities for PHP applications through integration with the Altary error management service, enabling retrieval, analysis, and resolution of PHP errors with AI-powered suggestions
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Altary MCP Servershow me the latest errors in my project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Altary MCP Server
Claude Code用のAltary エラー管理統合MCPサーバーです。
概要
このMCPサーバーは、Claude CodeとAltary エラー管理サービス(https://altary.web-ts.dev)を統合し、エラーの取得・分析・完了処理をClaude Code内で直接実行できるようにします。
Related MCP server: Cursor MCP Server
主な機能
プロジェクト管理: ユーザープロジェクトの一覧取得
エラー取得: プロジェクト別エラー一覧の表示(ChatGPT分析付き)
エラー完了: AI類似性検出による関連エラーの一括完了
🆕 自動認証: ワンクリック認証(トークンコピー不要!)
🆕 自動セットアップ:
altary_errors一つで初期設定完了設定管理: デフォルトプロジェクトと認証情報の永続化
インストール
Claude Code MCP統合(推奨)
claude mcp add altary -- uvx --from git+https://github.com/altary-app/altary-mcp-server altary-mcp-server手動インストール
# 1. リポジトリクローン
git clone https://github.com/altary-app/altary-mcp-server.git
cd altary-mcp-server
# 2. 依存関係インストール
pip install -e .
# 3. Claude Code設定
# ~/.config/claude-desktop/config.json に追加:
{
"mcpServers": {
"altary": {
"command": "altary-mcp-server"
}
}
}セットアップ手順
🚀 超簡単セットアップ(推奨)
# これだけ!完全自動セットアップ
altary_errors自動認証: ブラウザが開くのでログイン → 自動的に認証完了!
プロジェクト選択: 一覧が表示されるので
altary_set_project(project_id="ID")エラー表示: 再度
altary_errorsでエラー一覧表示
🎉 トークンのコピー&ペーストは不要!
詳細セットアップ(手動)
# 1. 認証設定
altary_auth # ブラウザで認証
altary_auth(token="your-token") # トークン設定
# 2. プロジェクト設定
altary_projects # プロジェクト一覧表示
altary_set_project(project_id="ALTR-xxx") # プロジェクト設定
# 3. エラー管理
altary_errors # エラー一覧表示
altary_complete(error_id="error-id") # エラー完了利用可能なツール
ツール名 | 説明 | パラメータ |
| プロジェクト一覧取得 | なし |
| エラー一覧取得 |
|
| エラー完了処理 |
|
| 認証設定 |
|
| デフォルトプロジェクト設定 |
|
| 現在の設定表示 | なし |
| 設定クリア | なし |
使用例
基本的なワークフロー
# 🚀 シンプル!まずはこれだけ
await altary_errors() # 自動で設定案内→エラー表示
# エラー修正後
await altary_complete(error_id="target-error-id")
# 設定確認したい場合
await altary_config()従来のワークフロー
# 1. 設定確認
await altary_config()
# 2. 認証(初回のみ)
await altary_auth()
# 3. プロジェクト設定(初回のみ)
await altary_projects()
await altary_set_project(project_id="ALTR-...")
# 4. エラー確認・修正
await altary_errors()
await altary_complete(error_id="target-error-id")ChatGPT分析付きエラー表示
エラー一覧には自動的にChatGPT分析結果が含まれます:
A. UsersController.php:978
メッセージ: compact()未定義変数エラー
🤖 AI概要: compact()で未定義の変数$usernameが使用されています
💡 AI修正提案: compact()の前に$usernameを定義するか、set()で直接設定してください設定ファイル
設定は ~/.altary/config.json に保存されます:
{
"api_base_url": "https://altary-laravel.web-ts.dev/api",
"web_base_url": "https://altary-laravel.web-ts.dev",
"auth": {
"token": "your-auth-token",
"project_id": "ALTR-default-project-id"
}
}トラブルシューティング
認証エラー
# トークンの再設定
altary_clear
altary_authネットワークエラー
インターネット接続を確認
https://altary.web-ts.dev の稼働状況を確認
MCPサーバーが認識されない
# Claude Codeを再起動
# 設定ファイル確認: ~/.config/claude-desktop/config.json開発・貢献
開発環境セットアップ
git clone https://github.com/altary-app/altary-mcp-server.git
cd altary-mcp-server
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -e ".[dev]"テスト実行
# ユニットテスト
python -m pytest
# MCPサーバーテスト
python -m altary_mcp.serverライセンス
MIT License
サポート
公式サイト: https://altary.web-ts.dev
GitHub Issues: https://github.com/altary-app/altary-mcp-server/issues