Easy8 MCP

Easy8 MCP サーバー

AI アシスタントを Easy8 に直接接続できます。Easy8 MCP サーバーを使うと、Claude、Cursor、GitHub Copilot、その他の Model Context Protocol クライアントから、ユーザー自身の Easy8 権限を使って、ユーザー自身の Easy8 インスタンス上のプロジェクト、イシュー、コメントを読み取り、更新できます。

サーバーは Easy8 に組み込まれています。インストール、ホスティング、保守は不要です。管理者設定で有効にし、AI クライアントの接続先として https://your-easy8.example.com/mcp を指定するだけです。

ステータス： 早期アクセスです。プロトコルの機能範囲とツールカタログは、今後の Easy8 リリースで拡張される予定です。

対応クライアント

Easy8 MCP サーバーは、標準の Model Context Protocol を Streamable HTTP 経由で使用するため、準拠しているクライアントであればどれでも動作します。以下のクライアントについては、動作確認済みのセットアップ手順を用意しています。

• Claude Code — Claude Code のセットアップを参照してください。
• Cursor — Cursor のセットアップを参照してください。
• Visual Studio Code（GitHub Copilot） — VS Code のセットアップを参照してください。
• Claude Desktop およびその他の stdio のみをサポートするクライアント — mcp-remote プロキシ経由で接続します。stdio クライアントのセットアップを参照してください。

カスタムリクエストヘッダーを使ったリモート HTTP サーバーに対応する他の MCP クライアントも、そのまま利用できます。接続先として https://your-easy8.example.com/mcp を指定し、X-Redmine-API-Key ヘッダーに Easy8 API キーを設定してください。

始める前に

次の3つが必要です。

1. AI クライアントからアクセスできる Easy8 インスタンス（クラウドまたはセルフホスト可能なもの）。
2. Easy8 の管理画面で MCP を有効化します：Settings → AI → Enable MCP → Save。MCP はデフォルトで無効です。無効の間は、/mcp は 404 Not Found を返します。
3. 個人用 Easy8 API キー。Easy8 のユーザープロフィールから生成してください。MCP サーバーは標準の Easy8 API 認証を使用し、アカウントのすべての権限とプロジェクトの表示範囲を引き継ぎます。

以上です。別途インストールしたり、追加のサービスを実行したり、OAuth アプリを登録したりする必要はありません。

エンドポイントとサービス検出

MCP エンドポイント	https://your-easy8.example.com/mcp
トランスポート	Streamable HTTP
認証	X-Redmine-API-Key リクエストヘッダー内の API キー
サービス検出カード	https://your-easy8.example.com/.well-known/mcp/server-card.json

サービス検出カードは、トランスポートと機能を示す公開メタデータです。/mcp エンドポイントを利用するには、引き続き MCP が有効であり、有効な API キーが必要です。

AI ができること

現在のツールカタログは、イシューとプロジェクトのワークフローを中心に構成されています。

ツール	機能
easy8_projects_list	表示可能なプロジェクトを一覧表示します。名前または自由入力のクエリで絞り込み、limit / offset でページネーションできます。
easy8_issues_list	表示可能なイシューを一覧表示します。プロジェクト、担当者、ステータス（open / closed）、件名、期限の期間、自由入力のクエリで絞り込めます。
easy8_issues_get	メタデータ、説明、コメント数を含む、指定した ID のイシューを取得します。
easy8_issues_comments_list	イシューのジャーナルノートを新しい順に一覧表示します。
easy8_issues_create	イシューを作成します。件名とプロジェクトの指定が必須です。トラッカー、説明、担当者、優先度、ステータス、日付、カスタムフィールドに対応しています。
easy8_issues_update	既存のイシューを更新します。フィールドの編集と、notes による新しいジャーナルノートの追記に対応しています。

ツールは標準の MCP tools/list メソッド経由で動的に検出されるため、クライアントには常に最新のスキーマが表示されます。

Easy8 MCP サーバーのすべてのツールについては、公式開発者ドキュメントを参照してください：https://developers.easy8.com/AI/mcp-server/core-tools/

ワークフローの例

