> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcpmanager.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tutorials

> Hands-on, guaranteed-to-work lessons for MCP Manager: connect your first MCP server and call a tool, connect an AI client to a gateway, connect a workstation server running on your own machine, build a team gateway, add your first gateway rule, redact PII from tool responses with Presidio, trace a tool call in the logs, run a headless agent with an API token, and build a custom rule engine.

These pages are step-by-step references that take a single path from start to a working result. Each one uses concrete values you can copy and tells you what you should see at every step. Follow them in order to set up the core of **MCP Manager**: adding a server, packaging it in a gateway, governing it, observing it, and driving it from code.

For task-oriented guidance you adapt to your own situation, see the [deployment guides](/deployment/gateway-deployment-strategies); for the concepts behind what you're doing, start with the [Introduction](/get-started/introduction).

<Info>
  You'll need an MCP Manager workspace. A few steps (adding servers, creating gateways, inviting people) depend on capabilities your role may or may not have — each tutorial flags the capability it needs near the top. If a button or page in a tutorial isn't visible to you, that's the capability talking, not a wrong turn.
</Info>

## Start here

The two first-win lessons — one for an administrator standing the system up, one for a person who was handed a gateway URL.

<CardGroup cols={2}>
  <Card title="Your first governed tool call" icon="rocket" href="/tutorials/first-tool-call">
    Add the public docs MCP server, put it behind a gateway, connect your AI client, call a tool, and watch the request land in your audit log. About five minutes.
  </Card>

  <Card title="Connect your AI client to a gateway" icon="plug" href="/tutorials/connect-your-ai-client">
    Add a gateway URL to Claude, Claude Code, Cursor, or VS Code, authorize, and start using its tools. About five minutes.
  </Card>
</CardGroup>

## Connect your own servers

Bring a server that isn't on the public internet under the same governance.

<CardGroup cols={2}>
  <Card title="Connect a workstation MCP server" icon="laptop" href="/tutorials/connect-a-workstation-server">
    Run an MCP server on your own machine and connect it through an encrypted tunnel — nothing exposed to the internet, no firewall changes, fully logged. About ten minutes.
  </Card>
</CardGroup>

## Run it for your team

Go from a single connection to a governed, observable rollout: scope tools to a team, add a guardrail, and learn to read what happened.

<CardGroup cols={2}>
  <Card title="Build a team gateway" icon="users" href="/tutorials/team-gateway">
    Create a team, build a gateway for it, trim its tools, invite a teammate, and confirm they see only that gateway.
  </Card>

  <Card title="Add your first gateway rule" icon="shield-halved" href="/tutorials/first-gateway-rule">
    Add a rule that detects sensitive data, run it in a non-blocking alert configuration, trigger it, and see it fire.
  </Card>

  <Card title="Redact PII with Presidio" icon="user-shield" href="/tutorials/pii-filtering">
    Add a Presidio rule on the response leg, fail it closed, and watch an email get replaced with a typed tag.
  </Card>

  <Card title="Trace a call in your logs" icon="magnifying-glass" href="/tutorials/trace-in-logs">
    Follow one tool call through the logs and answer who did what, when, and through which tool.
  </Card>
</CardGroup>

## Build with it

Drive a gateway from code, with no browser in the loop.

<CardGroup cols={2}>
  <Card title="Run a headless agent" icon="robot" href="/tutorials/headless-agent">
    Create a token-based host, generate an API access token, and call a tool over HTTP with a bearer token — fully attributed and logged.
  </Card>

  <Card title="Build a custom rule engine" icon="plug" href="/tutorials/custom-rule-engine">
    Write a webhook that redacts emails, register it, test it, attach it to a rule, and see its verdict in your logs.
  </Card>
</CardGroup>

## Further reading

<CardGroup cols={2}>
  <Card title="Your first governed tool call" icon="rocket" href="/tutorials/first-tool-call">
    The best place to start if you're new to MCP Manager.
  </Card>

  <Card title="Introduction" icon="house" href="/get-started/introduction">
    What MCP Manager is and the problem it solves.
  </Card>

  <Card title="MCP Gateways" icon="network-wired" href="/mcp-gateway-concepts/mcp-gateways">
    How a gateway aggregates servers, brokers identity, and applies rules.
  </Card>

  <Card title="Gateway Deployment Strategies" icon="sitemap" href="/deployment/gateway-deployment-strategies">
    Topologies for rolling gateways out across an organization.
  </Card>
</CardGroup>