frontmcp-config

FrontMCP Configuration Router

Entry point for configuring FrontMCP servers. This skill helps you find the right configuration reference (under references/) based on what aspect of your server you need to set up.

When to Use This Skill

Must Use

• Setting up a new server and need to understand which configuration options exist
• Deciding between authentication modes, transport protocols, or storage backends
• Planning server configuration across transport, auth, throttling, and storage

Recommended

• Looking up which reference covers a specific config option (CORS, rate limits, session TTL, etc.)
• Understanding how configuration layers work (server-level vs app-level vs tool-level)
• Reviewing the full configuration surface area before production deployment

Skip When

• You already know which config area to change (go directly to configure-transport, configure-auth, etc.)
• You need to build components, not configure the server (see frontmcp-development)
• You need to deploy, not configure (see frontmcp-deployment)

Decision: Use this skill when you need to figure out WHAT to configure. Open the matching reference under references/ directly when you already know.

Prerequisites

• A FrontMCP project scaffolded with frontmcp create (see frontmcp-setup)
• Node.js 24+ and npm/yarn installed

Steps

1. Identify the configuration area you need using the Scenario Routing Table below
2. Navigate to the specific configuration reference (e.g., references/configure-transport.md, references/configure-auth.md) for detailed instructions
3. Apply the configuration in your @FrontMcp or @App decorator
4. Verify using the Verification Checklist at the end of this skill

Scenario Routing Table

Scenario	Reference	Description
Choose between SSE, Streamable HTTP, or stdio	configure-transport	Transport protocol selection with distributed session options
Set up CORS, port, base path, or request limits	configure-http	HTTP server options for Streamable HTTP and SSE transports
Add rate limiting, concurrency, or IP filtering	configure-throttle	Server-level and per-tool throttle configuration
Enable tools to ask users for input	configure-elicitation	Elicitation schemas, stores, and multi-step flows
Set up authentication (public, transparent, local, remote)	configure-auth	OAuth flows, credential vault, multi-app auth
Configure session storage backends	configure-session	Memory, Redis, Vercel KV, and custom session stores
Add Redis for production storage	setup-redis	Docker Redis, Vercel KV, pub/sub for distributed subscriptions
Add SQLite for local development	setup-sqlite	SQLite with WAL mode, migration helpers
Understand auth mode details (public/transparent/local/remote)	configure-auth-modes	Authentication mode details (public, transparent, local, remote)
Fine-tune guard configuration for throttling	configure-throttle-guard-config	Advanced guard configuration for throttling
Use transport protocol presets	configure-transport-protocol-presets	Transport protocol preset configurations
Configure multi-target deployments and frontmcp.config.ts	configure-deployment-targets	Typed config with defineConfig(), 9 deployment targets, JSON schema
Add CSP, HSTS, X-Frame-Options, and other security headers	configure-security-headers	CSP directives, report-only mode, HSTS preload, custom headers
Configure skills HTTP, instructions injection, or audit log	configure-skills-http	Full skillsConfig reference: auth, cache, instructions, audit log
Split apps into separate scopes (splitByApp)	decorators-guide	Per-app scope and basePath isolation on @FrontMcp
Enable widget-to-host communication (ext-apps)	decorators-guide	extApps host capabilities, session validation, widget comms
Enable background jobs and workflows	decorators-guide	jobs: { enabled: true, store? } on @FrontMcp
Configure pagination for list operations	decorators-guide	pagination defaults for tools/list endpoint
Configure npm/ESM package loader for remote apps	decorators-guide	loader config for App.esm() / App.remote() resolution