Skip to content

Agent setup

Set the key before configuring a client:

Terminal window
export SPACE_INDEX_API_KEY='replace-with-your-key'

Create or update a project .mcp.json file:

{
"mcpServers": {
"space-index": {
"url": "https://mcp.spaceindex.io",
"headers": { "Authorization": "Bearer ${SPACE_INDEX_API_KEY}" }
}
}
}
Setup prompt
Read https://docs.spaceindex.io/llms.txt. Configure Space Index in Claude Code using the SPACE_INDEX_API_KEY environment variable. Never echo, log, or commit that value. List the available tools, then run a harmless search for "satellite" to confirm the connection.

Claude Desktop requires a local mcp-remote bridge. Native remote connector setup is not supported until full OAuth authorization-server work exists.

{
"mcpServers": {
"space-index": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.spaceindex.io", "--header", "Authorization: Bearer ${SPACE_INDEX_API_KEY}"]
}
}
}
Setup prompt
Read https://docs.spaceindex.io/llms.txt. Configure Space Index in Claude Desktop using the SPACE_INDEX_API_KEY environment variable. Never echo, log, or commit that value. List the available tools, then run a harmless search for "satellite" to confirm the connection.

Add this server to Cursor’s MCP configuration:

{
"mcpServers": {
"space-index": {
"url": "https://mcp.spaceindex.io",
"headers": { "Authorization": "Bearer ${env:SPACE_INDEX_API_KEY}" }
}
}
}
Setup prompt
Read https://docs.spaceindex.io/llms.txt. Configure Space Index in Cursor using the SPACE_INDEX_API_KEY environment variable. Never echo, log, or commit that value. List the available tools, then run a harmless search for "satellite" to confirm the connection.

Run this command from a shell where SPACE_INDEX_API_KEY is set:

Terminal window
codex mcp add space-index --url https://mcp.spaceindex.io --bearer-token-env-var SPACE_INDEX_API_KEY
Setup prompt
Read https://docs.spaceindex.io/llms.txt. Configure Space Index in Codex using the SPACE_INDEX_API_KEY environment variable. Never echo, log, or commit that value. List the available tools, then run a harmless search for "satellite" to confirm the connection.

Configure a server with URL https://mcp.spaceindex.io and the header Authorization: Bearer ${SPACE_INDEX_API_KEY}. Refer to the client’s Streamable HTTP MCP documentation for its configuration syntax.

Setup prompt
Read https://docs.spaceindex.io/llms.txt. Configure Space Index in a Streamable HTTP MCP client using the SPACE_INDEX_API_KEY environment variable. Never echo, log, or commit that value. List the available tools, then run a harmless search for "satellite" to confirm the connection.