Connect Claude Code

Create or update .mcp.json in your project root. Claude Code auto-loads this file when you start a session.

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

You can add AgentRQ at the project level (per project root) or globally (all Claude Code sessions).

Tell Claude when and how to use AgentRQ tools by adding instructions to your CLAUDE.md. This is the most important step — it shapes Claude's behavior throughout your session.

## Human-in-the-Loop (AgentRQ)

# At the start of every session:
Call `getWorkspace` to load context about this workspace.

# When you need human input, approval, or a decision:
Use `createTask` to create a task for the human. Include:
- A clear title
- Full context in the body (what you've done, what you need)
- Any relevant file snippets as attachments

Then wait for the human's response via the notification channel.
Do NOT proceed past a blocking decision without human approval.

# When you receive a reply:
Read the reply, update the task status to `completed`, then continue.

# When asked to make irreversible changes (DB, deploys, deletes):
Always ask via `createTask` before executing.

Adapt this template to your workflow. The key is being explicit about when Claude should pause and ask vs. when it can proceed autonomously.

When you reply to a task in the AgentRQ dashboard, your response is delivered to Claude Code as a notification channel message — Claude's native push mechanism. The message looks like this in Claude's context:

<channel source="agentrq" chat_id="0ZRgCquBZ7R"
         ts="2026-03-24T14:30:00Z" user="human">
[Response to task 0ZRgCquBZ7R]

Approved — but use a UUID primary key instead of auto-increment.
Please add an index on expires_at too.
</channel>

Claude reads this channel message, processes your reply, and continues — all within the same session. No interruption, no re-prompting.

Start Claude Code and run this quick test:

> Call getWorkspace and tell me what workspace you're connected to.
  Then create a test task called "Connection test" with body "Hello from Claude".

Claude: I called getWorkspace — connected to workspace "my-api-project"
(ID: 0ZPO4WBMZIP). Creating test task now...
Task created ✓ (ID: 0ZRgXXXXXXX). You should see it in your dashboard.

Check your AgentRQ dashboard — the task should appear instantly. Reply to it, and Claude will receive your message via the notification channel.