# drobek docs

> drobek is an open-source cloud workspace for small web apps that your AI agent builds over MCP: every write compiles into a version with a preview URL, and publishing puts it live. This is https://www.drobek.app/docs as Markdown (drobek v0.5.2).

## Using an AI agent?

Give it this page or https://drobek.app/llms.txt: it tells the agent how to connect and build.

**Agents, do this:**

1. Read https://drobek.app/llms.txt: the MCP server, every tool and the rules. The full contract: https://drobek.app/llms-full.txt.
2. Connect the MCP server https://drobek.app/mcp (OAuth: the user signs in once in the browser). Claude Code:

   ```sh
   claude mcp add --transport http drobek https://drobek.app/mcp
   ```

   then the user runs `/mcp` → drobek → sign in. Or install the plugin, which adds the server and the build skill:

   ```sh
   claude plugin marketplace add freema/drobek-plugin
   claude plugin install drobek@drobek
   ```

   Claude (web, desktop): add a custom connector with the URL https://drobek.app/mcp. Cursor, Codex: [connect](https://www.drobek.app/docs/agent#connect).
3. Create the app and write its files. Every write compiles and returns the result: fix what fails, then give the user the preview URL.
4. Publish only when the user asks.

A prompt to start from (the user adds the app idea):

> Read https://drobek.app/llms.txt and connect the drobek MCP server https://drobek.app/mcp. If a step needs me, such as signing in, tell me exactly what to do. Then build me: …

## Pages

Each page as Markdown; the HTML page is the address without `.md`.

### Use drobek

- [Overview](https://www.drobek.app/docs/overview.md): What drobek is, the loop, the core concepts, the self-host quickstart and connecting your agent.
- [Agents](https://www.drobek.app/docs/agent.md): Connecting Claude Code, Claude, Cursor or Codex over MCP, the tools and scopes, the briefing, skills and llms.txt.
- [Platform modules](https://www.drobek.app/docs/modules.md): The backend of an app: auth, data, forms, email, files and proxy, their configuration, and writing your own module.

### Run your own drobek

- [Self-hosting](https://www.drobek.app/docs/self-hosting.md): The quickstart, compose, every environment variable, TLS, backups, upgrades, custom domains and abuse handling.
- [Architecture](https://www.drobek.app/docs/architecture.md): One process, origins, versions, the compiler, serving, modules, TLS and jobs.

### Project

- [Security](https://www.drobek.app/docs/security.md): How to report a vulnerability, and the threat model.
- [Licensing](https://www.drobek.app/docs/licensing.md): AGPL-3.0, what it asks of you, and the boundary with the hosted drobek.app.

## The agent contract

- [llms.txt](https://drobek.app/llms.txt): the concise index — the MCP server, the plugin, every tool with its scope.
- [llms-full.txt](https://drobek.app/llms-full.txt): the full contract — the OAuth flow, every tool with inputs, result shape and an example, the briefing, limits, the error catalogue.
- Source: https://github.com/freema/drobek at v0.5.2 (AGPL-3.0).