convex-agent-skillz MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

Convexの深いパターン — クエリ、ミューテーション、アクション、HTTPエンドポイント
リアルタイム機能：プレゼンス、ストリーミング、共同編集
永続オペレーション：ワークフロー、キュー、スケジュールタスク
認証パターン — ユニバーサル、およびClerk・WorkOS固有の設定
AIエージェントパターン：スレッド、ツール呼び出し、RAG、永続メッセージ履歴

ライブデモ

実際の動作

convex-agent-skillz-skill.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "convex-agent-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "convex-agent-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "convex-agent-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "convex-agent-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "convex-agent-skillz-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "convex-agent-skillz-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/PolarCoding85/convex-agent-skillz",
          "~/.claude/skills/convex-agent-skillz"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add convex-agent-skillz-skill -- git clone https://github.com/PolarCoding85/convex-agent-skillz ~/.claude/skills/convex-agent-skillz

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： convex-agent-skillz

既存のConvexアプリにリアルタイムプレゼンスを追加する

👤 コラボレーション機能を追加したいConvex開発者 ⏱ ~45 min intermediate

使うタイミング： アプリがあり、ソケットサーバーを立てずにFigmaのような「誰がいるか」インジケーターを実装したい場合。

前提条件

スキルをプロジェクトの .claude フォルダにコピー済みであること — git clone https://github.com/PolarCoding85/convex-agent-skillz を実行し、.claude/ をプロジェクトルートにコピー

フロー

機能を説明する

Using the Convex skillz — add presence to the documents page. Show cursors and usernames.✓ コピーしました

→ Claudeがカスタム WebSocket ではなく、Convexのプレゼンスパターン（ミューテーション＋リアクティブクエリ）で実装する
切断時の処理

What about cleanup when users close the tab?✓ コピーしました

→ Convexの慣例に沿った、古いプレゼンスのクリーンアップ戦略

結果： 適切なクリーンアップを備えた動作するプレゼンス機能。

注意点

Convexのリアクティビティと競合するカスタムプレゼンスパターン — スキルが慣用的なバージョンへ誘導します。明確な理由なくオーバーライドしないでください

組み合わせ： filesystem

Clerk認証をConvexに正しく統合する

👤 新規または既存のConvexアプリにClerkを組み込む開発者 ⏱ ~30 min intermediate

使うタイミング： Clerkを選択し、Convexとの統合を最初から正しく設定したい場合。

フロー

プロバイダーを接続する

Convex skillz — integrate Clerk auth with Convex. Set up the JWT template and the Convex auth config.✓ コピーしました

→ Claudeが正しいClerk JWTテンプレート名と auth.config.ts のセットアップを参照する
クエリを保護する

Now gate the documents query so only the owner can read.✓ コピーしました

→ ctx.auth.getUserIdentity() パターンと適切なアイデンティティチェック

結果： コードレビューに合格し、テナント間でデータが漏洩しない認証。

Convex上で永続スレッドを持つAIエージェントを構築する

👤 チャットまたはエージェントプロダクトを開発する開発者 ⏱ ~90 min advanced

使うタイミング： セッションをまたいで保持されるスレッド化されたメッセージ履歴が必要な場合。

フロー

スレッドをモデリングする

Convex skillz — agent threads table + message history + tool calling metadata.✓ コピーしました

→ ストリーミング、部分メッセージ、ツール呼び出し状態をカバーするスキーマ
ストリーミングを接続する

Stream the assistant response back via a reactive query.✓ コピーしました

→ Convexのリアクティビティを活用した部分メッセージパターン

結果： スケール可能なConvexネイティブのエージェントスレッドレイヤー。

組み合わせ

他のMCPと組み合わせて10倍の力を

convex-agent-skillz-skill + github

Convexの慣例に沿ったdiffで機能追加のPRを作成する

Implement the presence feature, commit and open PR with the Convex skill patterns noted.✓ コピーしました

convex-agent-skillz-skill + filesystem

スキーマ、関数、UIを1セッションで横断的に作業する

Update convex/schema.ts, add the mutation, and wire up the React hook.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング
queries_mutations_actions	feature intent	convex/ での全般的な作業
realtime_patterns	feature (presence / streaming / collab)	リアルタイム機能
auth_setup	provider (Clerk / WorkOS / custom)	認証の接続
durable_ops	workflow intent	長時間実行またはリトライが多いロジック
ai_agent_threads	agent feature description	Convex上のエージェントプロダクト

コストと制限

運用コスト

APIクォータ: スキル自体からのAPI消費なし
呼び出しあたりのトークン: 中程度 — パターンはコンテキストに応じて必要時にロードされます
金額: 無料 — スキルはローカルファイルです。Convex自体には独自の料金体系があります。
ヒント: スキルはグローバルではなくプロジェクトの .claude/ に配置してください — 自動有効化はプロジェクトスコープで最も効果的に機能します。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： スキル内にクレデンシャルはありません。認証プロバイダーのシークレットはご自身の環境変数に保持されます。

データ送信先： スキルからのデータ送出なし — コードはローカルに留まります

認証パターンは、Clerk/WorkOSでJWTテンプレートが正しくコンフィグされていることを前提としています — 併せて各サービスのドキュメントもお読みください。

トラブルシューティング

よくあるエラーと対処法

スキルが呼び出されない — ClaudeがConvexの慣用的でないコードを生成する

「use the Convex skillz」と明示するか、convex/ ディレクトリ内で作業していることを確認してください。

確認： ls <project>/.claude/agents/convex-expert.md

SKILL.md frontmatter wrong

リポジトリから .claude/ を再コピーしてください。

確認： head <project>/.claude/skills/*/SKILL.md

Wrong trigger keywords — 認証パターンが指定のプロバイダーを使用しない

プロバイダー名を明示的に指定してください（「with Clerk」/「with WorkOS」）。

代替案

convex-agent-skillz 他との比較

代替案	代わりに使う場面	トレードオフ
Convex official docs	厳選されたスキルではなく一次情報を参照したい場合	エージェント内での自動有効化なし
Hand-rolled patterns	Convexの経験が豊富な開発者の場合	パターンを自前で再実装することになります。スキルはClaudeがあなたのパターンを一貫して使うようにするだけです

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る