Skip to main content
ish runs as a hosted MCP server at https://mcp.ishlabs.io/mcp. Any client that speaks MCP over streamable HTTP can call ish tools (study_run, ask_run, person_generate, and the rest) once it points at that URL and signs in. Pick your client below for the exact steps.

Claude Code

Wire it with one command.
https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/cursor.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=dc25e6628e5939c4f56c8a117dfffba4

Cursor

Wire from the CLI or settings.
https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/claude.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=8e6b48dea9630a77a53062ecaf9eb3cc

Claude Desktop

Connect over OAuth.
https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/openai.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=75d0c402100c285b29b4a20bdcb99d18

ChatGPT

Add as a connector.
https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/vscode.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=cd0803d83dac3f2702b3d8dfe26f6fbb

VS Code

Add to your user MCP config.
https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/lovable.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=2a718949c3f7a8fbc392ea87da8e54dd

Lovable

Connect inside the builder.
https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/replit.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=3855d33ff6c65a14ff9eeaf67da8ea06

Replit

Connect inside the workspace.
https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/bolt.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=beb61cdb8cbfad7f660b132dbe696539

Bolt

Connect the embedded agent.
https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/v0.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=2932a00012d904871035d045ec63fb69

v0

Connect in the editor.

Windsurf

Add to your MCP config.
Every client uses the same endpoint and the same sign-in. The connecting guide owns the add mechanism and the OAuth handshake; the per-client pages above are the short, client-specific version.

​
How clients group

All clients reach the same server the same way. They differ in how much ish can do for them when you set up or run a study. There are three groups.
The ish CLI writes the MCP config block for Cursor, VS Code, Claude Code, Claude Desktop, and Windsurf. Run ish mcp add to plan and apply the change, ish mcp list to see what is wired, and ish mcp remove to unwire it. The CLI edits local JSON config files only; it never embeds a token, since the server handles OAuth on first connect. See the ish mcp reference.
Lovable, Replit, Bolt, and v0 build apps whose preview URLs are gated to your editor session. ish runs simulated people from the cloud, so a preview URL that loads in your tab fails silently for them. When ish detects one of these clients (or a study URL on a known builder host), it returns a hint that names the share or deploy path for that builder. The per-client pages above carry the exact steps.
Any other MCP client connects to https://mcp.ishlabs.io/mcp and runs every tool. ish recognizes the client from its handshake to tailor guidance, but the CLI does not write its config and there is no builder hint. ChatGPT is in this group and has its own page because it reads ish tools but not ish resources.

​
Other MCP clients

No page for your client? It still works. Point any MCP client that speaks streamable HTTP at https://mcp.ishlabs.io/mcp and sign in on first connect. This covers clients like Cline and Roo Code: add the server with their own MCP settings, using the URL above.
Use https://mcp.ishlabs.io/mcp with no trailing slash. A trailing slash redirects (HTTP 307) and breaks some clients, ChatGPT among them.
For the generic steps that work in any client, see Connecting.

​
Next steps

Connecting

The add mechanism and OAuth, in full.

Tool index

Every ish MCP tool, grouped by domain.