How to Use the Convex MCP in VS Code Copilot

Q: How do we share the Convex MCP configuration across our team in VS Code Copilot?

You commit a .vscode/mcp.json file to your git repository. This file points to your Vinkius endpoint, giving every developer on your team instant access to the Convex MCP tools.

Q: What happens if a function call times out?

If a call to runfunction times out on the backend, the error is returned directly to Copilot. The agent will read the timeout error and explain what went wrong.

Give your team's VS Code Copilot agent direct access to your Convex backend for instant, collaborative debugging.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Convex MCP to VS Code Copilot

Create your Vinkius account to connect Convex to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Convex with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run backend queries inside VS Code Copilot

The `run_query` tool fetches live data from your Convex tables directly into the Copilot chat panel. This allows your team to inspect database state without leaving their shared workspace configuration. You write a prompt, and Copilot pulls the exact records you need. It changes how your team handles support tickets. Instead of querying databases manually, developers can ask Copilot to pull the relevant records, letting the agent analyze the raw JSON on the spot.

Execute mutations securely using this MCP Server

The `run_mutation` tool executes database writes directly from your VS Code Copilot session. This lets you patch data issues or seed test records right from the chat interface. You don't need to distribute database credentials to everyone on the team. Because VS Code Copilot supports shared team configurations, every engineer gets access to these tools instantly. The writes run through your defined Convex mutations, ensuring all backend validation rules are strictly enforced.

Trigger actions and functions from VS Code Copilot

The `run_action` tool runs complex backend jobs and side effects from your VS Code Copilot panel. If you need to trigger a webhook or test an external integration, you can initiate it directly through the chat. For specific logic, you can also use `run_function` to target any custom endpoint. Copilot handles the payload serialization, making it easy to test backend behavior during collaborative coding sessions.

Setup guide

Set up Convex MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Convex MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Convex tools listed. Try asking: "List my recent Convex transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "convex-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Convex. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Convex now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Convex MCP in VS Code Copilot

You commit a `.vscode/mcp.json` file to your git repository. This file points to your Vinkius endpoint, giving every developer on your team instant access to the Convex MCP tools.

Yes, if your configured endpoint has production access. The MCP Server will execute writes against whichever environment your Vinkius token is configured to target.

Vinkius handles the underlying authentication. Your team only needs to configure the single endpoint token in their local VS Code Copilot settings to start running queries and mutations.

If a call to `run_function` times out on the backend, the error is returned directly to Copilot. The agent will read the timeout error and explain what went wrong.

All data transit is encrypted using TLS. The database records and query arguments are processed in ephemeral V8 isolates that spin down immediately after the tool execution completes, leaving zero traces of your database state on our systems.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript