# fentaris

> The centralized MCP proxy for routing tools, enforcing policy, and shipping observability.

## Docs

- [Architecture](https://fentaris.mintlify.app/concepts/architecture.md): Understand how Fentaris routes clients to upstream MCP servers.
- [Identity and Auth](https://fentaris.mintlify.app/concepts/identity-and-auth.md): Understand how Fentaris resolves users and protects local credentials.
- [Observability](https://fentaris.mintlify.app/concepts/observability.md): Understand how Fentaris exposes logs, health, profiler events, and runtime diagnostics through the high-level API.
- [Policies](https://fentaris.mintlify.app/concepts/policies.md): Understand how Fentaris controls tool access per user or group.
- [Servers and Transports](https://fentaris.mintlify.app/concepts/servers-and-transports.md): Understand upstream MCP servers and the transports Fentaris can route through.
- [Agent Skills](https://fentaris.mintlify.app/getting-started/codex-skills.md): Install the optional Fentaris skills for agent-assisted setup and development.
- [Installation](https://fentaris.mintlify.app/getting-started/installation.md): Install Fentaris and prepare your local environment.
- [Quickstart](https://fentaris.mintlify.app/getting-started/quickstart.md): Create a Fentaris project, run the local proxy, and connect an MCP client.
- [Setup](https://fentaris.mintlify.app/getting-started/setup.md): Configure a Fentaris proxy with the high-level TypeScript API.
- [Tutorial](https://fentaris.mintlify.app/getting-started/tutorial.md): Build a multi-server proxy step by step with the modern Fentaris app API.
- [Client Configs](https://fentaris.mintlify.app/guides/client-configs.md): Point MCP clients at the local Fentaris endpoint.
- [End-to-end examples](https://fentaris.mintlify.app/guides/end-to-end.md): Full examples with multi-server routing, policy, and logging.
- [Error handling](https://fentaris.mintlify.app/guides/error-handling.md): How Fentaris surfaces errors and how to customize them.
- [Flow diagrams](https://fentaris.mintlify.app/guides/flows.md): Visualize Fentaris request routing and lifecycle.
- [Governance auth](https://fentaris.mintlify.app/guides/governance-auth.md): Declare users, groups, policy, API-key identity, and local upstream credentials.
- [Hooks](https://fentaris.mintlify.app/guides/hooks.md): Intercept tool calls with fine-grained filters.
- [Logger](https://fentaris.mintlify.app/guides/logger.md): Configure structured logging for Fentaris proxies with tags, metadata, redaction, and custom drivers.
- [Middleware](https://fentaris.mintlify.app/guides/middleware.md): Enforce policy and transform tool calls.
- [Multi-server routing](https://fentaris.mintlify.app/guides/multi-server.md): Aggregate multiple MCP servers behind one proxy.
- [Observability](https://fentaris.mintlify.app/guides/observability.md): Structured logging and monitoring patterns.
- [Proxy setup](https://fentaris.mintlify.app/guides/proxy-setup.md): Configure a production-shaped Fentaris proxy with high-level declarations.
- [SDK-Only Secrets](https://fentaris.mintlify.app/guides/sdk-only-secrets.md): Use local Fentaris secrets commands without a generated Fentaris project.
- [Security](https://fentaris.mintlify.app/guides/security.md): Security practices and patterns for Fentaris proxies.
- [Telegram approval](https://fentaris.mintlify.app/guides/telegram-approval.md): Gate sensitive Fentaris tool calls with a Telegram approve/deny step that you pass to a policy permission.
- [](https://fentaris.mintlify.app/index.md)
- [API Reference (Auto)](https://fentaris.mintlify.app/reference-auto/index.md): Autogenerated API reference from TypeScript sources.
- [Autogen status](https://fentaris.mintlify.app/reference-auto/status.md): How the API reference is generated.
- [CLI Usage](https://fentaris.mintlify.app/reference/cli.md): Run, validate, build, and inspect Fentaris projects from the command line.
- [Config File](https://fentaris.mintlify.app/reference/config-file.md): Configure Fentaris project discovery, runtime entrypoint, endpoint, and local auth directory.
- [Environment Variables](https://fentaris.mintlify.app/reference/environment-variables.md): Configure optional local credentials and runtime health checks with Fentaris environment variables.
- [Extension API](https://fentaris.mintlify.app/reference/extension-api.md): Public API tiers and supported extension contracts for @fentaris/core.
- [Logger](https://fentaris.mintlify.app/reference/logger.md): Reference for Fentaris logging primitives.
- [McpProxy](https://fentaris.mintlify.app/reference/mcp-proxy.md): Reference for the Fentaris proxy API.
- [McpServer](https://fentaris.mintlify.app/reference/mcp-server.md): Reference for declaring upstream MCP servers.
- [StdioTransport](https://fentaris.mintlify.app/reference/stdio-transport.md): Reference for connecting to local MCP servers over stdio.
- [Types](https://fentaris.mintlify.app/reference/types.md): Core types used across Fentaris.
- [Troubleshooting](https://fentaris.mintlify.app/troubleshooting.md): Common issues and how to resolve them.