# Connect

Connect the YGO Console MCP server to the assistant you already use. Each client below takes the same server URL and the same YGO sign-in; the only difference is where the setting lives.

Server URL: `https://mcp.ygo.ai/mcp`

## Before You Start

- A YGO Console account (the console login). Project, hotel and feedback access needs the Editor role or higher in your organization.
- Claude: custom connectors are available on every plan; a Free account can add one custom connector. On Team and Enterprise an Owner adds the connector once for the workspace, then each member clicks Connect.
- ChatGPT: custom MCP servers are available on the web in Business, Enterprise and Edu workspaces whose admin allows custom plugins. A personal Plus or Pro account cannot add one.
- Allow pop-ups for `claude.ai` and `chatgpt.com`. The sign-in opens in a pop-up window.
- The sign-in screen may ask whether to grant write access. The assistant needs it to send hotel feedback and to reply in your feedback threads. Declining it keeps the other tools working; see Hotel Feedback on the overview page.

---

## Claude

1. Open **Customize**, then **Connectors**, then **Add**, then **Add custom connector**.
2. Name: `YGO Console`. Remote MCP server URL: `https://mcp.ygo.ai/mcp`. Click **Continue**.
3. Claude detects the sign-in settings. Under **Authentication** choose **Sign in now**, leave **OAuth client** on its default and **Request headers** empty, then click **Add**.
4. Sign in with your YGO account and approve the access request.
5. In a new chat, ask: "List my YGO projects."

> **Info**
>
> **Team and Enterprise workspaces**
>
> An Owner adds the connector once under **Organization settings**, then **Connectors**. Members then find YGO Console under **Customize**, then **Connectors**, and click **Connect**.

---

## ChatGPT

1. Open **Plugins** (`chatgpt.com/plugins`), click **+**, then **Add custom MCP server**.
2. Name: `YGO Console`. Connection: public endpoint `https://mcp.ygo.ai/mcp`. Authentication: **OAuth**. Leave Client ID and Client secret empty.
3. Read the risk warning, tick **I understand and want to continue**, then **Create as a plugin**. ChatGPT shows this warning for every custom server; continue only for the URL above.
4. Sign in with your YGO account and approve the access request.
5. Install the plugin from your plugins view. Start a Work chat, type `@YGO Console` and ask: "List my YGO projects."

---

## Claude Code

```bash
claude mcp add --transport http ygo-console https://mcp.ygo.ai/mcp
```

Then run `/mcp`, choose `ygo-console`, then **Authenticate**, and sign in.

---

## Cursor

Open **Settings**, then **MCP**, then **Add new MCP server**, and paste:

```json
{
  "mcpServers": {
    "ygo-console": { "url": "https://mcp.ygo.ai/mcp" }
  }
}
```

Click the sign-in prompt that appears next to the server.

---

## VS Code

Add to `.vscode/mcp.json` in your workspace, or to your user-level `mcp.json` (Command Palette, **MCP: Open User Configuration**). The snippet does not belong in `settings.json`.

```json
{
  "servers": {
    "ygo-console": { "type": "http", "url": "https://mcp.ygo.ai/mcp" }
  }
}
```

Start the server from the MCP view and sign in when prompted.

---

## Troubleshooting

| What you see | What it means | What to do |
|--------------|---------------|------------|
| The sign-in screen says the account cannot be created (for example "Sign up is not allowed") | The account you used is not a YGO Console user | Sign in with the account you use for the console, or ask your organization admin to invite you |
| "This sign-in is not linked to a ygo account" | This sign-in does not match a YGO Console account | Sign in with the same account you use for the console. If it still fails, contact `integrations@ygo.ai` |
| Connector added but no tools appear | Sign-in did not complete | Open the connector and click Connect again, with pop-ups allowed |
| ChatGPT shows no "Add custom MCP server" | Your account is not in a Business, Enterprise or Edu workspace, or custom plugins are not allowed there | Ask your workspace admin, or connect through Claude |
| Claude Team: "Only owners can add connectors" | Workspace policy | Ask an Owner to add it once, then click Connect |

Need help? Reach our integration team at `integrations@ygo.ai`.
