aispace — Claude Code MCP server: what it does, how to install
Shares agent-generated files via expiring links with download caps and optional local encryption.
claude mcp add --env AISPACE_KEY=<AISPACE_KEY> --env AISPACE_URL=<AISPACE_URL> --env AISPACE_ALLOWED_ROOTS=<AISPACE_ALLOWED_ROOTS> --transport stdio aispace -- npx -y @aispace-sh/cliWhat aispace does
The aispace MCP server moves generated files into temporary storage. It handles artifacts that are too big or structured for chat windows, such as exports or archives.
The client runs locally via stdio and registers ten tools for file management. Supported operations include setting link expiration times, capping download counts, and revoking access. When needed, files can be encrypted on your machine with age keys before upload.
Without an AISPACE_KEY, the server fails to connect. Generating public expiring links requires a Pro account.
What it helps with
- share large artifacts and exports outside the chat context window
- generate temporary download links with expiration and download caps
- revoke access and delete stored files on demand
- encrypt sensitive files locally using age keys before upload
Example prompts for the agent
- Upload the generated report.pdf to aispace and create a link valid for 1 hour
- Share the build archive via aispace with a limit of one download
- Delete the uploaded file from aispace using its ID
How to install aispace
Platform CLI
claude mcp add --env AISPACE_KEY=<AISPACE_KEY> --env AISPACE_URL=<AISPACE_URL> --env AISPACE_ALLOWED_ROOTS=<AISPACE_ALLOWED_ROOTS> --transport stdio aispace -- npx -y @aispace-sh/cliReplace <…> with your own values
Platform CLI
codex mcp add aispace --env AISPACE_KEY=<AISPACE_KEY> --env AISPACE_URL=<AISPACE_URL> --env AISPACE_ALLOWED_ROOTS=<AISPACE_ALLOWED_ROOTS> -- npx -y @aispace-sh/cliReplace <…> with your own values
Config file
{
"mcpServers": {
"aispace": {
"command": "npx",
"args": [
"-y",
"@aispace-sh/cli"
],
"env": {
"AISPACE_KEY": "<AISPACE_KEY>",
"AISPACE_URL": "<AISPACE_URL>",
"AISPACE_ALLOWED_ROOTS": "<AISPACE_ALLOWED_ROOTS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"aispace": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@aispace-sh/cli"
],
"env": {
"AISPACE_KEY": "<AISPACE_KEY>",
"AISPACE_URL": "<AISPACE_URL>",
"AISPACE_ALLOWED_ROOTS": "<AISPACE_ALLOWED_ROOTS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e AISPACE_KEY=<AISPACE_KEY> -e AISPACE_URL=<AISPACE_URL> -e AISPACE_ALLOWED_ROOTS=<AISPACE_ALLOWED_ROOTS> aispace npx -y @aispace-sh/cliReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about aispace
How to install aispace in Claude Code?
Install it by running `claude mcp add --env AISPACE_KEY=<AISPACE_KEY> --env AISPACE_URL=<AISPACE_URL> --env AISPACE_ALLOWED_ROOTS=<AISPACE_ALLOWED_ROOTS> --transport stdio aispace -- npx -y @aispace-sh/cli`. Replace the placeholders with your actual credentials.
What does aispace do?
It lets AI assistants hand off large documents or build artifacts using temporary download URLs instead of cluttering the prompt context.
Is a Pro account required for public links?
Yes, public expiring handoffs require a Pro plan. Standard file uploads remain private to your API key.
