# Connect an AI app

> Add YoPrint to Claude, ChatGPT, Cursor or another AI app, sign in, and choose what it may do.

Web page: https://developer.yoprint.com/ai-apps/

An AI app such as Claude, ChatGPT or Cursor can work in your YoPrint team for you. You ask in plain words. The app looks things up, or makes the change you asked for, as you and within your role. It sees and changes only what you can see and change in the web app.

You never copy an API key into the app. You sign in to YoPrint once and approve the app. YoPrint then gives the app its own sign-in, which the app keeps fresh by itself.

**Diagram:** Connecting takes a few minutes, once per app.

1. **Add the address**: In your AI app, add `https://mcp.yoprint.com/mcp`
2. **Sign in**: The app opens YoPrint's sign-in in your browser
3. **Approve**: Pick the team, then Read and change data or Read only
4. **Ask**: "List my five newest orders."

## Before you start

- Your team's plan includes API access (Pro or higher), and the team has an active subscription or trial.
- Profile shows an **AI apps** card. Every team whose plan includes API access has it.
- Your team's AI access is **Read and change** or **Read only**. A team that has never changed it allows **Read and change**. See [Your team's AI access](https://developer.yoprint.com/ai-apps/team-ai-access.md).
- Your AI app can add a remote MCP server. MCP is the standard way AI apps connect to other software. Some apps need a paid plan, or an admin's permission, for this.
- You can sign in to YoPrint in a browser on the same computer.

## The address

Every AI app uses the same address:

```text
https://mcp.yoprint.com/mcp
```

Use it exactly as shown, with `https://` at the start and `/mcp` at the end. You can also copy it in YoPrint: open **Profile**, find the **AI apps** card, and copy **Address to add to your AI app**.

## Add YoPrint to your app

Each app's menus change from time to time. If a name below doesn't match what you see, look for the app's way to add a custom connector or a remote MCP server, and give it the address above.

**Claude**

Claude on the web or in the desktop app.

1. In Claude's settings, add a custom connector.
2. Paste `https://mcp.yoprint.com/mcp` as its address. If Claude offers a client ID and secret, leave them empty: YoPrint registers Claude by itself.
3. Connect it. Claude opens YoPrint's sign-in in your browser.
4. Sign in and [approve the connection](#sign-in-and-approve).
5. In a chat, check that YoPrint is turned on among Claude's tools.

On a Claude Team or Enterprise plan, an owner may need to add the connector for the organization first. Each person then connects it and signs in to YoPrint as themselves.

**Claude Code**

1. Add the server from a terminal:

   ```bash
   claude mcp add --transport http yoprint https://mcp.yoprint.com/mcp
   ```

2. Start Claude Code and type `/mcp`.

3. Choose `yoprint` and sign in. Your browser opens YoPrint's sign-in.

4. Sign in and [approve the connection](#sign-in-and-approve).

**ChatGPT**

ChatGPT on the web. ChatGPT uses a connector that can make changes, such as YoPrint's, only in its developer mode. That mode is on some ChatGPT plans only, and in a business workspace an admin may need to allow it.

1. In ChatGPT's settings, turn on developer mode.
2. Add a custom connector (ChatGPT may call it an app). Paste `https://mcp.yoprint.com/mcp` as its address, and choose OAuth for sign-in.
3. Create it. ChatGPT opens YoPrint's sign-in.
4. Sign in and [approve the connection](#sign-in-and-approve).
5. In a chat, turn YoPrint on among ChatGPT's tools.

**Cursor**

1. Add YoPrint to Cursor's MCP settings file: `~/.cursor/mcp.json` for every project, or `.cursor/mcp.json` inside one project. You can also open the file from Cursor's settings.

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

   If the file already lists servers, add only the `"yoprint"` entry inside `mcpServers`.

2. Save the file. In Cursor's MCP settings, sign in to YoPrint when it asks.

3. Sign in and [approve the connection](#sign-in-and-approve).

**VS Code and others**

**VS Code**, with GitHub Copilot chat:

1. Add the server from a terminal:

   ```bash
   code --add-mcp '{"name":"yoprint","type":"http","url":"https://mcp.yoprint.com/mcp"}'
   ```

2. Start the `yoprint` server in VS Code. It asks you to sign in.

3. Sign in and [approve the connection](#sign-in-and-approve).

**Any other app**: add a remote MCP server that uses HTTP (some apps call it Streamable HTTP), with the address above. The app finds YoPrint's sign-in by itself. If it asks for a client ID or secret, leave them empty.

Many apps also ask you before YoPrint changes anything for them. Allow it only for changes you asked for.

## Sign in and approve

1. Your app opens YoPrint in your browser. If you aren't signed in to YoPrint there, sign in first.
2. YoPrint asks **Connect _app name_ to YoPrint?** and shows:
   - **App**: the name the app gave itself, the web address YoPrint sends you back to, and a tag, **Verified** or **Not verified by YoPrint**.
   - **Signed-in account**: your email.
   - **Team**: the team the app will work in. If more than one of your teams can connect, pick one from the list. A connection works on one team only. A team that allows AI apps to read only is marked "(reading only)".
   - For an app YoPrint hasn't verified, a warning: **Check this app before you connect**. See [below](#what-not-verified-by-yoprint-means).
3. Under **Access**, choose:
   - **Read and change data**: the app can look things up and make changes, as you. It is selected at first.
   - **Read only**: the app can only look things up. Choose this if you only want answers.
4. Select **Connect**. YoPrint sends you back to your app. **Cancel** stops here, and nothing is connected.

Finish within 10 minutes, in the browser your app opened. After that, start again from the app.

You only see **Read only** when none of your teams allows changes, or when the app asked only to read.

### What "Not verified by YoPrint" means

The name on this page is whatever the app calls itself. Anyone can make an app and call it "Claude". **Not verified by YoPrint** means YoPrint hasn't confirmed who made this one. You can see it for well-known apps too.

Before you select **Connect**:

- Make sure you started this connection yourself, from your app, a moment ago.
- Check the web address after the app's name. For an app in your browser, it should belong to the company behind it: claude.ai or claude.com for Claude, chatgpt.com for ChatGPT. An app on your own computer, such as Claude Code, Cursor or VS Code, shows your computer's own address or the app's name.
- If anything looks wrong, select **Cancel**.

## Check that it worked

Back in your app, ask:

```text
List my five newest orders.
```

It should answer with orders from the team you picked. If it asks you to sign in again, or says it can't reach YoPrint, see [Troubleshooting](https://developer.yoprint.com/ai-apps/troubleshooting.md).

> **Caution:** What you ask about, and the data the app reads, go through your AI app and its provider. Text from your customers inside YoPrint can try to steer the app. Read [Safety](https://developer.yoprint.com/ai-apps/safety.md) before you allow changes.

## What the team owner controls

The team owner, and members whose role has **Manage Settings**, choose what AI apps may do on the team: **Read and change**, **Read only** or **Off**. That setting is the most any connection can do. See [Your team's AI access](https://developer.yoprint.com/ai-apps/team-ai-access.md).

The first time anyone on a team connects an AI app, YoPrint emails the team owner.

## See and end connections

In YoPrint, open **Profile**, then the **AI apps** card. **Your connected apps on this team** lists the apps you connected here. Each row shows what the app can do now, whether YoPrint has verified it, when you connected it, and when it was last active. Apps you connected on another team show when you switch to that team.

To end one, select **Disconnect** next to it, then confirm. The app loses access to YoPrint at once. Your data and the changes it made stay. To use the app again, connect it again from the app.

Removing YoPrint inside your AI app doesn't tell YoPrint. Select **Disconnect** in Profile as well.

## Next

- [What AI apps can and can't do](https://developer.yoprint.com/ai-apps/capabilities.md): the tasks you can ask for, area by area.
- [Your team's AI access](https://developer.yoprint.com/ai-apps/team-ai-access.md): the team setting, and what happens when roles change or people leave.
- [How it works](https://developer.yoprint.com/ai-apps/how-it-works.md): things to ask, limits, and the details for developers.
- [Safety](https://developer.yoprint.com/ai-apps/safety.md): customer text, money, messages, and how to cut access fast.
- [Troubleshooting](https://developer.yoprint.com/ai-apps/troubleshooting.md): every message you might see, and what to do.
- [Questions](https://developer.yoprint.com/ai-apps/faq.md): plans, your data, and which apps work.