Astravue MCP

Astravue MCP サーバー

画像をクリックすると、デモ全編（音声付き）をダウンロードできます。

Astravue MCP サーバーは、お使いの Astravue ワークスペースと、互換性のある AI ツールをつなぐクラウドベースのブリッジです。設定すると、これらのツールからスペース、プロジェクト、タスク、時間記録、カスタムフィールドをリアルタイムで操作できるようになります。すべての操作は OAuth 2.0 で認証され、ユーザーに既に設定されているアクセス制御が適用されます。

Astravue MCP サーバーを使うと、次のことができます。

• 検索と閲覧： ツールを切り替えずに、スペース、プロジェクト、タスクを検索して閲覧できます。
• 作成と更新： 自然言語でタスク、サブタスク、チェックリスト、コメントを作成・更新できます。
• 時間の記録： ライブタイマーや手動記録で時間を記録し、タイムシートレポートを作成できます。
• カスタムフィールドの管理： ドロップダウン、日付、通貨などのカスタムフィールドを管理できます。
• ワークフローの自動化： スプリント計画、ステータス報告、タスクの一括更新などを自動化できます。

コンテキストを切り替えずに作業を管理したい、AI 対応 IDE やアシスタントを使うプロジェクトマネージャー、開発者、チーム向けに設計されています。

製品のドキュメント全文は docs.astravue.com にあります。

Astravue は、Claude Connectors Directory で認証・審査済みのインテグレーションです。

対応クライアント

すべてのクライアントは同じエンドポイントに接続します：https://api.astravue.com/mcp 初回接続時に、ブラウザーで Astravue へのサインインを求められます。

セットアップ手順

Claude コネクターディレクトリ（推奨）

Astravue は、Claude.ai、Claude Desktop、Claude Mobile、Claude Code、Cowork で認証済みコネクターとして利用できます。

1. Claude.ai または Claude Desktop で、Customize → Connectors に移動します。
2. + をクリックしてコネクターディレクトリを開き、Astravue を検索します。
3. Astravue を選択し、Connect をクリックしてから、Astravue にサインインし、アクセスを許可します。
4. 新しい会話を開始し、+ → Connectors メニューから Astravue を有効にします。

Claude Code が Claude.ai サブスクリプションで認証されている場合、コネクターは自動的に利用可能になります。/mcp を実行して接続されていることを確認してください。API キー、Bedrock、または Vertex を使用する Claude Code セッションでは Claude.ai コネクターは読み込まれません。代わりに、以下の直接接続コマンドを使用してください。

Claude Code

コネクターディレクトリから、認証済みの MCP 接続を利用できます。8 つのガイド付きプロジェクト管理ワークフローも利用するには、Astravue プラグインをインストールしてください。API キー、Bedrock、Vertex、およびカスタム設定では、直接 MCP 接続も引き続き利用できます。

オプション A — Claude Code プラグインとしてインストール（推奨）

このプラグインには、一般的なプロジェクト管理ワークフローを自動化する 8 つの組み込みスキルと MCP サーバーが含まれています。Anthropic のコミュニティプラグインマーケットプレイスに掲載されています。

Claude Code 内で、次を実行します：

/plugin marketplace add anthropics/claude-plugins-community
/plugin install astravue@claude-community
/reload-plugins

または、このリポジトリから直接インストールします：

/plugin marketplace add AstravueOrg/astravue-mcp-server
/plugin install astravue@astravue
/reload-plugins

インストール後、/mcp を実行して astravue が接続されていることを確認し、次に /plugin を開いて Installed タブに切り替え、同梱されたスキルを確認します。

インストール範囲（ユーザー、プロジェクト、ローカル）については、Anthropic のプラグインの検出に関するドキュメントを参照してください。

オプション B — MCP サーバーのみをインストール

同梱のスキルを含めず、生の MCP サーバーのみを利用する場合は、次を実行します：

claude mcp add --transport http astravue https://api.astravue.com/mcp

ブラウザーが自動的に開きます。Astravue アカウントでサインインし、Approve をクリックしてください。

