Devcycle

DevCycle MCP Cloudflare Worker

このパッケージは、ホスト型の Cloudflare Worker サービスとして DevCycle MCP（Model Context Protocol）サーバーを提供します。Claude などの AI アシスタントが OAuth 認証を通じて DevCycle のフィーチャーフラグを管理できるようにします。

主な機能

• OAuth 認証：ユーザーの同意フローを備えた安全な Auth0 統合
• インストール不要：AI アシスタントで一度設定すれば、ローカルでのセットアップは不要です
• 自動更新：手動で更新しなくても、常に最新の機能を利用できます
• 状態の永続化：Durable Objects がセッションとプロジェクトの選択状態を維持します

本番環境：https://mcp.devcycle.com
ステージング環境：https://devcycle-mcp-server-staging.devcycle.workers.dev

アーキテクチャ

• 基底クラス：agents パッケージの McpAgent を継承し、MCP プロトコルを処理します
• メインクラス：DevCycleMCP — ツールの登録と状態を管理します
• 認証：Auth0 統合と同意画面を備えた OAuth 2.0 フロー
• トランスポート：MCP プロトコル用に、SSE（/sse）と標準 HTTP（/mcp）の両エンドポイントを提供します
• API クライアント：WorkerApiClient — 状態管理機能を備えた OAuth ベースの API クライアント
• 状態管理：Durable Objects によってセッションとプロジェクトの選択状態を永続化します
• ツールの登録：CLI の共通ツールを Worker 向けに調整して使用します

本番環境の設定

MCP Worker は、devcycle.com ゾーンの mcp.devcycle.com にある Cloudflare Workers にデプロイされます。

インフラストラクチャ

• Worker 名：devcycle-mcp-server
• 本番環境 URL：https://mcp.devcycle.com
• ゾーン：devcycle.com
• ルートパターン：mcp.devcycle.com/*

ストレージ

• KV 名前空間：OAUTH_KV — OAuth セッションデータを保存します
• Durable Objects：DevCycleMCP クラス — プロジェクトの選択状態など、セッションごとの状態を維持します

シークレット（Cloudflare ダッシュボードで設定）

• AUTH0_CLIENT_ID：DevCycle の Auth0 アプリケーションのクライアント ID
• AUTH0_CLIENT_SECRET：DevCycle の Auth0 アプリケーションのクライアントシークレット

ローカル開発

セットアップ

# Install dependencies
yarn install

# Start development server (runs on http://localhost:8787)
yarn dev

利用可能なエンドポイント

• /sse — MCP Server-Sent Events エンドポイント
• /mcp — 標準 HTTP MCP エンドポイント
• /oauth/* — OAuth フローのエンドポイント（authorize、callback、consent）
• /health — ヘルスチェックエンドポイント

Claude Desktop でのテスト

{
  "mcpServers": {
    "devcycle-local": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8787/mcp"]
    }
  }
}

ユーザーフロー

1. エンドポイントを使って AI アシスタントを設定します
2. 初回接続時に OAuth で認証します
3. select_project ツールでプロジェクトを選択します
4. DevCycle のフィーチャーフラグ用ツールを使用します

デプロイ

本番環境へのデプロイ

本番 Worker は次のコマンドでデプロイします。

yarn deploy

これにより、ルート mcp.devcycle.com/* を持つ devcycle-mcp-server Worker にデプロイされます。

重要：本番環境へのデプロイは、手動ではなく CI/CD パイプラインを通じて行ってください。

認証

Worker は DevCycle の Auth0 テナントで OAuth 2.0 を使用します。初回接続時の流れは次のとおりです。

1. ユーザーに、要求された権限が表示された DevCycle の同意画面が表示されます
2. Auth0 で認証します
3. Worker は次の JWT クレームを含む OAuth トークンを受け取ります。
   • org_id：DevCycle 組織 ID
   • project_key：デフォルトのプロジェクト（設定されている場合）
   • email：ユーザーのメールアドレス
   • name：表示名
4. すべての DevCycle API 呼び出しにアクセストークンが使用されます

利用可能なツール

DevCycle CLI のすべての MCP ツールを利用できます。詳細なパラメーターについては、完全なリファレンスをご覧ください。

プロジェクト：select_project、list_projects、get_current_project

機能：list_features、create_feature、update_feature、update_feature_status、delete_feature

ターゲティング：set_feature_targeting、list_feature_targeting、update_feature_targeting

変数：list_variables、create_variable、update_variable、delete_variable

環境：list_environments、get_sdk_keys

セルフターゲティング：get_self_targeting_identity、update_self_targeting_identity、list_self_targeting_overrides、set_self_targeting_override、clear_feature_self_targeting_overrides

分析：get_feature_total_evaluations、get_project_total_evaluations、get_feature_audit_log_history

イベント

ユーザーがホスト型 MCP Worker で OAuth を完了すると、初回インストール時に Worker が Ably イベントを 1 つ発行します。

• チャンネル：${orgId}-mcp-install
• イベント名：mcp-install

MCP ツールのトークン数

MCP ツールの説明とスキーマが消費する AI トークン数を測定します。測定スクリプトを（リポジトリのルートから）実行します。

yarn install &&
yarn measure:mcp-tokens

このスクリプトの動作：

• gpt-tokenizer（OpenAI 形式）と @anthropic-ai/tokenizer（Anthropic）を使用して、各ツールの description と inputSchema のトークン数をカウントします。

現在のトークン数：

{
  "totals": {
    "anthropic": 10428,
    "openai": 10746
  }
}