# Convex MCP Setup

> Set up and troubleshoot Convex MCP access, environment variables, and local development workflow without importing Cursor-only plugin behavior.

- Skill: `majiayu000/convex-mcp-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/convex-mcp-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/convex-mcp-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/convex-mcp-setup

---


# Convex MCP Setup

Use this when the task involves Convex MCP configuration, troubleshooting, or explaining how MCP fits local Convex workflows.

## Upstream MCP baseline

The upstream plugin uses this launch command:

```bash
npx -y convex@latest mcp start
```

## Environment

Provide these when deployment access is required:

```bash
CONVEX_DEPLOYMENT=your-deployment-name
CONVEX_DEPLOY_KEY=your-deploy-key
```

## Local guidance

- Treat upstream `mcp.json` as source material, not as a file to install directly into this repo.
- Do not port Cursor plugin manifests or hooks as active repo behavior.
- Use `npx convex dev` for normal development and reserve `npx convex deploy` for production.
- Agent mode is mainly for cloud-hosted coding agents. Local agents usually do not need it.

## References

- Read [mcp-troubleshooting.md](/Users/eduardojaviergarcialopez/AgenticEngineering/agentforge/.agents/skills/convex-mcp-setup/references/mcp-troubleshooting.md) for setup checks and common failures.