Redmineの設定

🎯 目的¶

認証は通るが機能が使えないリモートMCPサーバー (mcp.call2arm.com) の完全機能実装

📋 現在の問題 (チケット#704調査結果)¶

❌ 重大な実装不備

1. MCPプロトコル不完全: JSON-RPC 2.0リクエスト解析エラー
2. 実用ツール未実装: redmine-mcp, desktop-commander-wsl等の主要機能なし
3. OAuth認証不備: redirect_uri処理で undefined エラー

✅ 正常稼働部分

• OAuth 2.1基盤: Well-known エンドポイント正常応答
• Streamable HTTP Transport: MCP 2024-11-05準拠
• Docker Container: mcp-gateway稼働中

🚨 必須実装項目¶

Phase 1: MCPプロトコル基本修正 (最優先)

• JSON-RPC 2.0リクエスト解析の完全実装
• initialize エンドポイントの修正
• tools/list エンドポイントの完全実装
• tools/call エンドポイントの実装
• セッション管理の修正

Phase 2: 実用ツール実装 (高優先)

• redmine-mcp統合:
  • create_redmine_ticket
  • search_redmine_tickets
  • update_redmine_ticket
  • add_ticket_comment
• vps-commander統合:
  • execute_command (SSH経由)
  • docker_ps, docker_logs
  • list_directory, read_file
• filesystem統合:
  • read_file, write_file
  • list_directory, search_files

Phase 3: OAuth認証完了 (中優先)

• redirect_uri 処理修正
• PKCE認証フロー完全実装
• トークン管理の実装
• Claude Desktop統合テスト

📁 作業対象ファイル¶

• メインサーバー: /root/mcp-gateway/server.js
• Docker設定: /root/mcp-gateway/docker-compose.yml
• OAuth設定: 認証エンドポイント部分

🧪 テスト方法¶

# MCPプロトコルテスト
curl -X POST https://mcp.call2arm.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}},"id":1}'

# ツール機能テスト  
curl -X POST https://mcp.call2arm.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}'

# OAuth認証テスト
curl "https://mcp.call2arm.com/oauth/authorize?response_type=code&client_id=claude-desktop&state=test123&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256&redirect_uri=claude://auth/callback"

✅ 完了条件¶

1. MCPプロトコルテストが全て成功
2. 主要ツール (Redmine・VPS・ファイル) が動作
3. Claude Desktop Integrationsで実際に接続・利用可能
4. 全機能のエンドツーエンドテスト成功

📊 期待効果¶

• Claude Desktop経由でVPS-ROOT環境の完全操作実現
• Redmineチケット管理の効率化
• 開発作業の大幅な生産性向上