Connect your first agent

Five minutes from "installed" to "triaging."

Qalatra runs a local MCP server at http://localhost:3457/mcp. Any MCP-aware CLI agent can read and write your tasks, notes, habits, and agent jobs through it. We'll use Claude Code in this example.

1. Start the MCP server

It's already running. Qalatra starts the MCP server on app launch. You can verify:

curl -s http://localhost:3457/health
# → { "ok": true, "started_at": "..." }

2. Register Qalatra with your agent

In Claude Code, add this MCP server to ~/.claude.json. The app's Settings → MCP panel can write it for you.

Claude Code

{
  "mcpServers": {
    "qalatra": {
      "type": "http",
      "url": "http://localhost:3457/mcp"
    }
  }
}

Cursor

Settings → MCP → Add Server. Use http://localhost:3457/mcp.

Custom / other

The server speaks standard MCP over HTTP+SSE. See MCP reference.

3. Sanity-check

Start a session with your agent and ask:

How many open tasks do I have?

If it answers with a real number, you're done. It just called mcp:list_tasks against Qalatra's database.

4. Teach it your vocabulary

Most people drop a tiny prompt into their agent's system instructions:

You have access to qalatra (MCP server on :3457).
Use it for anything task-, note-, or habit-related.
When I say "triage me", run the morning-briefing agent.

That's it. Your agent now has structured access to your work. Next: Run the triage-me loop.