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
- The client calls
/mcpand gets a401that points to the server's OAuth metadata. - It registers itself and opens a consent page in your browser.
- 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.
- The app now sees only that profile's connectors, signed in as that profile.
Add the server to your client
Claude Code
$ claude mcp add --transport http mesher https://mcp.example.com/mcpThen run /mcp in Claude Code and choose mesher to sign in.
VS Code
{
"servers": {
"mesher": { "type": "http", "url": "https://mcp.example.com/mcp" }
}
}Cursor and other mcpServers clients
{
"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:
mcpfor/mcp, andapito 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
--domainare allowed, and--allow-originadds 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