Zed integration

Zed has built-in MCP support via its Agent Panel. Oka Reason works as a standard stdio MCP server.

Setup

1. Open Zed settings

Open Zed → Settings → Open Settings (or Cmd+,).

2. Add Oka as a context server

Add to your settings.json:

{
  "context_servers": {
    "oka": {
      "command": "npx",
      "args": ["-y", "@oka-core/reason"]
    }
  }
}

3. Authenticate

Open the Agent Panel (Cmd+Shift+A) and use the login tool:

Use the login tool to authenticate with Oka

This opens your browser to id.oka.so where you sign in or create an account. Your credentials are stored locally and refresh automatically.

4. Verify the connection

In the Agent Panel settings, you should see oka listed with a green dot indicating it’s connected.

Usage in Zed

In the Agent Panel, prompt the agent directly:

“Check Oka context for the auth module”
“Record a decision about the database schema change”
“Search Oka for prior learnings about API error handling”

Zed-specific notes

Permission prompts

Zed prompts for permission on every tool call by default. This is a security feature. For Oka read tools like context, you’ll want to approve quickly — the intelligence they return is most valuable at the start of a task.

Stdio only

Zed only supports stdio transport for custom MCP servers. Since @oka-core/reason runs via npx as a stdio server, this works natively — no extra configuration needed.

Tips

Set OKA_WORKSPACE in the env block to scope events to your project.
The Agent Panel is the primary interface for MCP tools. Open it with Cmd+Shift+A.