# 🔧 Connecting Your AI to Taskr

## 2.1 First Things First

### What We're Doing Here

We're going to connect your AI to Taskr so they can talk to each other. Think of it like adding Taskr to your AI's contact list so they can work together.

### Choose Your Path

There are three ways to use Taskr, depending on how you like to work:

**AI Code Editors (IDEs)**
- **Cursor** ⭐ - Complete IDE with AI built-in, everything in one place
- **Windsurf** - Fast and modern IDE by Codeium
- **Antigravity** - Google's AI coding environment
- **VS Code** - Traditional IDE with built-in AI agent and MCP support (v1.102+)

These are "all-in-one" tools—your AI writes code, saves files, and manages Taskr tasks all in the same app. Great for hands-on coding.

**Claude Desktop**
- Anthropic's full-featured AI app with powerful coding capabilities
- A great option if you prefer a chat-first workflow over a traditional IDE
- Claude Desktop can read, write, and manage files, run commands, and build entire projects—all through conversation
- Works on macOS and Windows
- See [Section 2.6](/docs/setup/2-6.md) for setup

**OpenClaw**
- A personal AI assistant that works from WhatsApp, Telegram, or any chat app
- Goes beyond coding—handles research, email workflows, project management, and more
- Connects to Taskr through ClawHub, an open skill registry for AI agents
- See [Section 2.7](/docs/setup/2-7.md) for setup

**My Recommendation:** If you're building software, start with **Cursor** or **Claude Desktop**. If you want an AI that handles tasks beyond coding, try **OpenClaw**.

### Already Done the Setup Wizard?

If you followed the setup wizard after signing up (covered in the [Getting Started](/docs/getting-started/1-1.md) guide), you're already connected! The sections below are for manual setup — useful if you skipped the wizard, need to connect a different AI tool, or want to tweak your configuration.

### What You Need Before Starting

Good news: there's **nothing to install and no API keys to copy and paste**. You point your AI tool at Taskr's web address and it signs you in through your browser—just like logging into any website.

All you need is:

**1. A Taskr account** 🔑
- The one you signed up with. The first time your AI tool connects, a browser window opens asking you to sign in and approve the connection. Click approve and you're done—your sign-in is securely cached so you won't be asked again.

**2. A project (optional)** 📁
- Taskr automatically works in your most recent project, so you don't have to pick one to get started.
- Want to target a specific project? Just ask your AI: *"Switch Taskr to my 'Website Redesign' project"* — it has a built-in `project` tool that can list, create, and switch projects for you. No IDs to copy.

> **Why no API key and no install?** Taskr connects over the web (a remote MCP server) and signs you in with a secure browser flow (OAuth). That means **no Node.js to install, no `npx`, and no secret tokens sitting in your config files** — just a web address.

> **Prefer the old local connector?** The `npx taskr-mcp-client` bridge still works if you'd rather run a local helper (it needs Node.js installed). It's no longer required—see [Section 2.8](/docs/setup/2-8.md).

---