Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

docs: link fastmcp-keycloak-local companion project from Keycloak integration page (#3904)

Stephan Eberlea6bd66aca897
diff --git a/docs/integrations/keycloak.mdx b/docs/integrations/keycloak.mdx
index 163706573..22d61f132 100644
--- a/docs/integrations/keycloak.mdx
+++ b/docs/integrations/keycloak.mdx
@@ -60,6 +60,12 @@ async def get_access_token_claims() -> dict:
**Production security**: Always configure the `audience` parameter in production. Without it, your server accepts tokens issued for any audience. Configure Keycloak audience mappers and set `audience` to your server's base URL to ensure tokens are specifically intended for your server.
</Warning>
+## Local Development
+
+Local infrastructure tooling is deliberately kept out of the FastMCP core library to keep auth integrations slim and the associated maintenance burden as low as possible. That said, Keycloak is a popular identity provider for local development and testing, so a dedicated FastMCP-compatible setup blueprint lives in the companion project [**fastmcp-keycloak-local**](https://github.com/stephaneberle9/fastmcp-keycloak-local).
+
+It provides everything needed to develop and test FastMCP servers with Keycloak OAuth locally: a Docker-based Keycloak setup with a pre-configured `fastmcp` realm (Dynamic Client Registration enabled, test user included), cross-platform start scripts, and integration guides for the MCP Inspector, Claude Desktop, and Claude Code CLI.
+
## Testing
### Running the Server