Connect Zaru to Any MCP Client

Zaru can be activated in any MCP-compatible tool. Connect the Zaru MCP server and type zaru init to bring the full AEGIS agent orchestration platform into your editor or AI assistant.

Prerequisites

• A Zaru account at ask.myzaru.com
• An API key (generate one at Settings → API Keys in the Zaru client, or via The Vault)

MCP Server URL

https://mcp.myzaru.com/mcp/v1

All clients connect to this single endpoint using the StreamableHTTP transport.

Authentication

All requests require an API key passed as a Bearer token:

Authorization: Bearer <your-api-key>

Client-Specific Setup

Claude Code

claude mcp add zaru \
  --transport http \
  https://mcp.myzaru.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "zaru": {
      "url": "https://mcp.myzaru.com/mcp/v1",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Navigate to Settings → MCP → Add Server and enter:

Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "zaru": {
      "serverUrl": "https://mcp.myzaru.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

Create or edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "zaru": {
      "type": "http",
      "url": "https://mcp.myzaru.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Gemini CLI

gemini mcp add \
  --name zaru \
  --url https://mcp.myzaru.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY"

Any MCP Client

Any client supporting the StreamableHTTP transport can connect with:

First Use

Once connected, tell your AI assistant:

zaru init

The assistant will call the zaru.init tool and adopt the Zaru persona with access to all AEGIS tools.

To start in a specific mode:

zaru init agentic

Available modes: chat, agentic, workflow, execute.

Switching Modes

During a session, say "switch to workflow mode" and the assistant will call zaru.mode to change modes with updated tools and behavior.

Troubleshooting