Docs

Connecting MCP clients

Point Claude Code, VS Code, Cursor or any MCP client at your server.

The endpoint is POST /mcp (Streamable HTTP, no sessions). One endpoint serves both current MCP revisions, 2026-07-28 and 2025-11-25. Give a client the URL and nothing else: it signs in the way MCP intends, with OAuth, and no token is pasted into a config file.

How a client signs in

  1. The client calls /mcp and gets a 401 that points to the server's OAuth metadata.
  2. It registers itself and opens a consent page in your browser.
  3. You sign in, pick the profile it may use and allow it. On a loopback server started without a token there is nothing to sign in to.
  4. The app now sees only that profile's connectors, signed in as that profile.

Add the server to your client

Claude Code

shell
$ claude mcp add --transport http mesher https://mcp.example.com/mcp

Then run /mcp in Claude Code and choose mesher to sign in.

VS Code

.vscode/mcp.json
{
  "servers": {
    "mesher": { "type": "http", "url": "https://mcp.example.com/mcp" }
  }
}

Cursor and other mcpServers clients

mcp.json
{
  "mcpServers": {
    "mesher": { "type": "http", "url": "https://mcp.example.com/mcp" }
  }
}

What the app gets

  • One profile. A command that names another profile (gmail@home) is refused, and a connector named without one means the app's profile.
  • Access tokens last 15 minutes and are renewed with a refresh token that lasts 30 days and is replaced on every use.
  • Scopes: mcp for /mcp, and api to manage that profile through /api/v1. The consent page says which the app asks for.
  • Revoke an app under Profiles in the web UI, and it is cut off at once.
  • A browser-based client must be allowed by Origin: loopback and --domain are allowed, and --allow-origin adds more.

Resources, prompts and skills

Tools stay one callTool, but resources and prompts are also served as MCP's own, so clients can show them in pickers and slash menus. A resource's URI is connectors://<c>/<rest> and a prompt's name is <c>.<name>. Connectors can also ship Agent Skills, offered to 2026-07-28 clients through the skills extension.

Last updated November 21, 2026 · This page as Markdown · Full reference on GitHub