---
title: "Connecting MCP clients | Mesher docs: MCP connectors for AI agents"
url: https://mesher.sh/docs/mcp-clients
description: "Connect Claude Code, VS Code, Cursor or any MCP client to Mesher by its URL alone: the client signs in with OAuth, and you pick the profile it may use."
---

# 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

```sh
$ 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

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

### Cursor and other `mcpServers` clients

```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](https://mesher.sh/docs/mcp-clients.md) · [Full reference on GitHub](https://github.com/agentrq/mesher/blob/main/README.md)
