---
title: "Quick Start — 60 Seconds to First Task | AgentRQ Docs"
url: https://agentrq.com/docs/getting-started
description: "Get AgentRQ running with Claude Code in under 60 seconds. Sign up, create a workspace, paste one config snippet — done."
---

[Docs](https://agentrq.com/docs/) / Quick Start

60-Second Setup

# Quick Start

From zero to your first agent-created task in under 60 seconds. No credit card. No config files to hunt down.

TL;DR

1. 1. Sign up at app.agentrq.com
2. 2. Create a workspace, copy your MCP token
3. 3. Add one JSON snippet to `.mcp.json`
4. 4. Tell Claude to `task create` — done

1

## Create Your Account

Go to [app.agentrq.com](https://app.agentrq.com/login?utm_source=docs-getting-started&utm_term=signup) and sign in with your Google or GitHub account. AgentRQ uses OAuth2 — no passwords to manage.

app.agentrq.com/login

![AgentRQ login page — Continue with Google or GitHub](https://agentrq.com/assets/app-signin.jpg)

What you get for free

- Unlimited workspaces
- Unlimited tasks and replies
- Real-time SSE notifications
- All 7 MCP tools
- File attachments per task

2

## Create a Workspace

A workspace is an isolated collaboration environment for one project. Create one per Claude Code project you want to keep humans in the loop for.

1. 1. In the dashboard, click + New Workspace
2. 2. Give it a name (e.g., `my-api-project`)
3. 3. Click Generate MCP Token — copy it now (you won't see it again)
4. 4. Note your Workspace ID (visible in the URL or workspace settings)

app.agentrq.com — Tasks

![AgentRQ tasks screen showing incoming agent tasks](https://agentrq.com/assets/docs-tasks-screen.png)

3

## Add to .mcp.json

In your project root (where you run `claude`), create or update `.mcp.json` with the AgentRQ server entry:

.mcp.json

```
{
  "mcpServers": {
    "agentrq-WORKSPACE_ID": {
      "type": "http",
      "url": "https://WORKSPACE_ID.mcp.agentrq.com/mcp?token=YOUR_MCP_TOKEN"
    }
  }
}
```

Replace `WORKSPACE_ID` and `YOUR_MCP_TOKEN` with the values from step 2. The server key must include your workspace ID — Claude Code uses it in step 4, below, to address this server by name.

Existing .mcp.json?

Just add the `agentrq` entry inside `mcpServers`. AgentRQ coexists with other MCP servers.

4

## Start Claude Code

Plain `claude` auto-discovers `.mcp.json` and gives you AgentRQ's 7 tools, but tasks and messages created for you only surface the next time Claude calls a tool. To have them pushed into the conversation as they happen, start with the channels flag instead, pointing at the server key from step 3:

Terminal

```
$ claude --dangerously-load-development-channels server:agentrq-WORKSPACE_ID --name my-api-project
✓ MCP server connected: agentrq-WORKSPACE_ID
  Tools: task, memory, skills, workspace,
         siteTools, pano, help

> Build the auth module and ask me before touching the DB schema
```

Why --dangerously-load-development-channels?

Custom notification channels — how AgentRQ delivers a new task without you having to ask for one — aren't on Claude Code's approved allowlist yet, so this flag is required during the research preview. `--name` just labels the session; use your workspace name so it's recognizable if you run more than one.

Alternative: ACP Agents

### Connect Gemini & Others

Not using Claude Code? Use the **ACP Gateway** to connect any agent that supports Agent Client Protocol.

```
$ npx -y @agentrq/acp-gateway@latest --agent harn
```

[Read ACP Guide](https://agentrq.com/docs/connect-acp-agent)

5

## Receive Your First Task

When Claude needs your input, it calls `task` with `"action": "create"`. You'll immediately see a new task card appear in the AgentRQ dashboard at [app.agentrq.com](https://app.agentrq.com).

Example task from Claude

Pending from Claude Sonnet

Approve DB Schema Change

I'm about to add a `user_sessions` table with columns: id, user_id, token_hash, created_at, expires_at. This will require a migration. Approve to proceed?

Reply in the dashboard — Claude receives your response via the notification channel and continues immediately. No polling, no delay.

6

## Monitor Your Workspace

The workspace stats page gives you a real-time overview of activity across all your tasks — messages sent, tasks created, and more.

app.agentrq.com — Workspace Stats

![AgentRQ workspace stats dashboard](https://agentrq.com/assets/docs-stats-page.png)

## Next Steps

[Deep-dive: Claude Code Setup CLAUDE.md integration, permission handling](https://agentrq.com/docs/connect-claude-code) [Task Lifecycle Status flows, replies, attachments](https://agentrq.com/docs/tasks) [MCP Tools Reference All 7 tools, their actions, examples](https://agentrq.com/docs/mcp-tools)