接続を確認するには、新しい Claude Code セッションで /mcp を実行します。astravue が緑色の接続済みステータスで表示されます。

claude mcp add --transport http --scope project astravue https://api.astravue.com/mcp

Claude Desktop

1. Claude Desktop で Customize → Connectors に移動します。
2. + をクリックし、ディレクトリを閲覧して Astravue を検索します。
3. Astravue を選択して Connect をクリックし、サインインしてアクセスを承認します。

{
  "mcpServers": {
    "astravue-mcp": {
      "type": "http",
      "url": "https://api.astravue.com/mcp"
    }
  }
}

Claude.ai（Web）

1. claude.ai → Customize → Connectors に移動します。
2. + をクリックし、ディレクトリを閲覧して Astravue を検索します。
3. Astravue を選択して Connect をクリックし、サインインしてアクセスを承認します。

Claude Mobile（iOS / Android）

Claude Mobile は Claude.ai と同じコネクターエコシステムを使用します。モバイル版の Connectors Directory から Astravue に接続するか、Claude.ai または Claude Desktop で一度接続し、モバイルでも同じ Claude アカウントを使用します。

Cursor

1. Cursor Settings → Tools & MCP に移動します。
2. New MCP Server をクリックします。mcp.json ファイルが開きます。
3. 次の設定を追加します。

{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp"
    }
  }
}

4. ファイルを保存します。ブラウザーが開くので、Astravue アカウントでサインインして Approve をクリックします。

VS Code

1. プロジェクトのルートに .vscode/mcp.json ファイルを追加します。

{
  "servers": {
    "astravue-mcp": {
      "type": "http",
      "url": "https://api.astravue.com/mcp"
    }
  }
}

2. コマンドパレットを開き（macOS では Cmd+Shift+P、Windows では Ctrl+Shift+P）、MCP: List Servers を実行して、astravue-mcp の横にある Start をクリックします。
3. ブラウザーで Astravue アカウントを使って認証します。

{
  "mcp": {
    "servers": {
      "astravue-mcp": {
        "type": "http",
        "url": "https://api.astravue.com/mcp"
      }
    }
  }
}

Windsurf

1. Windsurf の MCP 設定ファイルを開きます。

   • macOS / Linux: ~/.codeium/mcp_config.json
   • Windows: C:\Users\[username]\.codeium\mcp_config.json
   • または、Settings → Tools → Windsurf Settings → Add Server に移動します。

2. 次の設定を追加します。

{
  "mcpServers": {
    "astravue-mcp": {
      "serverUrl": "https://api.astravue.com/mcp"
    }
  }
}

設定にすでにほかのサーバーがある場合は、ファイル全体を置き換えずに、既存の mcpServers オブジェクト内に astravue-mcp を追加してください。

3. Windsurf を再読み込みし、Astravue アカウントで認証します。

Cline

1. VS Code のサイドバーにある Cline アイコンをクリックし、右上の メニュー（⋮） をクリックして、MCP Servers を選択します。
2. Remote Servers タブに移動し、次の項目を入力します。
   • Server Name: astravue-mcp
   • Server URL: https://api.astravue.com/mcp
   • Transport Type: Streamable HTTP
3. Add Server をクリックします。ブラウザーが開くので、サインインして Approve をクリックします。

{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp",
      "type": "streamableHttp"
    }
  }
}

JetBrains（IntelliJ、WebStorm、PyCharm など）

1. Settings → Tools → AI Assistant → Model Context Protocol (MCP) に移動します。
2. Add をクリックし、Streamable HTTP を選択して、次の設定を貼り付けます。

{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp"
    }
  }
}

3. OK をクリックし、続けて Apply をクリックします。ブラウザーで Astravue アカウントにサインインします。

Gemini CLI

このリポジトリから gemini-extension.json を Gemini CLI の拡張機能ディレクトリにコピーするか、Gemini MCP の設定にサーバー URL を追加します。

その他の MCP クライアント

