Getting Started Guide

Learn how to build your own enterprise-ready MCP server with WorkOS authentication. Each step guides you through implementing your own business logic while leveraging the powerful authHandler pattern.

1

Clone & Run

Get the template running locally and understand the basic setup

Estimated time: 3 min
2

Understand the AuthHandler Pattern

Learn how the authHandler wrapper transforms any MCP server into an authenticated service

Estimated time: 3 min
3

Implement Your Own Tools

Replace the example tools with your own business logic and learn key patterns

Estimated time: 10 min
4

Organize Your Code

Learn where to put utilities, business logic, and how to structure larger MCP servers

Estimated time: 5 min
5

Connect MCP Clients

Configure Claude, Cursor, and other MCP clients to use your server

Estimated time: 8 min
6

Deploy to Production

Deploy your authenticated MCP server to Vercel with proper environment configuration

Estimated time: 5 min
7

Verify Your Server

Test your deployed MCP server using the official Model Context Protocol Inspector

Estimated time: 5 min
Start Building Your MCP Server

Complete guide • 30 minutes • From zero to production