Altary MCP Server

# Altary MCP Server Claude Code用のAltary エラー管理統合MCPサーバーです。 ## 概要 このMCPサーバーは、Claude CodeとAltary エラー管理サービス（https://altary.web-ts.dev）を統合し、エラーの取得・分析・完了処理をClaude Code内で直接実行できるようにします。 ## 主な機能 - **プロジェクト管理**: ユーザープロジェクトの一覧取得 - **エラー取得**: プロジェクト別エラー一覧の表示（ChatGPT分析付き） - **エラー完了**: AI類似性検出による関連エラーの一括完了 - **🆕 自動認証**: ワンクリック認証（トークンコピー不要！） - **🆕 自動セットアップ**: `altary_errors` 一つで初期設定完了 - **設定管理**: デフォルトプロジェクトと認証情報の永続化 ## インストール ### Claude Code MCP統合（推奨） ```bash claude mcp add altary -- uvx --from git+https://github.com/altary-app/altary-mcp-server altary-mcp-server ``` ### 手動インストール ```bash # 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" } } } ``` ## セットアップ手順 ### 🚀 超簡単セットアップ（推奨） ```bash # これだけ！完全自動セットアップ altary_errors ``` 1. **自動認証**: ブラウザが開くのでログイン → 自動的に認証完了！ 2. **プロジェクト選択**: 一覧が表示されるので `altary_set_project(project_id="ID")` 3. **エラー表示**: 再度 `altary_errors` でエラー一覧表示 **🎉 トークンのコピー＆ペーストは不要！** ### 詳細セットアップ（手動） ```bash # 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") # エラー完了 ``` ## 利用可能なツール | ツール名 | 説明 | パラメータ | |---------|------|-----------| | `altary_projects` | プロジェクト一覧取得 | なし | | `altary_errors` | エラー一覧取得 | `project_id` (省略可) | | `altary_complete` | エラー完了処理 | `error_id` (必須) | | `altary_auth` | 認証設定 | `token` (省略可) | | `altary_set_project` | デフォルトプロジェクト設定 | `project_id` (必須) | | `altary_config` | 現在の設定表示 | なし | | `altary_clear` | 設定クリア | なし | ## 使用例 ### 基本的なワークフロー ```python # 🚀 シンプル！まずはこれだけ await altary_errors() # 自動で設定案内→エラー表示 # エラー修正後 await altary_complete(error_id="target-error-id") # 設定確認したい場合 await altary_config() ``` ### 従来のワークフロー ```python # 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` に保存されます： ```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" } } ``` ## トラブルシューティング ### 認証エラー ```bash # トークンの再設定 altary_clear altary_auth ``` ### ネットワークエラー - インターネット接続を確認 - https://altary.web-ts.dev の稼働状況を確認 ### MCPサーバーが認識されない ```bash # Claude Codeを再起動 # 設定ファイル確認: ~/.config/claude-desktop/config.json ``` ## 開発・貢献 ### 開発環境セットアップ ```bash 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]" ``` ### テスト実行 ```bash # ユニットテスト python -m pytest # MCPサーバーテスト python -m altary_mcp.server ``` ## ライセンス MIT License ## サポート - 公式サイト: https://altary.web-ts.dev - ドキュメント: https://altary.web-ts.dev/document - GitHub Issues: https://github.com/altary-app/altary-mcp-server/issues