Streamable HTTP + OAuth 2.0 をサポートするクライアントの場合：

npx -y mcp-remote@latest https://api.astravue.com/mcp

仕組み

Astravue MCP は、AI アシスタントが呼び出せるツールとして、ワークスペースの操作を提供します。各ツールは、プロジェクトの作成、タスクの管理、作業時間の記録、レポートの取得など、Astravue ワークスペースで特定の操作を実行します。

AI アシスタントはリクエストを受け取ると、ユーザーのプロンプトに基づいて適切なツールを選択し、必要なパラメーターを指定して実行します。

認証： すべてのツールには、有効な認証済みセッションが必要です。ツールの呼び出しで 401 Unauthorized が発生した場合は、AI クライアントを再接続してセッションを更新してください。

破壊的な操作： 一部のツールは、タスク、プロジェクト、スペースの削除など、破壊的な操作を実行します。ほとんどの AI クライアントでは、これらの操作を実行する前に確認が求められます。承認する前に、必ず操作内容を確認してください。

権限

Astravue MCP は、Astravue のウェブアプリと同じロールベースのアクセス制御に従います。すべてのツール呼び出しは、既存の権限を持つ認証済みユーザーとして実行されます。アプリでアクセスできないものを、MCP 経由でアクセスまたは変更することはできません。

組織のロール

スペースレベルの権限

プロジェクトレベルの権限

タスクレベルの権限

ツールの呼び出しで 403 Access Denied が返された場合、その操作に必要なロールがアカウントにないことを意味します。権限を更新するには、ワークスペースの管理者にお問い合わせください。

ワークフローの例

ユーザーが AI アシスタントに次のように依頼します。

「Sprint 5 という新しいスプリントを作成して、ログイン、支払い、API ドキュメントのタスクを追加してください。」

AI アシスタントは、次のツールを実行する場合があります。

1. astravue_create_project — Sprint 5 プロジェクトを作成します
2. astravue_bulk_create_tasks — 1 回の呼び出しで 3 つのタスクを作成します
3. astravue_update_task — 必要に応じて優先度や期日を設定します

これにより、1 回の会話で複雑なプロジェクト設定を完了できます。

利用可能なツール

Astravue MCP Server は、次のカテゴリにわたる 87 個のツールを提供します。

利用可能なプロンプト

Astravue MCP Server は、15 個のプロンプトを提供します。一般的なプロジェクト管理タスクを AI アシスタントが進めるための、事前に構築されたワークフローです。

利用可能なリソース

Astravue MCP Server は、6 個のリソースを提供します。AI アシスタントが会話に添付できるコンテキストデータにより、より豊かで正確な応答を実現します。

静的リソース

リソーステンプレート

スキル

このリポジトリには、一般的なプロジェクト管理ワークフローを自動化する、すぐに使えるスキルが含まれています。

Claude Code または Cursor のプラグインを使用すると、スキルが自動的に利用可能になります。

データとセキュリティ

• すべての通信は、TLS 1.2 以降を使用した HTTPS により暗号化されます。
• OAuth 2.0 認証により、安全なアクセス制御が実現されます。
• データへのアクセスには、ワークスペースのロールとプロジェクトレベルの権限が適用されます。
• MCP サーバーは認証情報を保存しません。認証はセッションごとに処理されます。

詳細については、SECURITY.md をご覧ください。

レート制限

Astravue MCP は、プラットフォームの安定性を確保するため、レート制限を適用しています。

上限を超えると、サーバーは HTTP 429 Too Many Requests を返します。再試行する前に60秒お待ちください。

トラブルシューティング

よくある質問

コントリビューション

コントリビューションを歓迎します。ガイドラインについては、CONTRIBUTING.md をご覧ください。

行動規範

このプロジェクトでは、Contributor Covenant に従います。

ライセンス

このプロジェクトは、Apache License 2.0 のもとでライセンスされています。

Copyright 2026 Astravue.

サポート

• GitHub で issue を作成する
• [email protected] にメールを送信する
• help.astravue.com にアクセスする