---
title: "Getting Started"
source: https://fieldbw.com/docs/tr-1/getting-started
---

# Getting Started

## What is TR-1?

[Task Register TR-1](https://tr1.fieldbw.com) is a GTD-inspired task management system with a built-in MCP server. It lets humans and AI agents work from the same task list — creating, organizing, completing, and reviewing tasks through a shared system.

The web app is at [tr1.fieldbw.com](https://tr1.fieldbw.com). Sign up for an account to get started.

## Using the App

TR-1 is keyboard-first. Press **Ctrl+N** to capture tasks, use **arrow keys** to navigate, and single-key shortcuts to act on tasks (e.g., **X** to complete, **N** to move to Next Actions, **M** to open the Move panel).

For the full interface guide, keyboard shortcuts, and feature overview, see [Using TR-1](/docs/tr-1/using-tr1).

## Connecting AI Agents

### MCP (recommended)

Connect any MCP-compatible client (Claude Code, Claude Desktop, Cursor, ChatGPT) with a single URL. Agents get 40+ tools to manage tasks, projects, and reviews.

```bash
claude mcp add --transport http tr1 https://tr1.fieldbw.com/mcp
```

Most MCP clients handle OAuth automatically — just add the URL and sign in when prompted.

For API key auth:

```bash
claude mcp add --transport http tr1 https://tr1.fieldbw.com/mcp \
  -h "Authorization: Bearer YOUR_KEY"
```

See the [MCP Tools Reference](/docs/tr-1/mcp-tools) for the full list of 40+ tools.

### REST API

Standard JSON API for scripts, integrations, and custom tooling.

```bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://tr1.fieldbw.com/api/v1/inbox
```

See the [REST API Reference](/docs/tr-1/rest-api) for all endpoints.

## Authentication

**OAuth (recommended for MCP):** Most MCP clients handle this automatically. Just add the URL and sign in when prompted.

**API keys:** Generate in the app under Account → API Keys. Pass as a Bearer token. Good for scripts and clients that don't support OAuth.

**Session cookies:** The web UI uses session-based auth. Not recommended for integrations.

## Core Concepts

| Concept | Description |
|---------|-------------|
| **Task** | A single action item with status, project, dates, energy, priority |
| **Project** | An outcome requiring multiple tasks. Has its own status and tasks. |
| **Area** | An ongoing area of responsibility. Contains projects. |
| **Status** | `inbox`, `next`, `waiting`, `scheduled`, `someday`, `completed` |
| **Today flag** | Marks a task for today's focus. Independent of status. |
| **In Progress** | Marks a task as actively being worked on. |

## Next Steps

- [GTD Primer](/docs/tr-1/gtd-primer) — understand the methodology behind TR-1
- [Using TR-1](/docs/tr-1/using-tr1) — interface guide, keyboard shortcuts, and features
- [Use Cases and Examples](/docs/tr-1/use-cases) — practical patterns for working with AI agents and automation
- [MCP Tools Reference](/docs/tr-1/mcp-tools) — full reference for all 40+ MCP tools
- [REST API Reference](/docs/tr-1/rest-api) — endpoint documentation for scripts and integrations