JetBrains | Spectron

Installing Spectron as an MCP server in JetBrains IDEs (IntelliJ IDEA, PyCharm, WebStorm, Rider, and more).

JetBrains AI Assistant supports MCP servers across the IDE suite: IntelliJ IDEA, PyCharm, WebStorm, GoLand, Rider, and the others. Installing Spectron gives the assistant persistent memory across sessions, so it can recall previous decisions and project context without you repeating them.

For integration rules your agent should follow (auth, scope, endpoints, common mistakes), see Agent guide (AGENTS.md).

Configure

Open Settings → Tools → AI Assistant → Model Context Protocol (MCP), click Add, and paste a JSON configuration. AI Assistant connects to remote servers over Streamable HTTP:

{
  "mcpServers": {
    "spectron": {
      "url": "https://<your-context-host>/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>",
        "X-Spectron-Context": "acme-prod"
      }
    }
  }
}

On SurrealDB Cloud, use your context host from Surrealist API keys (not a generic shared domain). Self-hosted: replace the URL with your Spectron server's base URL + /mcp.

Note

X-Spectron-Context is a client-side convenience for templating. Each API key is bound to one Context, so context_id is optional on every tool call; omit it to use the key's Context. An explicit value that does not match the key still returns 401.

Verify the installation

Reopen Settings → Tools → AI Assistant → Model Context Protocol (MCP) and confirm spectron is listed and connected
Open the AI Assistant chat and ask "What MCP tools do you have available?" It should report the Spectron tools

If the server fails to connect, check that the URL (your context host + /mcp) and API key are correct.

Usage examples

Store a project decision:

"Remember that this service uses hexagonal architecture and all adapters live under internal/adapters."

AI Assistant calls memory_store with a suitable scope.

Recall context before a change:

"What did we decide about where adapters live in this project?"

AI Assistant calls memory_recall before answering.

Scope per project

Narrow reads and writes with the per-tool scope argument (slash paths, for example ["org/acme/project/platform"]). Register paths with spectron scopes create before first use. For project isolation, use separate contexts or distinct scope paths.

Removing Spectron

Open Settings → Tools → AI Assistant → Model Context Protocol (MCP), select the spectron entry, and remove it.