Guides

Task-focused walkthroughs. Every command and file in them was run as written.

• What MCP is, and what Kervan adds

  The Model Context Protocol explained in plain terms; servers, tools, clients and transports, and what the Kervan framework adds on top of the official MCP SDK.

• Build an MCP server from a YAML file

  Step by step, write a kervan.yaml that turns the public Hacker News API into two MCP tools, check it, try it in a REPL, and serve it over stdio or HTTP.

• Expose a REST API as MCP tools

  Turn REST endpoints into MCP tools with Kervan: query strings, path parameters, a JSON POST body, an output schema, and API keys kept out of logs.

• Connect a Kervan server to Claude Code

  Add a Kervan MCP server to Claude Code with claude mcp add, as a local stdio server or over HTTP, check that it connects, and remove it; with Windows notes.

• Self-host a multi-user MCP gateway

  Run Kervan Studio as a self-hosted MCP gateway for a team: install, master key, first admin, a published server, an API key and Claude Code.