# Connect your AI agent to Saymock

> How to connect Claude, Claude Code, ChatGPT, Cursor, VS Code, Gemini CLI, Codex or any MCP client to Saymock so it can design screens on your boards. This page: https://saymock.com/ai-agents.md

Saymock is a collaborative design board built for AI agents. Screens are plain HTML + Tailwind CSS on a multiplayer board; the agent creates and edits them through Saymock's MCP server while the team watches, comments and edits alongside. Saymock never calls an AI model itself: the user brings their own agent.

This page is written for you, the agent. The user pasted a prompt asking you to read it, pick the best way to connect yourself to Saymock, and set it up with them. Follow it, do what you can do yourself, and tell the user exactly what is left for them (usually: one sign-in in the browser).

- MCP endpoint (Streamable HTTP): `https://app.saymock.com/mcp` (if the user's prompt gives another MCP URL, use that one instead everywhere on this page)
- Authentication: OAuth. The client adds the URL, Saymock opens in the browser, the user signs in (or creates an account) and approves. No API key to create, copy or store.
- One connection covers the user's whole account: every workspace they belong to, with their permissions there.
- About Saymock, the tools and the benchmark: https://saymock.com/llms.txt
- The same setup written for people, to send the user to: https://saymock.com/en/agents/ (in French: https://saymock.com/agents/)
- What to do once connected, with example prompts: https://saymock.com/en/use-cases/ (in French: https://saymock.com/cas-usage/)

## Which setup should you recommend?

Find out which app you are running in, then:

- **Claude Code** (terminal): install the Saymock plugin. It adds the MCP server and Saymock's skills and prompts in one step.
- **Claude Code in VS Code** (the extension): add the MCP server through the extension's `/mcp` dialog.
- **Claude** (claude.ai, desktop app), **ChatGPT**, **Le Chat** and other chat apps: add the MCP URL as a custom connector. You cannot do it for the user: tell them where to click.
- **Cursor**, **VS Code (Copilot)**: a one-click install link, or one configuration entry.
- **Gemini CLI**, **Codex CLI**: one command.
- Any other MCP client: add the URL as a remote (Streamable HTTP) server with OAuth. Only for a client without OAuth, or a script, use a personal access token (below).

If you can run shell commands, run the command yourself, then tell the user what to approve in the browser. Do not ask the user to run something you can run.

## Claude Code

Recommended (production server only, `https://app.saymock.com/mcp`): the plugin.

```sh
claude plugin marketplace add saymock/claude-plugin && claude plugin install saymock@saymock
```

Any other MCP URL, or if the user prefers the server alone:

```sh
claude mcp add --scope user --transport http saymock https://app.saymock.com/mcp
```

Then the user runs `/mcp`, chooses `saymock` and Authenticate: Saymock opens in the browser, they approve. The tools load in a new session (or after a restart): say so.

## Claude Code in VS Code

The extension alone does not put `claude` on the PATH. In the Claude Code panel, the user types `/mcp` and adds a server: HTTP, named `saymock`, scope user, URL `https://app.saymock.com/mcp`. Then, in `/mcp`, they choose `saymock` and Authenticate. It needs Claude Code 2.1.261 or later.

## Claude (claude.ai and the desktop app)

```text
Settings → Connectors → Add custom connector. Name: saymock. URL: https://app.saymock.com/mcp
```

Then Connect next to saymock: Saymock opens to sign in, the user approves. In a Team or Enterprise organization, an owner may have to add the connector first. The connector is then available in every conversation, and in Claude Code too, signed in with the same claude.ai account.

## ChatGPT

```text
ChatGPT on the web: Plugins → + → Add custom MCP server. Name: saymock. Server URL: https://app.saymock.com/mcp. Authentication: OAuth. Then Create as a plugin.
```

ChatGPT opens Saymock to sign in; then the user installs the plugin and calls it with @ in a chat. Their plan and workspace settings decide whether custom MCP servers are allowed.

## Le Chat (Mistral)

```text
Connectors → + Add Connector → Custom MCP Connector tab. Name: saymock. Server URL: https://app.saymock.com/mcp. Then Connect.
```

Le Chat detects OAuth and opens Saymock to sign in. Only an administrator can add a connector (the account owner on Free, Pro and Student plans).

## Cursor

One-click install, from Saymock (Settings → Connect your agent → Cursor), or this entry in `~/.cursor/mcp.json`:

```json
{ "mcpServers": { "saymock": { "url": "https://app.saymock.com/mcp" } } }
```

Cursor opens Saymock in the browser to sign in.

## VS Code (GitHub Copilot)

```sh
code --add-mcp '{"name":"saymock","type":"http","url":"https://app.saymock.com/mcp"}'
```

Or the one-click "Add to VS Code" link in Saymock (Settings → Connect your agent). VS Code opens Saymock in the browser to sign in.

## Gemini CLI

```sh
gemini mcp add --scope user --transport http saymock https://app.saymock.com/mcp
```

Gemini CLI opens the browser to sign in on first use (`/mcp auth saymock` signs in again).

## Codex CLI

```sh
codex mcp add saymock --url https://app.saymock.com/mcp
```

Codex detects OAuth and starts the sign-in (`codex mcp login saymock` otherwise).

## Other MCP clients

```json
{ "mcpServers": { "saymock": { "type": "http", "url": "https://app.saymock.com/mcp" } } }
```

A client without OAuth, or a script, sends a personal access token instead: the user creates one in Saymock (Settings → Connect your agent), and the client sends it as an `Authorization: Bearer smk_…` header. A token is a password: never write it in a file that is committed.

## Check that it works

Once the tools are loaded, call `whoami`: it names the account and its workspaces. Then suggest a first request, for example:

```text
Use Saymock to design a sign-in screen for a coffee shop app.
```

In Saymock, Settings → Connect your agent shows the connection turn green as soon as the agent reaches the server.

## Common questions

### Does the user need an account?

Yes, the sign-in creates one if needed (free). To try the editor first without an account: https://app.saymock.com/try

### Does it cost anything?

Saymock bills human editors, never agents nor their tokens. Free for small teams (2 editors per workspace, agents unlimited); details at https://saymock.com/en/pricing/

### What can the agent do once connected?

Create files and screens (HTML + Tailwind), edit elements by id, check its work (`get_screenshot`, `check_layout`, `compare_to_reference`), upload images and icons, propose alternatives on a screen, and handle the team's comments as tasks (the `session` prompt, `/saymock:session` in Claude Code).

### The sign-in does not open, or the tools do not show up

Restart the client or start a new conversation: most clients load MCP tools at start. Check the URL is exactly `https://app.saymock.com/mcp`. In Claude Code, `/mcp` shows the server's state and signs in again.
