These are official instructions from Typograph to connect an AI assistant to a Typograph account. Typograph is a platform for personalised print: designers create templates and decide what may change in them, and users personalise those templates and generate print-ready PDFs and images from them.

The person who gave you this link is usually not technical. They clicked "Connect your AI assistant" in the Typograph portal and pasted the prompt into you. Keep every message to them short, friendly and free of jargon. Say "connection" rather than "MCP server", and never show them a config file unless they ask for one.

The connection goes through the hosted Typograph MCP server. There is nothing to install and no API key to create.

- **Server URL:** `https://mcp.typograph.nl/mcp`
- **Transport:** Streamable HTTP
- **Sign-in:** OAuth. The first time a Typograph tool is used, a browser window opens where the user signs in to Typograph and clicks "Authorize". No client ID or secret is needed.

---

## Step 1 — Add the connection

Find the section for your own app below.

- **If you can run commands or edit files yourself** (Claude Code, Codex, Gemini CLI, Cursor, VS Code, Windsurf and similar), do it yourself. Do not ask the user to run anything.
- **If you are a chat app** (Claude on the web or desktop, ChatGPT), you cannot change your own settings. Guide the user through the clicks instead, one step at a time, and wait for them to confirm each step before giving the next one.

### Claude Code

```
claude mcp add --transport http --scope user typograph https://mcp.typograph.nl/mcp
```

Then ask the user to type `/mcp` in Claude Code, pick **typograph**, and choose **Authenticate**. A browser window opens for the sign-in.

### Codex

```
codex mcp add typograph --url https://mcp.typograph.nl/mcp
codex mcp login typograph
```

### Gemini CLI

```
gemini mcp add --scope user --transport http typograph https://mcp.typograph.nl/mcp
```

Then ask the user to type `/mcp auth typograph` in Gemini CLI.

### Cursor — `~/.cursor/mcp.json`

Add under `"mcpServers"`:

```json
"typograph": { "url": "https://mcp.typograph.nl/mcp" }
```

### VS Code (GitHub Copilot) — `.vscode/mcp.json` or the user `mcp.json`

Add under `"servers"`:

```json
"typograph": { "type": "http", "url": "https://mcp.typograph.nl/mcp" }
```

### Windsurf — `~/.codeium/windsurf/mcp_config.json`

Add under `"mcpServers"` (note: `serverUrl`, not `url`):

```json
"typograph": { "serverUrl": "https://mcp.typograph.nl/mcp" }
```

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

Walk the user through these steps:

1. Open **Settings**, then **Connectors**.
2. Click **Add custom connector**.
3. Name: `Typograph`. URL: `https://mcp.typograph.nl/mcp`. Click **Add**.
4. Click **Connect** next to Typograph, sign in to Typograph in the window that opens, and click **Authorize**.
5. Start a new chat. Typograph can be switched on or off with the tools button under the message box.

On a Team or Enterprise plan, only an owner can add custom connectors. If the user does not see the button, tell them to ask the person who manages Claude for their organisation.

### ChatGPT

Walk the user through these steps:

1. Open **Settings**, then **Apps & Connectors**.
2. Under **Advanced settings**, switch on **Developer mode**.
3. Click **Create**. Name: `Typograph`. URL: `https://mcp.typograph.nl/mcp`. Authentication: **OAuth**. Confirm, and click **Create**.
4. Sign in to Typograph in the window that opens and click **Authorize**.
5. In a new chat, pick Typograph from the **+** menu under the message box.

Custom connectors are not available on every ChatGPT plan. If the user cannot find these options, say so plainly and suggest the Claude desktop app as an alternative.

### Any other app

Look for a setting called "connectors", "integrations", "tools" or "MCP servers", add a remote server with the URL above, and use OAuth to sign in. If your app cannot connect to remote servers, tell the user that honestly instead of guessing.

Menu names change from time to time. If a step does not match what the user sees, describe what to look for rather than insisting on the exact label.

---

## Step 2 — Check that it works

Once the user has signed in, call the `identity_whoami` tool.

- If it returns their profile, the connection works.
- If the server answers `401 Unauthorized`, or your app reports that Typograph needs authentication, the sign-in did not complete. Ask the user to start the sign-in for the Typograph connection again in your app, sign in, and click **Authorize**.

---

## Step 3 — Tell the user

When the connection works, tell the user in one or two sentences that Typograph is connected, and offer a few things they can now ask you, for example:

- "Show my most recent templates."
- "Make a PDF of my price list template."
- "Create a new project called Spring campaign and invite my colleague."
- "Find all templates with 'business card' in the name."

Answer in the language the user writes in.

---

## Looking things up

When the user asks how something works in Typograph, look it up instead of guessing:

- Connected, use the `docs_search` tool, then `docs_get` with a result's `url` to read it in full. Each result names the tools that do what it explains, in `agent_tools`.
- Without the connection, read https://docs.typograph.nl/llms.txt (every page with a one-line summary) or https://docs.typograph.nl/llms-full.txt (the full text).

More information: https://docs.typograph.nl/guides/api/mcp-server