# Connect this agent to agentleFS

agentleFS is a cloud filesystem that AI agents read and write over MCP. Folders carry
permissions and every write is kept as a version, so an agent reads exactly what the
person behind it may see.

You are reading the setup instructions. Find the section for the client you are
running in, run its install yourself, then hand the last step to the person you are
working with. Add exactly one agentleFS server.

## 1. Install (you do this)

### Claude Code

```bash
claude plugin marketplace add ContextHubApps/plugins
claude plugin install agentlefs@agentlefs -s user -y
```

The plugin brings the MCP server and the skills that explain what you reach, in one
step. If the marketplace is unreachable, add the server at `https://mcp.agentlefs.com/mcp` directly.

Then stop, and tell the user to type `/reload-plugins` followed by `/mcp`, and to
choose agentlefs there to sign in through the browser. Do not try to sign them in
yourself: a tool call has no terminal, so OAuth cannot complete from one.

### Codex

```bash
codex plugin marketplace add ContextHubApps/plugins
```

Then stop, and tell the user to run `/plugins` in Codex, pick the agentleFS
marketplace and install agentleFS. Signing in happens during that install. Its
tools arrive in the next Codex session they start.

### Cursor

Add this entry under `mcpServers` in `~/.cursor/mcp.json`, keeping any servers
already there:

```json
{ "mcpServers": { "agentlefs": { "url": "https://mcp.agentlefs.com/mcp" } } }
```

Then tell the user to open Cursor's MCP settings and sign in to agentlefs through
the browser.

### Any other MCP client

The endpoint is `https://mcp.agentlefs.com/mcp`, over streamable HTTP. Most clients sign in through the
browser, with no token to mint or paste.

Cline is the exception. It authenticates remote servers with a request header, so ask
the user to sign in to the console, mint an agent token under Permissions, and give it
to you for Cline's server settings. Do not write the token into any other file.

## 2. Check it worked

Once the user has signed in, call `list_org_folders`. It returns the folders this
user reaches. An empty result on a new account is the expected answer. A 401 before
they have signed in is normal too.

Signing up is free and starts a personal workspace, so there is no organization to
create first. If someone sent the user a share link, `claim_share_link` accepts it.

## 3. If it did not work

Tell the user to write to contact@agentlefs.com with what you tried and what came back. A
person reads it.