Connect an agent
Connect your agent from your Space
Sign in at app.getspace.sh, open Agents, and copy the connection line your Space shows. This guide explains what happens from there.
Open SpaceWhat does an MCP connection do?
The Model Context Protocol (MCP) lets an agent access tools and data in your Space workspace. You authorize the connection and choose its access. Connecting does not automatically import your earlier conversations; useful context has to be saved explicitly.
Which clients have been tested?
Claude Code, Codex, Hermes, Cursor, Claude, ChatGPT, Gemini and Cline have each been tested with Space. Codex CLI was the first, with a recorded document-and-task integration check in the development version. Agents on a server that cannot receive a browser redirect connect with a six-digit code instead.
The Codex integration note describes the 11 September 2026 check. It does not establish production readiness or reliable memory across sessions.
Connect from your Space
Each Space shows its own connection line, with the MCP address filled in. This public website is not an MCP endpoint.
- Open your Space
Sign in at app.getspace.sh and open Agents → Connect agent.
- Copy the connection from Space
Use the exact command and MCP URL shown there. The getspace.sh website address is not a connection URL.
- Review the requested access
Complete the browser authorization flow. Read access lets the agent retrieve context; grant write access when you want it to save or update work.
- Add the memory instructions
After connecting, Space suggests the setup options below. Copy the block yourself or ask your agent to add it without overwriting existing instructions.
- Try a small piece of work
Ask the agent to save a short document with a decision and a next step. Refresh Space and check the document and its saved revision.
After connecting: help your agent remember
Make Space part of the way your agent works. Set up its memory instructions once, then keep useful context between sessions.
Set up your agent
Paste the setup prompt into your connected agent to add Space memory instructions. It will preserve your existing instructions and guide you through any manual steps.
Claude Code
Codex
Cursor
Hermesor your preferred agentOnce connected, ask your agent to retrieve the context and open tasks for your project.
Update your instructions
Already set up? Ask your agent to review its Space instructions while preserving connection settings and personal edits. It will ask before making changes.
Give your agent a memory habit
Add the instructions to AGENTS.md, CLAUDE.md, or the instruction settings your agent supports. Connecting to MCP alone does not install these instructions.
Choose your Space skills
Optional workflows for your connected agent. Install the ones you need, not the whole list. Each download includes its instructions and Codex display metadata.
Download a skill and place its folder in your client’s skill directory, or copy an installation prompt for your agent. Skills do not connect MCP, grant access, or run automatically.
Space Setup
space-initInterview the user and seed a new Space
Space Import
space-importImport existing notes in approved batches
Space Session
space-sessionResume, checkpoint or hand off work
Space Refine
space-refineDistil a conversation into Space
Space Recall
space-recallRetrieve stored context before answering
Space Remember
space-rememberSave durable facts, decisions and lessons
Space Write-up
space-writeupWrite a sourced document from records
Space Brief
space-briefBrief a project's current state
Space Tasks
space-tasksCapture and update tasks with context
Space Journal
space-journalRecord or recap a day
Space Weekly Review
space-weekly-reviewReview a week's recorded work
Space Morning
space-morningStart the day from Space
Space Audit
space-auditInspect a Space and propose repairs
Space Find
space-findLocate anything stored in the Space
Space Projects
space-projectsCreate, update and archive projects
Space Base
space-baseMaintain custom databases and records
Space Organize
space-organizeOrganize memory with categories and projects
Space Skill Library
space-skill-libraryList, use, save and install a Space's skills
Copying a prompt does not edit files or run tools. The connection check is read-only; saving needs write access. Client connection support varies.
Copying a prompt is not a completed setup. Paste it into your agent, review its result, and use the read-only check before asking it to save work. You can reopen these options from the app’s Agents page.
Inspect and manage access
The Agents page lets you inspect a connection’s grant and revoke it. Revoking access cannot take back information the agent has already received.
The recorded Codex check does not cover the full connection lifecycle. Revocation, reconnecting, and token refresh with a real client need their own acceptance checks.
To create an account first, start with Getting started. For how saved context is used, read How memory works.