← Spaces

MCP Integration

Connect your AI tools to Spaces in one command. Works with Claude, Cursor, Windsurf, and more.

Quick Setup

Choose your AI tool below and run the command. That's it!

Add Spaces to Claude Desktop with one command:

bash
claude mcp add --transport http spaces https://mcp.neuros.run/mcp

First time?

Make sure you have Claude Desktop installed. Get it from claude.ai/download

How to Use Spaces Effectively

When to Save Snapshots

Save snapshots at key moments to build a valuable knowledge base:

  • After solving a problem - Capture the solution for future reference
  • When making decisions - Document why you chose approach A over B
  • Every 10-15 messages - Keep context even if the conversation continues
  • Before switching tasks - Close the loop on what you just worked on
  • When you learn something new - Build your personal knowledge base

Pro Tip

The more snapshots you save, the better Spaces becomes at finding relevant context. Don't worry about saving too much - the AI will help you find what matters.

Common Workflows

Building on Past Work

Before starting a new task, query your workspace to see if you've done something similar:

text
You: "Have I worked on authentication before? What approach did I use?"

Your AI will use query-workspace to search your snapshots and surface relevant past decisions.

Onboarding Team Members

New team member joining? Have them query your shared workspace to get up to speed:

text
"What are the key decisions we've made about the API design?"

Documentation from Conversations

After a productive conversation, save a snapshot with good highlights. Later, you can query for those topics and get instant documentation.

Troubleshooting

Connection Issues

Can't connect?

Check these common issues:

  • Is the server URL correct? Should be https://mcp.neuros.run/mcp
  • Is your AI tool updated to the latest version?
  • Try restarting your AI tool after adding Spaces

No Results When Searching

If queries aren't finding your snapshots:

  • Use natural language - Instead of "auth", try "How did we implement authentication?"
  • Be specific - "React component patterns" works better than "patterns"
  • Check your workspace - Make sure you're searching the right workspace

Snapshots Not Saving

Permission errors?

Make sure you're logged in to your Spaces account. Your AI tool needs to authenticate with your workspace to save snapshots.

Available Tools

Your AI can use these tools automatically - you don't need to call them directly:

  • snapshot-conversation- Save important conversations
  • query-workspace- Search your knowledge base
  • list-snapshots- Browse what you've saved
  • get-snapshot- Retrieve full snapshot content
  • delete-snapshot- Remove snapshots you don't need