Skip to main content
Use the xysq MCP server with Claude Desktop so Claude can call xysq tools for memory and identity-aware context.

​
Before You Connect

Sign in to your xysq account at app.xysq.ai.
xysq Login Screen

​
Step 1 - Get Your MCP URL

  1. After logging in, click the Connect Agent button.
Connect Agent Button
  1. Scroll down and select Claude Code.
  2. Copy the MCP server URL:
https://api.xysq.ai/mcp
Copy MCP URL

​
Step 2 - Add the Connector in Claude Desktop

  1. Open Claude Desktop.
  2. Go to Settings -> Connectors.
  3. Click Custom Connect.
  4. Fill in the fields:
    • Name - any name you like (e.g. xysq)
    • URL - paste the URL you copied: https://api.xysq.ai/mcp
  5. Under permissions, set Configure: Allow All.
  6. Save the connector.
Claude Desktop Custom Connector Setup

​
Step 3 - Connect from Claude

In any Claude conversation, type: 
Connect to xysq MCP
Claude will initiate the connection automatically.
Claude connecting to xysq MCP

​
First-Time Authentication

The first time you connect, xysq needs to verify your identity:
  1. Claude will receive an auth_url - a browser link will open automatically (or you can open it manually).
  2. Complete sign-in or approval in the xysq app.
  3. Once approved, return to Claude - the session will show as authenticated.
  4. The server may return a device_code. Use this on future authenticate calls so you are not asked to re-approve every session. Claude Desktop normally persists this automatically.

​
Adding Memories

Once connected, you can ask Claude to remember anything for future sessions: 
Remember that I prefer dark mode in all my tools.

Retain: My project deadline is June 15.
Claude will store this in your xysq memory and retrieve it in future conversations automatically.

​
Video Walkthrough

Video Thumbnail
(Full walkthrough video - link or embed coming soon)

​
Troubleshooting

ProblemFix
MCP does not appear in ClaudeConfirm your connector URL is correct and that you clicked Save. Fully quit and reopen Claude Desktop - MCP changes require a full restart.
Still old behavior after editingQuit Claude completely (including from the menu bar / system tray), then reopen. A window close is not enough.
Authentication loop / keeps asking to sign inMake sure you’re using the device_code returned after first auth. If lost, remove the connector and re-add it to restart the flow.
”Connection refused” or network errorCheck that https://api.xysq.ai/mcp is accessible from your network. If you are on a VPN or corporate network, it may be blocked.
Enterprise or managed installsYour IT team may restrict MCP or redirect config paths. Contact your administrator for the correct setup path.
Connector saves but Claude can’t reach xysqDouble-check that Configure: Allow All was selected when setting up the connector.