Install the xysq plugin to give Claude Code persistent memory across every session. The plugin configures the MCP connection and teaches Claude how to use xysq tools automatically.
Before You Start
Sign in to your xysq account at app.xysq.ai.
Step 1 - Get Your API Key
- After logging in, click the Connect Agent button.
- Select the Claude Code tab.
- Click Generate API Key — your key will be created automatically.
Save your API key now — it won’t be shown again. If you lose it, you can regenerate from the same page.
Step 2 - Add the xysq Marketplace
In any Claude Code session, run:
/plugin marketplace add xysq-ai/xysq-claude-plugin
Step 3 - Install the Plugin
Claude Code will prompt for your API key. Paste the xysq_... key you generated. It’s stored securely in your system keychain — not in any config file.
Step 4 - Verify
Start a new Claude Code session and try:
Remember that I prefer dark mode in all my tools.
memory_retain and confirm the memory was stored.
What Gets Installed
| Component | Purpose |
|---|
| MCP connection | Auto-connects to api.xysq.ai/mcp with your API key |
| Memory skill | Teaches Claude the session protocol, tool usage, consent rules |
Manual Setup (Alternative)
If you prefer not to use the plugin:
claude mcp add xysq https://api.xysq.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"
Troubleshooting
| Problem | Fix |
|---|
| Plugin install fails | Check your internet connection. Try /plugin install xysq-ai/xysq-claude-plugin again. If it persists, use the manual setup above. |
| MCP not connecting after install | Run /reload-plugins or start a new session. Check /plugin list to verify xysq is listed. |
| ”Authentication required” error | Your API key may be invalid. Regenerate at app.xysq.ai/connect and reinstall the plugin. |
| Skills not loading | Verify with /plugin list that xysq shows as installed and enabled. Try /plugin disable xysq then /plugin enable xysq. |
| Want to update the plugin | Run /plugin update xysq to pull the latest version. |
