Vooster MCP Setup + Getting Started with Development
How to useDecember 15th, 202510 min read

Vooster MCP Setup + Getting Started with Development

How to connect Vooster MCP to Claude Code and Cursor in 5 minutes. Step-by-step guide from @vooster/mcp package setup to API key configuration and implementing your first task.

Planning Done, But How Do I Start Coding?

"Great, I've created the PRD and completed the TRD. Now what?"

You've fleshed out your idea in Vooster AI and automatically generated seven planning documents. Your tasks are neatly broken down. But when you're ready to start coding, it feels overwhelming. How do you convey all this context to your AI coding tool?

Remember Vooster AI's 7-step workflow?

1️⃣ Enter your idea in Vooster AI 2️⃣ (Optional) Apply FullSaaS template 3️⃣ Collaborate with AI planner agent 4️⃣ 7 documents + prompts generated! 5️⃣ Connect Vooster AI MCP ← You are here! 6️⃣ Command: "vooster-ai, implement this" 7️⃣ Done

This article covers step 5 — MCP integration — all the way to actually starting development. You can complete it in 5 minutes. No complex setup. Just one simple JSON file.

If you're curious about what MCP is, read "AI Coding Tools in 2025: $40B Invested, But Here's How to Actually Use Them Right" first.

Prerequisites - Verify Vooster Planning Complete

7 planning documents complete

Before integrating MCP, make sure your planning is complete in Vooster AI.

Check All 7 Documents Generated

In the Vooster AI dashboard, verify that all of these documents have been created:

  1. PRD (Product Requirements Document) - Defines product requirements
  2. TRD (Technical Requirements Document) - Tech stack and architecture
  3. User Journey - Visualizes user flows
  4. ERD (Entity Relationship Diagram) - Database design
  5. Design Guide - Colors, typography, UI components
  6. IA (Information Architecture) - Sitemap, navigation
  7. Code Guideline - Coding rules and conventions

These documents are the blueprint that your AI coding tool will read. If they're not complete, finish your planning in Vooster AI first.

Confirm Task Breakdown Complete

Check the task list in Vooster AI's Kanban board. You should see specific tasks like "Implement user registration feature" or "Integrate payment system."

If tasks haven't been broken down yet, collaborate with the AI planner agent to refine them. You can find detailed instructions in the Beginner's Guide to Building a Next.js SaaS.

Get Your API Key

API key generation

You'll need a Vooster API key for MCP integration. Getting one is very simple.

How to Generate

  1. Go to Vooster AI dashboard (vooster.ai)
  2. Click your profile in the top-right corner → Settings
  3. Navigate to the API Keys tab
  4. Click the "Generate New API Key" button
  5. Copy the generated key and store it safely

⚠️ Important: The API key is displayed only once. After copying, save it in a secure location. If you lose it, you'll need to generate a new one.

Security Notes

Connect MCP in Claude Code

Claude Code MCP integration

Claude Code is Anthropic's official CLI tool. It runs in the terminal and specializes in understanding your entire project.

Create Configuration File

Create a .mcp.json file in your project's root directory:

{
  "mcpServers": {
    "vooster-ai": {
      "command": "npx",
      "args": ["-y", "--package=@vooster/mcp@latest", "vooster-ai", "--api-key=YOUR_API_KEY"],
      "type": "stdio"
    }
  }
}

Replace YOUR_API_KEY with the actual API key you generated earlier.

Verify Connection

  1. Restart Claude Code
  2. Start a new conversation
  3. Type "Show me my project list"
  4. If your Vooster AI project list appears, the connection was successful!

Troubleshooting

Q: I'm getting an "mcpServers not found" error A: Make sure the .mcp.json file is in the project root. It won't be recognized in subfolders.

Q: I'm getting an "Authentication failed" error A: Verify that your API key is correct. It shouldn't include spaces or quotes.

Connect MCP in Cursor

Cursor MCP integration

Cursor is an AI-native editor based on VS Code. It's optimized for real-time code writing and instant AI assistance.

Create Configuration File

Create a .cursor folder in your project root, then create an mcp.json file inside:

mkdir -p .cursor

.cursor/mcp.json file contents:

{
  "mcpServers": {
    "vooster-ai": {
      "command": "npx",
      "args": ["-y", "--package=@vooster/mcp@latest", "vooster-ai", "--api-key=YOUR_API_KEY"],
      "type": "stdio"
    }
  }
}

Again, replace YOUR_API_KEY with your actual key.

Verify in Cursor

  1. Restart Cursor
  2. Press Cmd/Ctrl + Shift + P → search for "Settings"
  3. In the MCP Servers section, check that "vooster-ai" is active
  4. Type "Show me my Vooster project list" in the AI chat
  5. If the project list appears, you've succeeded!

Useful Shortcuts

Connect to Your Project

Once MCP integration is complete, you need to select the project you'll work on.

Check Project List

Talk to your AI coding tool like this:

You: "Show me my project list"

AI: [Executes list_projects tool]

Project List:
1. proj_abc123 - E-commerce SaaS
2. proj_def456 - Blog Platform
3. proj_ghi789 - E-commerce Dashboard

Connect to a Project

Copy the project ID you want to work on and connect:

You: "Connect to project proj_abc123"

AI: [Executes connect_project tool]

✅ Connected to "E-commerce SaaS" project.
You can now access PRD, TRD, and Task list.

Test Document Access

Verify the connection worked:

You: "Show me the PRD"

AI: [Executes read_prd tool]

=== Product Requirements Document ===

Project Name: E-commerce SaaS
Target Users: Individual sellers and small business owners

