API docs
Book a demo

MCP

Connect

Page

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."

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

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:

{
  "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.

{
  "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.