Skip to main content
Claude (web and desktop) connects to xysq as a custom integration. OAuth handles authentication, so there’s no API key to copy. Takes about three minutes.
1

Open Claude's integration settings

In Claude.ai (web) or the Claude desktop app:
  1. Click your profile picture (top right).
  2. Open Settings.
  3. Go to Integrations in the sidebar.
  4. Click Add custom integration.
2

Paste the server URL

In the Add custom integration dialog, paste this into the MCP server URL field:
If Claude asks for OAuth client credentials, copy them from the in-app guide (open Connect → Claude in app.xysq.ai; the client ID and secret are shown there).Click Add (or Save) to finish registering the integration.
3

Approve the OAuth flow

When you connect, Claude opens a browser tab to xysq’s OAuth approval page.
  1. Sign in to xysq if prompted.
  2. Review the access Claude is requesting.
  3. Click Approve.
The tab closes automatically and Claude shows xysq as connected.
If the popup gets blocked, allow popups for claude.ai and try the Connect button again. Use Disconnect → Connect to retry if the OAuth token ever expires.
4

Verify the connection

Start a new conversation and ask:
Claude triggers its first tool call, and the in-app guide marks the connection verified.
If Claude doesn’t use the tool automatically, be explicit: “Use the xysq tools to pull my context.”