frontmcp-config

name	frontmcp-config
description	Use when configuring a FrontMCP server through frontmcp.config or the @FrontMcp options. Covers auth modes (public, transparent, local, remote), OAuth plus credential vault and secureStore, CORS, HTTP port / entry-path prefix / unix socket, security headers (CSP, HSTS, X-Frame-Options, X-Content-Type-Options), rate limiting / throttling / concurrency / timeout / IP filtering (GuardConfig), session storage (Redis, Vercel KV), client transport protocols (SSE, Streamable HTTP, stateless, protocol presets), elicitation, multi-target build config, and skillsConfig (HTTP catalog, caching, audit log, instruction injection). Triggers: configure auth, set up CORS, add rate limiting, throttle requests, manage sessions, choose transport, set HTTP options, configure JWT or OAuth. The skill for server CONFIGURATION.
when_to_use	Trigger when creating or editing frontmcp.config.ts/js or the @FrontMcp({...}) options: configuring auth modes, OAuth + credential vault, CORS, HTTP port / entry path / unix socket, security headers, rate limiting / throttling / GuardConfig, session storage (Redis, Vercel KV), client transport / protocol presets, elicitation, multi-target builds, or skillsConfig.
paths	**/frontmcp.config.*
tags	["router","config","transport","http","auth","session","redis","sqlite","throttle","guide"]
category	config
targets	["all"]
bundle	["recommended","full"]
priority	10
visibility	both
license	Apache-2.0
metadata	{"docs":"https://docs.agentfront.dev/frontmcp/fundamentals/overview"}

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