convexskills MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

12 Convex-specific skills with real code examples
Covers functions (query/mutation/action/HTTP), schema, realtime, cron, file storage, agents
Two security skills: convex-security-check and convex-security-audit
Migration patterns for schema evolution
convex-component-authoring for reusable components

라이브 데모

실제 사용 모습

convexskills-skill.replay ▶ 준비됨

0/0

설치

클라이언트 선택

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

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

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

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

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

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

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

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "convexskills-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/waynesutton/convexskills",
        "~/.claude/skills/convexskills"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "convexskills-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/waynesutton/convexskills",
          "~/.claude/skills/convexskills"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add convexskills-skill -- git clone https://github.com/waynesutton/convexskills ~/.claude/skills/convexskills

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: convexskills

Scaffold a new Convex app with realtime + auth + file uploads

👤 Full-stack devs starting a new Convex project ⏱ ~90 min intermediate

언제 쓸까: You're starting fresh and want correct Convex patterns from file one.

사전 조건

Convex CLI — npm create convex

흐름

Design the schema

Use the convex-schema-validator skill. Design tables for users, projects, and files with proper indices.✓ 복사됨

→ Schema uses v.id(), indices declared, relationships correct
Wire queries and mutations

Use the convex-functions skill. Implement CRUD for projects.✓ 복사됨

→ Query for reads, mutation for writes, no action misuse
Add realtime + file uploads

Use convex-realtime and convex-file-storage to make projects live-update with file attachments.✓ 복사됨

→ React subscribes via useQuery, files stored via storage.generateUploadUrl

결과: A correctly-structured Convex app you can build on.

함정

Using actions where mutations suffice — Skill enforces: mutations for DB writes, actions for external I/O

Add a daily cron job that cleans up stale rows

👤 Convex devs adding background maintenance ⏱ ~20 min beginner

언제 쓸까: You need a scheduled task without spinning up a worker.

흐름

Use the cron skill

Use convex-cron-jobs. Add a daily job that deletes rows older than 30 days from table sessions.✓ 복사됨

→ crons.ts entry + internal mutation for the cleanup
Test

Give me a way to trigger this manually for testing.✓ 복사됨

→ Dev-only HTTP action or CLI recipe

결과: A cron running on Convex's managed scheduler.

함정

Cron runs a query instead of internal mutation — Skill enforces internal mutation for deletes

Audit a Convex app for authorization holes

👤 Devs before a production launch ⏱ ~45 min advanced

언제 쓸까: Your app is ready but you haven't pressure-tested auth.

흐름

Run the audit

Use convex-security-audit on this repo. Check every public mutation for proper auth.✓ 복사됨

→ Per-function auth posture with severity
Fix

Apply the fixes with identity checks and fallback to return null for unauthorized reads.✓ 복사됨

→ Functions updated with ctx.auth checks

결과: Auth tightened before production.

함정

Relying on 'public=unauthenticated' mental model — Convex public functions are INTERNET-reachable; skill insists on auth checks

함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

convexskills-skill + github

Skill designs + implements; GitHub MCP opens the PR

Use convexskills to build the feature, then open a PR with the changes.✓ 복사됨

convexskills-skill + playwright-skill

Build Convex backend, then Playwright tests the UI end-to-end

Implement the Convex backend, then write a playwright-skill test that hits the UI and verifies realtime updates.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
convex-functions	function need	Any function work
convex-schema-validator	data model	Designing or changing tables
convex-realtime	UI use case	Adding reactive UI
convex-cron-jobs	scheduled task	Periodic background work
convex-migrations	schema change	Evolving an existing schema
convex-security-audit	repo	Pre-production review

비용 및 제한

운영 비용

API 쿼터: None for the skill; Convex has its own free + paid tiers
호출당 토큰: 2-6k per skill loaded
금액: Free — skill is local. Convex has a generous free tier.
팁: Name the specific skill (e.g. convex-cron-jobs) to avoid loading the full set.

보안

권한, 시크릿, 파급범위

자격 증명 저장: No credentials in the skill. Convex deploy keys stay in your .env.

데이터 외부 송신: None from the skill itself

Convex public functions are Internet-reachable. Always run convex-security-audit before going to production.

문제 해결

자주 발생하는 오류와 해결

Claude writes an action when a mutation suffices

Rule of thumb the skill enforces: DB-only → mutation; external I/O → action.

Schema change breaks existing data

Use convex-migrations skill — it plans safe transitions with backfill.

useQuery doesn't update in realtime

Check reactivity: the query must read the data that changed, not a stale index.

대안

convexskills 다른 것과 비교

대안	언제 쓰나	단점/장점
Manual Convex docs + examples	You're already an experienced Convex dev	Slower onboarding without the skill
Framework-specific fullstack skills	You're not on Convex	Different stack

convexskills