• 「Q2 マーケティングプロジェクトで、担当者が自分になっている未完了のイシューをすべて見つけ、ブロックされている内容を要約してください。」
• 「イシュー #1842 の最新コメントを読み、顧客向けの状況報告の下書きを作成してください。」
• 「Onboarding プロジェクトにフォローアップタスクを作成し、Petra に割り当てて、期限を金曜日に設定し、適切なトラッカーと優先度を指定してください。」
• 「Helpdesk プロジェクトで先週クローズしたイシューをすべて一覧表示し、トラッカー別に分類してください。」

クライアントの設定

https://your-easy8.example.com をお使いの Easy8 URL に、YOUR_API_KEY をご自身の Easy8 API キーに置き換えてください。

Claude Code

claude mcp add --transport http easy8 https://your-easy8.example.com/mcp \
  --header "X-Redmine-API-Key: YOUR_API_KEY"

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加してください。

{
  "mcpServers": {
    "easy8": {
      "url": "https://your-easy8.example.com/mcp",
      "headers": {
        "X-Redmine-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

VS Code（GitHub Copilot）

ワークスペースの .vscode/mcp.json に追加してください。

{
  "servers": {
    "easy8": {
      "type": "http",
      "url": "https://your-easy8.example.com/mcp",
      "headers": {
        "X-Redmine-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop（およびその他の stdio 専用クライアント）

Claude Desktop は現在、リモート HTTP MCP にネイティブ対応していません。mcp-remote プロキシを使用してください。claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "easy8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-easy8.example.com/mcp",
        "--header",
        "X-Redmine-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

設定を編集した後、クライアントを再起動してください。

仕組み

Easy8 MCP サーバーは、Model Context Protocol の標準 JSON-RPC メソッドを実装しています。

• initialize — セッションを開始し、サーバーのメタデータと機能を返します。
• tools/list — 完全な JSON スキーマを含む、最新のツールカタログを返します。
• tools/call — 構造化された引数でツールを呼び出し、構造化された応答を返します。
• ping — ヘルスチェックです。
• notifications/initialized — クライアントからの標準的な初期化後通知として受け付けます。

メソッドの詳細なリファレンス、リクエスト／レスポンスの例、エラーの仕様については、Easy8 開発者ドキュメントをご覧ください。

セキュリティと権限

• 権限に基づいてデータにアクセスします。 すべてのツール呼び出しは、API キー所有者の権限で実行されます。MCP サーバーが Easy8 の認可、可視性のルール、必須フィールドの検証を回避することはありません。
• 通信には TLS を使用します。 /mcp には必ず HTTPS を使用してください。
• API キーはパスワードと同様に扱ってください。 ソース管理にコミットしたり、チャットで共有したりしないでください。漏えいした場合は、Easy8 のユーザープロフィールからキーをローテーションしてください。
• デフォルトでは無効です。 Easy8 の管理者がインスタンスごとに MCP を明示的に有効にします。
• 専用のサービスアカウントを使用してください。 連携に必要な権限のみ（多くの場合は読み取り専用）を持つ Easy8 ユーザーを作成し、個人の管理者アカウントではなく、そのアカウントから API キーを生成してください。

トラブルシューティング

/mcp が 404 Not Found を返す MCP が有効になっていません。Easy8 の管理画面で Settings → AI → Enable MCP に移動し、保存してください。

POST /mcp が 401 Unauthorized を返す リクエストに有効な API キーがありません。X-Redmine-API-Key ヘッダーが設定されていること、またキーが取り消されたり再生成されたりしていないことを確認してください。

ツール呼び出しで権限エラーが返される MCP サーバーは Easy8 の認可を適用します。該当するプロジェクトまたはチケットに対する API キー所有者の権限を確認してください。

GET /mcp が 405 Method Not Allowed を返す これは想定どおりです。エンドポイントは POST による JSON-RPC であり、MCP が有効な場合、GET はサポートされていません。

サポートとフィードバック

• 製品に関する質問や機能リクエスト：[email protected]
• 開発者向けリファレンス：developers.easy8.com/AI/mcp-server
• この README または設定例に関する問題：このリポジトリでイシューを作成してください。

免責事項

Easy8 MCP サーバーは、お客様の既存の Easy8 ライセンスおよび利用規約に基づき、Easy8 の一部として提供されます。ツールの動作、利用可能なメソッド、プロトコルのバージョンは、Easy8 のリリースによって変更される場合があります。AI クライアントに本番データへの書き込みアクセスを許可する前に、必ず本番以外のご自身のインスタンスでテストしてください。