Redmineの設定

🎯 長期目標¶

search.call2arm.com をリモートMCPサーバー化し、Claude Desktop との完全連携を実現

📋 前提条件¶

• ✅ チケット407-411: search.call2arm.com 完全実装・本番稼働
• ✅ Claude Desktop Integrations機能利用可能 (Pro/Max/Team/Enterprise)
• ✅ OAuth 2.1 + PKCE 実装知識

🎯 実現したい機能¶

Claude Desktop連携¶

• MCP Tools: search.call2arm.com の機能をClaude DesktopのMCPツールとして利用
• 会話管理: Claude Desktop ↔ search.call2arm.com の会話同期
• プロジェクト連携: Claude Desktop プロジェクト ↔ search.call2arm.com プロジェクト統合
• 検索機能: Claude Desktop内から過去会話・アーティファクト検索

🔧 技術要件¶

リモートMCP仕様準拠¶

• OAuth 2.1 + PKCE: RFC8636準拠の認証実装
• Authorization Server Metadata: RFC8414準拠
• Streamable HTTP Transport: 2025-03-26仕様準拠
• Well-known endpoints:
  • /.well-known/oauth-authorization-server
  • /.well-known/oauth-protected-resource

MCP Server実装¶

• FastMCP or 公式SDK: Python/TypeScript実装選択
• OAuth認証サーバー: 独立認証サーバー or 統合実装
• MCP Tool定義: search.call2arm.com 機能のMCPツール化
• WebSocket対応: リアルタイム同期対応

Claude Desktop統合¶

• インテグレーション設定: Claude Desktop設定画面での連携
• 認証フロー: ブラウザベースOAuth認証
• ツール利用: Claude内からMCPツール呼び出し

📚 実装参考¶

公式実装例¶

• Atlassian MCP Server: https://www.atlassian.com/blog/announcements/remote-mcp-server
• Cloudflare Workers: https://blog.cloudflare.com/remote-model-context-protocol-servers-mcp/
• 公式仕様: https://modelcontextprotocol.io/specification/draft/basic/authorization

技術選択肢¶

1. FastMCP 2.0: Python高レベルフレームワーク
2. 公式MCP SDK: TypeScript/Python公式SDK
3. カスタム実装: 独自OAuth + MCP実装

🎯 実装フェーズ¶

Phase 6.1: OAuth 2.1認証サーバー実装¶

• OAuth認証エンドポイント実装
• PKCE (S256) 完全対応
• Authorization Server Metadata実装

Phase 6.2: MCP Server実装¶

• FastMCP or 公式SDKによるMCPサーバー構築
• search.call2arm.com 機能のMCPツール化
• Streamable HTTP Transport対応

Phase 6.3: Claude Desktop統合テスト¶

• Claude Desktop Pro/Max/Team環境でのテスト
• インテグレーション設定・認証フローテスト
• MCPツール動作確認・最適化

📊 期待される価値¶

ユーザー体験向上¶

• シームレス連携: Claude Desktop ↔ search.call2arm.com統合
• 効率的会話管理: Claude Desktop内から過去会話アクセス
• コンテキスト継続: プロジェクト単位での会話管理
• 検索体験: Claude内からの自然言語検索

技術的価値¶

• MCPエコシステム参加: 公式MCPサーバーとしての認知
• 標準準拠: OAuth 2.1 + MCP仕様完全準拠
• スケーラビリティ: 複数Claudeクライアント対応
• 拡張性: 他のMCPクライアント対応可能

⚠️ 考慮事項¶

セキュリティ¶

• OAuth実装品質: セキュリティ監査必須
• PKCE実装: 攻撃耐性確保
• トークン管理: 安全なトークンライフサイクル

運用・保守¶

• Claude Desktop更新: Claude Desktop仕様変更対応
• MCP仕様進化: MCPプロトコル仕様変更対応
• 認証メンテナンス: OAuth認証の継続的保守

🎯 成功指標¶

• Claude Desktop からのMCPツール利用成功
• OAuth 2.1認証フロー完全動作
• search.call2arm.com 機能のMCP経由アクセス
• 複数Claude Desktopクライアント対応
• セキュリティ監査合格

📅 実装時期¶

実装開始: Phase 5完了後
目標完了: search.call2arm.com本番稼働後 3-6ヶ月

🔗 関連チケット¶

• #407-411: search.call2arm.com 基盤実装
• #348 (参考): OAuth統合サーバー実装知識
• 未来: Claude Desktop連携最適化チケット