# HeyMCP

> Your MCP server, where agents can reach it — and a timeline of everything they do to it.

- [HeyMCP](https://docs.heymcp.dev/index.md): Your MCP server, where agents can reach it — and a timeline of everything they do to it.
- [Quickstart](https://docs.heymcp.dev/quickstart.md): From nothing to an agent calling your local MCP server, in about two minutes.
- [Installation](https://docs.heymcp.dev/installation.md): Install the heymcp CLI, and control where it goes.
- [How it works](https://docs.heymcp.dev/concepts/how-it-works.md): What connects to what, and why nothing is ever buffered.
- [URLs and paths](https://docs.heymcp.dev/concepts/urls-and-paths.md): What your public URL looks like, and which paths travel through the tunnel.
- [Sessions and history](https://docs.heymcp.dev/concepts/sessions.md): What a session is, when it ends, and how long its history lives.
- [The inspector](https://docs.heymcp.dev/concepts/the-inspector.md): Reading the timeline: attempts, not frames.
- [The handshake probe](https://docs.heymcp.dev/concepts/the-probe.md): HeyMCP connects to your server as an MCP client before any real agent does.
- [Which client, and what to expect](https://docs.heymcp.dev/clients/overview.md): A compatibility matrix, and the one thing that will waste your afternoon if you don't know it.
- [Claude Code](https://docs.heymcp.dev/clients/claude-code.md): One command, and the best error messages of any client.
- [Claude.ai](https://docs.heymcp.dev/clients/claude-ai.md): Custom connectors in the Claude web and desktop app.
- [ChatGPT](https://docs.heymcp.dev/clients/chatgpt.md): Custom MCP connectors via Developer mode.
- [Grok](https://docs.heymcp.dev/clients/grok.md): Custom MCP connectors at grok.com/connectors.
- [Cursor](https://docs.heymcp.dev/clients/cursor.md): Adding a HeyMCP tunnel to Cursor's mcp.json.
- [VS Code](https://docs.heymcp.dev/clients/vscode.md): Adding a HeyMCP tunnel to GitHub Copilot's MCP configuration.
- [Gemini](https://docs.heymcp.dev/clients/gemini.md): Adding a HeyMCP tunnel to the Gemini CLI.
- [Authentication](https://docs.heymcp.dev/security/authentication.md): What protects your tunnel today, and what doesn't exist yet.
- [What is exposed](https://docs.heymcp.dev/security/what-is-exposed.md): Exactly what a HeyMCP tunnel makes reachable, and what it doesn't.
- [CLI reference](https://docs.heymcp.dev/cli/overview.md): Global flags, exit codes, configuration and environment.
- [heymcp login](https://docs.heymcp.dev/cli/login.md): Sign in with GitHub. Opens your browser once.
- [heymcp share](https://docs.heymcp.dev/cli/share.md): Open a tunnel to a local MCP server and stay attached.
- [heymcp probe](https://docs.heymcp.dev/cli/probe.md): Run the handshake and checks against a local server. No public URL.
- [heymcp sessions](https://docs.heymcp.dev/cli/sessions.md): List your recent sessions.
- [heymcp export](https://docs.heymcp.dev/cli/export.md): Export a session's tool calls.
- [heymcp whoami](https://docs.heymcp.dev/cli/whoami.md): Show who this CLI is signed in as.
- [Checks reference](https://docs.heymcp.dev/lint.md): Every rule the handshake probe runs, what it means, and how to fix it.
- [Plans and limits](https://docs.heymcp.dev/account/plans-and-limits.md): What each plan allows.
- [Custom domains](https://docs.heymcp.dev/account/custom-domains.md): Serve your MCP tunnel on a hostname you own.
- [Billing](https://docs.heymcp.dev/account/billing.md): Upgrading, managing your subscription, and cancelling.
- [Signing in](https://docs.heymcp.dev/account/signing-in.md): GitHub OAuth, the CLI device flow, and your token.
- [Troubleshooting](https://docs.heymcp.dev/troubleshooting.md): What to check, in the order that resolves things fastest.