altary-mcp-server

altary-app/altary-mcp-server

3.2

If you are the rightful owner of altary-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Altary MCP Server integrates Claude Code with Altary error management service, enabling error retrieval, analysis, and resolution directly within Claude Code.

Tools
7
Resources
0
Prompts
0

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統合（推奨）

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
  1. 自動認証: ブラウザが開くのでログイン → 自動的に認証完了！
  2. プロジェクト選択: 一覧が表示されるので altary_set_project(project_id="ID")
  3. エラー表示: 再度 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")  # エラー完了

利用可能なツール

ツール名説明パラメータ
altary_projectsプロジェクト一覧取得なし
altary_errorsエラー一覧取得project_id (省略可)
altary_completeエラー完了処理error_id (必須)
altary_auth認証設定token (省略可)
altary_set_projectデフォルトプロジェクト設定project_id (必須)
altary_config現在の設定表示なし
altary_clear設定クリアなし

使用例

基本的なワークフロー

# 🚀 シンプル！まずはこれだけ
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

ネットワークエラー

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

サポート