Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xysq.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 Credentials

  1. After logging in, click the Connect Agent button.
Connect Agent Button
  1. Select the Claude tab.
  2. Copy all three credentials shown:
    • MCP Server URL: https://api.xysq.ai/mcp
    • OAuth Client ID
    • OAuth Client Secret
Claude Tab with MCP Credentials

​
Step 2 - Add the Connector in Claude Desktop

  1. Open Claude Desktop (or go to claude.ai).
  2. Go to Settings → Connectors.
  3. Click Custom Connect.
  4. Fill in the fields:
    • Name - any name you like (e.g. xysq)
    • URL - paste your full MCP Server URL: https://api.xysq.ai/mcp
    • OAuth Client ID - paste the Client ID you copied
    • OAuth Client Secret - paste the Client Secret you copied
  5. Under permissions, set Configure: Allow All.
  6. Save the connector.
Claude Desktop Custom Connector Setup with OAuth fields

​
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

​
Pinning Claude to a team vault

The connector above gives Claude access to your personal vault. To dedicate a connector to a single team vault — for example, an “Acme Engineering” connector that can only touch that team’s memories — change the URL when adding the custom connector: 
https://api.xysq.ai/mcp/team/YOUR_TEAM_ID
Find the team UUID in Team Settings at app.xysq.ai, or ask Claude List my xysq teams. from a personal connection. On a team-pinned connection:
  • Every memory action routes to that team’s vault — no need to mention the team in your prompts.
  • Personal-vault writes and reads are blocked; nothing said in this Claude conversation can leak into your personal memories.
  • Personal tools like memory_tags, skill_sync, and list_teams are disabled.
  • Your role on the team determines what the agent can do (ro reads, rw writes, admin deletes).
You can add multiple connectors with different names (e.g. xysq-personal, xysq-acme, xysq-platform) to switch context cleanly between conversations.

​
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

​
Troubleshooting

ProblemFix
MCP does not appear in ClaudeConfirm your full MCP Server URL, OAuth Client ID, and OAuth Client Secret are 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.
”Connection refused” or network errorCheck that your MCP URL https://api.xysq.ai/mcp is correct and 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 and that your API key is correctly appended to the MCP Server URL.
Claude says “authentication required” when asked to connect to xysqGo to Settings → Custom Connectors, find the xysq connector and click Disconnect, then click Connect — this will launch the OAuth flow. Accept the permissions and complete the flow. Once done, return to chat and ask Claude to connect to xysq again.