Redmineの設定

🎯 目的¶

Phase 2で完成したOAuth 2.1 + PKCE認証基盤を実際のClaude Desktop Integrationsで接続テストし、実用可能なリモートMCP統合基盤を完成させる。

📋 Phase 2完了実績¶

✅ OAuth 2.1 + PKCE認証基盤完全実装
✅ RFC 8414/9768準拠 /.well-known エンドポイント
✅ JWT トークン管理 (Access/Refresh/Authorization Code)
✅ MCP + OAuth統合 (認証オプション + 拡張機能)
✅ セキュリティ実装 (CORS・認証ミドルウェア・トークン検証)
✅ 後方互換性維持 (認証なし基本動作継続)

🚀 Phase 3実装計画¶

Step 1: ドメイン統合・SSL設定¶

1. Nginx プロキシ設定: mcp.call2arm.com → minimal-mcp-server統合
2. SSL/HTTPS対応: Let's Encrypt証明書適用
3. 外部アクセス確認: https://mcp.call2arm.com での動作確認
4. DNS・証明書検証: Claude Desktop からのアクセス準備

Step 2: Claude Desktop Integration設定¶

1. Integration追加: Claude Desktop → 設定 → インテグレーション
2. 統合URL設定: https://mcp.call2arm.com
3. OAuth認証フロー: 実際の認証・認可プロセス実行
4. MCP接続確認: リモートMCP経由での基本操作テスト

Step 3: 機能テスト・検証¶

1. 基本MCP操作: tools/list, tools/call の実動確認
2. 認証済み機能: OAuth認証後の拡張ツール動作確認
3. エラーハンドリング: 認証失敗・トークン期限切れ対応
4. パフォーマンス: レスポンス時間・スループット測定

Step 4: 既存MCP統合準備¶

1. redmine-mcp機能: 既存Redmine操作のリモート化検討
2. desktop-commander統合: VPS-ROOT操作のリモート化検討
3. 機能マッピング: ローカル vs リモート機能対応表作成
4. 段階的移行: 安全な機能移行計画策定

🔧 技術要件¶

ドメイン・インフラ要件¶

• HTTPS必須: Claude Desktop は HTTPS接続のみ対応
• CORS設定: claude.ai, claude.anthropic.com からのアクセス許可
• SSL証明書: 有効なTLS証明書（Let's Encrypt利用）
• DNS解決: mcp.call2arm.com の正常解決

OAuth 2.1要件¶

• Authorization Server Metadata: /.well-known/oauth-authorization-server
• PKCE必須: code_challenge_method=S256
• Redirect URI: Claude Desktop 対応URI設定
• Scope管理: mcp:read, mcp:write, mcp:tools スコープ

MCP Protocol要件¶

• Protocol Version: 2024-11-05準拠
• Transport: Streamable HTTP Transport
• Content-Type: application/json
• Error Handling: 適切なHTTPステータス・エラーレスポンス

🧪 テスト計画¶

1. インフラテスト¶

• HTTPS接続確認
• SSL証明書検証
• DNS解決確認
• Nginx プロキシ動作確認

2. OAuth認証テスト¶

• /.well-known エンドポイント応答
• 認証フロー完全実行
• PKCE verification
• Token発行・検証

3. MCP Protocol テスト¶

• MCP初期化
• ツール一覧取得
• ツール実行
• 認証済み機能アクセス

4. Claude Desktop統合テスト¶

• Integration追加成功
• OAuth認証完了
• MCP接続確立
• 実際のMCP操作実行

📊 成功指標¶

技術指標¶

• HTTPS接続成功率: 100%
• OAuth認証成功率: 100%
• MCP操作成功率: 100%
• レスポンス時間: < 3秒 (平均)

機能指標¶

• Claude Desktop Integration追加: 成功
• OAuth認証フロー: 完全動作
• MCP基本操作: 正常実行
• 認証済み拡張機能: 正常アクセス

⚠️ リスク管理¶

既存システム保護¶

• Phase 1/2実装への影響ゼロ
• ローカル開発環境の継続利用
• ロールバック機能の準備

Claude Desktop接続¶

• OAuth実装の Claude Desktop 互換性確認
• エラーケースのデバッグ・対応
• 接続問題時のトラブルシューティング

🎯 期待成果¶

Claude Desktop から VPS-ROOT環境への完全なリモートMCPアクセスが実現し、OAuth 2.1認証による安全なMCP操作が可能になる。

Phase 4で既存MCPツール統合を完了し、リモートMCP統合基盤の完全実用化を達成する。

🔗 関連チケット¶

• 前段階: #616 (Phase 2完了)
• 並行作業: #348 (基盤開発)
• 次段階: #615 (Phase 4統合完成)