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

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

利用可能なツール

ツール名	説明	パラメータ
`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.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
ドキュメント: https://altary.web-ts.dev/document
GitHub Issues: https://github.com/altary-app/altary-mcp-server/issues

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables Claude to integrate with Altary error management service for retrieving, analyzing, and completing errors directly within the IDE. Supports project management, AI-powered error analysis, and automated completion of similar errors through similarity detection.

Related MCP Servers

Perplexity MCP Server
PoliTwit1984
A
security
A
license
A
quality
Enables intelligent code analysis and debugging through the Perplexity AI's API, offering detailed error analysis, pattern detection, and comprehensive solutions, with integration support for the Claude desktop client.
Last updated -
1
378
11
JavaScript
MIT License
Cursor MCP Server
Buga-luga
-
security
A
license
-
quality
Facilitates integration with the Cursor code editor by enabling real-time code indexing, analysis, and bi-directional communication with Claude, supporting concurrent sessions and automatic reconnection.
Last updated -
2
6
38
TypeScript
MIT License
Cursor MCP Server
johnneerdael
-
security
A
license
-
quality
Acts as a bridge between Claude's desktop application and the Cursor editor, enabling seamless AI-powered automation and multi-instance management across platforms with standardized communication and secure token-based authentication.
Last updated -
6
67
TypeScript
MIT License
MCP Code Analyzer
emiryasar
-
security
A
license
-
quality
A comprehensive code analysis and management tool that integrates with Claude Desktop to analyze code at project and file levels, helping adapt changes to projects intelligently.
Last updated -
37
Python
MIT License

View all related MCP servers

Altary MCP Server