# AI Tools

The Quickback CLI ships with built-in support for AI developer tools. One install gets you a Claude Code skill, Cursor IDE rules, and an MCP server that works with any AI tool.

## MCP Server

The MCP server exposes Quickback documentation, project config, and feature definitions to any MCP-compatible AI tool — Claude Desktop, Cursor, VS Code Copilot, Windsurf, and more.

### Setup

Add to your AI tool's MCP configuration:

```json
{
  "mcpServers": {
    "quickback": {
      "command": "npx",
      "args": ["@quickback-dev/cli", "mcp"]
    }
  }
}
```

**Where to put this:**

| Tool | Config File |
|------|-------------|
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) |
| Cursor | `.cursor/mcp.json` in your project root |
| VS Code (Copilot) | `.vscode/mcp.json` in your project root |

### What the MCP Server Provides

**Documentation tools:**

| Tool | Description |
|------|-------------|
| `list_topics` | List all 100+ documentation topics |
| `get_doc` | Get a specific doc by name (supports fuzzy matching) |
| `search_docs` | Search documentation content by keyword |

**Project-aware tools** (when running inside a Quickback project):

| Tool | Description |
|------|-------------|
| `read_config` | Read your `quickback.config.ts` |
| `list_features` | List all features and their table files |
| `read_feature` | Read the source code of a specific feature |
| `read_schema_registry` | Read the compiled `schema-registry.json` |

The MCP server also registers every documentation topic as an MCP resource at `quickback://docs/{topic}`.

---

## Claude Code Skill

The Claude Code skill gives Claude deep knowledge of Quickback's security layers, patterns, and APIs. It also activates a specialist agent for generating complete feature definitions.

### Install

```bash
quickback claude install
```

**Options:**

| Flag | Description |
|------|-------------|
| `--global` | Install to `~/.claude/` (available in all projects) |
| `--local` | Install to `./quickback/.claude/` (project-specific) |

### Manage

```bash
quickback claude status    # Check installation
quickback claude update    # Update to latest version
quickback claude remove    # Remove the skill
```

### What You Get

- **Quickback Skill** — Claude understands `defineTable()`, `defineActions()`, security pillars, provider options, and the compiler workflow
- **Specialist Agent** — Automatically activates when creating resources, configuring security, or defining actions. Generates complete, working code in your `quickback/features/` directory.

---

## Cursor IDE Rules

Cursor rules provide Quickback context directly to Cursor's AI, activated automatically when editing `quickback/**/*.ts` files.

### Install

```bash
quickback cursor install
```

This copies `quickback.mdc` to `.cursor/rules/` in your project. Consider committing this file to your repo so your team gets the rules automatically.

### Manage

```bash
quickback cursor status    # Check installation
quickback cursor update    # Update to latest version
quickback cursor remove    # Remove the rules
```

---

## Usage Examples

With any of these tools installed, you can ask your AI to:

```
"Create a candidates feature with org-scoped firewall and email/phone masking"

"Add an 'approve' action to expenses that sets status and records the approver"

"Show me the firewall documentation"

"What security layers does my current project have configured?"
```

## See Also

- [Claude Code Plugin](/compiler/claude-code-skill) — Full plugin reference
- [Getting Started](/compiler/getting-started) — Project setup guide