Key Features:
1. Product management system
2. Order and payment processing
3. Customer management CRM
...

If the PRD displays correctly, all setup is complete!

Implement Your First Task ⭐

Task-based development

It's finally time to start coding. Just implement the tasks that Vooster AI broke down, one at a time.

Check Your Next Task

Ask the AI for the highest priority task:

You: "What's my next task?"

AI: [Executes get_next_task tool]

🎯 Next Priority Task

🆔 ID: T-001
📋 Title: Implement User Registration Feature
📊 Status: backlog
⏰ Priority: high

📝 Description:
Implement a feature that allows users to register with email and password.
Include email verification using the Clerk authentication library.

✅ Sub-tasks:
1. Implement signup form UI (React Hook Form)
2. Implement email verification logic
3. Clerk integration and setup
4. Update Prisma User schema

💡 Reference Documents:
- PRD Section 3.1: User Authentication
- TRD Section 2.3: Clerk Setup
- Design Guide: Form Component Styles

Start Implementing the Task

Ask the AI to implement it:

You: "Implement T-001"

AI: "Sure, I'll start implementing task T-001 'Implement User Registration Feature.'

I've reviewed the relevant documents:
- According to the PRD, email verification is required
- The TRD recommends using the Clerk library
- Following the Code Guideline, I'll use React Hook Form

Implementation order:
1. Install and configure Clerk
2. Create signup form component
3. Implement email verification flow
4. Update Prisma schema

Shall I begin?"

You: "Yes, start"

AI: [Starts writing actual code]

✅ Step 1/4: Clerk installation complete
✅ Step 2/4: SignUpForm component created
✅ Step 3/4: Email verification logic implemented
✅ Step 4/4: Prisma schema updated

Task T-001 is complete!
Testing instructions:
1. Run `pnpm dev`
2. Go to /signup page
3. Enter email and check verification email

Key Points

With MCP:

Just one line, "Implement T-001," is enough!

Update Task Status

When work is complete, update the status:

You: "Mark T-001 as done"

AI: [Executes update_task_status tool]

✅ Task T-001 status changed to 'done'.

Next priority task:
🆔 ID: T-002
📋 Title: Implement Login Feature

The Kanban board in Vooster AI dashboard also updates in real-time!

Using the FullSaaS Template

FullSaaS monorepo structure

If you're a MAX plan user, take advantage of the FullSaaS template. Combined with MCP, your development speed increases by 3x or more.

What's Included in FullSaaS Template

  1. Complete authentication system: Clerk-based signup/login
  2. Subscription payments: Stripe integration for SaaS billing ready
  3. Admin dashboard: User management, analytics, settings pages
  4. Monorepo structure:
    • apps/www: Landing page (Next.js)
    • apps/app: Dashboard (Next.js)
    • packages/*: Shared libraries
  5. tRPC API: Type-safe API communication
  6. Prisma ORM: PostgreSQL database management

Benefits of MCP + FullSaaS Combination

Using MCP alone without template:

Template + MCP combination:

How to Apply the Template

When creating a project in Vooster AI, select the "Use FullSaaS Template" option. AI will automatically generate PRD and TRD tailored to the template structure.

MCP Tools Overview

Here's a summary of the tools Vooster MCP provides. The AI uses them automatically, but knowing them helps make conversations more precise.

CategoryToolDescription
Projectlist_projectsList all projects
connect_projectConnect to a specific project
disconnect_projectDisconnect from project
Document Readingread_prdRead PRD document
read_trdRead TRD document
read_code_guidelineRead coding guidelines
read_design_guideRead design guide
read_user_journeyRead user journey
read_erdRead ERD diagram
read_iaRead IA document
Taskslist_taskList all tasks
get_next_taskGet next priority task
get_taskGet specific task details
update_task_statusUpdate task status (backlog/in_progress/done)

Practical Usage Examples

# Switch projects
"Switch to proj_def456"

# Check specific document
"Show me just the database design section from the TRD"

# Filter tasks
"Show me only backend-related tasks"

# Next 3 priority tasks
"Tell me the next 3 tasks to do"

# Search tasks
"Find tasks related to login"

Conclusion - 7 Steps Complete, Only Implementation Left

We've covered how to integrate Vooster MCP. Let's recap the 7-step workflow:

1️⃣ Enter your idea in Vooster AI ✅ 2️⃣ (Optional) Apply FullSaaS template ✅ 3️⃣ Collaborate with AI planner agent ✅ 4️⃣ 7 documents + prompts generated! ✅ 5️⃣ Connect Vooster AI MCP ✅ ← Completed in this article! 6️⃣ Command: "vooster-ai, implement this" ← Now here! 7️⃣ Done

What You Can Do in 5 Minutes

Total: 5 minutes to complete all preparation from planning to coding.

With Vooster AI

Good code starts with good planning. Vooster AI creates the plan, MCP connects it to AI, and your AI coding tool executes.

From idea to implementation, AI accompanies every step.

Start Now

Get started for free at Vooster AI:

  1. Refine your idea through conversations with AI planner
  2. Auto-generate 7 documents
  3. Connect MCP to Claude Code/Cursor
  4. Start development with a single question: "What's my next task?"

Turn your idea into reality today with Vooster AI!

Start Structured Vibe Coding with Vooster

From PRD generation to technical design and task creation - AI helps you every step. Start free today.

PRD Generation

Auto-generate detailed requirements

Technical Design

Implementation plan & architecture

Task Generation

Auto-break down & manage dev tasks

No credit card required · Full access to all features

Related Posts

Discord
Vooster MCP Setup + Getting Started with Development