Connect an AI Assistant

Who this is for

Admins who are setting up ChatGPT, Cursor, Claude, or another MCP-capable AI client to work with X1 HQ.

Before you start

Use an AI client that supports remote MCP servers over HTTPS.
Have an X1 account with the correct brand and shop permissions.
Use the MCP server URL https://mcp.posx1.ai/mcp.
Do not use https://mcp.posx1.ai/mcp/openapi.json. X1 MCP is a remote MCP server, not a Custom GPT Actions OpenAPI endpoint.

ChatGPT labels may vary by workspace. Some workspaces show Apps & Connectors; others show Connectors.

Open ChatGPT.
Open Settings.
Open Apps & Connectors.
If needed, open Advanced settings and turn on developer mode for your workspace.
Select Create.
Enter a clear name such as X1 HQ Agent.
Enter a description that explains the app can help inspect and manage X1 HQ data.
Enter the MCP server URL: https://mcp.posx1.ai/mcp.
Select Create.
Complete the X1 sign-in or authorization screen.
Confirm ChatGPT shows the X1 tools after the connection succeeds.

Open a new chat.
Select the + button near the message box.
Select More.
Choose X1 HQ Agent or the X1 app/connector name shown in your workspace.
Ask a read-only question first, such as "List the brands and shops I can access."
Confirm the assistant returns only brands and shops you expect to see.

Use the client's remote MCP server setup screen. Enter this server URL when the client asks for an MCP endpoint:

https://mcp.posx1.ai/mcp

If your client asks for a JSON configuration, start with this shape and adjust it to the client's current MCP documentation:

{
  "mcpServers": {
    "x1-hq": {
      "url": "https://mcp.posx1.ai/mcp"
    }
  }
}

Some clients require a local bridge command instead of a direct remote URL. Use only an X1-approved bridge package or client configuration.

After connection, the assistant should be able to:

Confirm the URL is exactly https://mcp.posx1.ai/mcp.
Confirm your AI client supports remote MCP servers.
Sign out and sign in again if authorization fails.
Ask the assistant to list accessible brands and shops before attempting changes.
Contact X1 support if your account cannot see the expected brand or shop.