Altary MCP Server

Claude Code用のAltary エラー管理統合MCPサーバーです。

概要

このMCPサーバーは、Claude CodeとAltary エラー管理サービス（https://altary.web-ts.dev）を統合し、エラーの取得・分析・完了処理をClaude Code内で直接実行できるようにします。

主な機能

プロジェクト管理: ユーザープロジェクトの一覧取得
エラー取得: プロジェクト別エラー一覧の表示（ChatGPT分析付き）
エラー完了: AI類似性検出による関連エラーの一括完了
認証管理: ブラウザ認証とトークン管理
設定管理: デフォルトプロジェクトと認証情報の永続化

インストール

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"
    }
  }
}

セットアップ手順

1. 初期認証

# ブラウザで認証ページを開く
mcp__altary__setup_auth

# トークン取得後、設定
mcp__altary__setup_auth(token="your-auth-token")

2. プロジェクト選択

# プロジェクト一覧を取得
mcp__altary__get_user_projects

# デフォルトプロジェクトを設定
mcp__altary__set_default_project(project_id="ALTR-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")

3. エラー管理

# エラー一覧を表示（A、B、C選択形式）
mcp__altary__get_errors

# 特定プロジェクトのエラー取得
mcp__altary__get_errors(project_id="ALTR-specific-project-id")

# エラー完了（類似エラーも自動完了）
mcp__altary__complete_error(error_id="error-rand-id")

利用可能なツール

ツール名	説明	パラメータ
`get_user_projects`	プロジェクト一覧取得	なし
`get_errors`	エラー一覧取得	`project_id` (省略可)
`complete_error`	エラー完了処理	`error_id` (必須)
`setup_auth`	認証設定	`token` (省略可)
`set_default_project`	デフォルトプロジェクト設定	`project_id` (必須)
`show_config`	現在の設定表示	なし
`clear_config`	設定クリア	なし

使用例

基本的なワークフロー

# 1. 設定確認
await mcp__altary__show_config()

# 2. 認証（初回のみ）
await mcp__altary__setup_auth()

# 3. プロジェクト設定（初回のみ）  
projects = await mcp__altary__get_user_projects()
await mcp__altary__set_default_project(project_id="ALTR-...")

# 4. エラー確認・修正
errors = await mcp__altary__get_errors()
# コード修正...
await mcp__altary__complete_error(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"
  }
}

トラブルシューティング

認証エラー

# トークンの再設定
mcp__altary__clear_config
mcp__altary__setup_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