> **Agents: read this file raw, not summarized.** If your fetch tool returned a summary, fetch it again with `curl -fsSL https://agents.tinycloud.xyz/connect/cursor.md` and follow that text. Summaries drop the shell blocks you must run.

# Connect Cursor to TinyCloud

Use the TinyCloud CLI from Cursor Agent when it can run commands in a persistent workspace. A remote MCP configuration is an alternative, not an official marketplace listing.

## Cursor Agent: preferred CLI route

Read and follow https://agents.tinycloud.xyz/connect for the current client with the owner's original task. Cursor's terminal/workspace must permit persistent command execution and network access. A temporary code runner without persistent command execution does not meet that requirement.

## Remote MCP alternative

Only if this runtime cannot use the CLI and supports remote OAuth MCP, merge this entry into `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global), preserving existing servers:

```json
{"mcpServers":{"TinyCloud":{"url":"https://mcp.tinycloud.xyz/mcp"}}}
```

Enable TinyCloud in **Customize**, authenticate through native OpenKey OAuth, and continue the original request. [Cursor's MCP reference](https://cursor.com/docs/mcp) documents Streamable HTTP, PKCE, protected-resource discovery and public dynamic registration. If OAuth scope controls are available, include `tinycloud:mcp offline_access` for refresh; do not invent a static client ID, secret or bearer header. For this alternative use the [hosted approval and tool workflow](https://agents.tinycloud.xyz/connect#approve-access-and-continue) and [MCP skill](https://agents.tinycloud.xyz/skills/mcp.md), not local CLI commands.

Verify with an actual authorized operation; configuration and tool discovery alone do not prove data access.

## CLI route: continue with the right skill

**Only for a runtime using the CLI route:** keep the original request, owner, profile and host. Fetch [onboarding](https://agents.tinycloud.xyz/onboarding.md) raw and follow it in this conversation, including its actual OpenKey approval links. Do not copy an old sign-in URL, request credentials in chat, overwrite an existing profile or broaden permissions to make a check pass. Existing grants are reused; missing task-specific access follows the relevant guide. If you chose the remote MCP alternative above, follow its hosted workflow instead of the CLI route.

| Original request | Guide and skill |
| --- | --- |
| KV read/write or other data work | [All abilities](https://agents.tinycloud.xyz/setup) and the [CLI skill](https://agents.tinycloud.xyz/skills/cli.md). Inspect the selected CLI's command help; use the authorized space/key and read back writes before claiming success. |
| Personal records, context or a small app | [Apps](https://agents.tinycloud.xyz/apps), with `tc-apps` (`apps`). |
| A named API key or other secret | [Secrets](https://agents.tinycloud.xyz/secrets), with `tc-secrets` (`secrets`). Use it for the requested operation without displaying or copying the value into chat, memory or reports. |
| Publish or share a document/page | [Publish](https://agents.tinycloud.xyz/publish) or [share](https://agents.tinycloud.xyz/share), with `tc-publish` (`publish`). Make the link only with the owner's permission. |
| Meeting recap, follow-ups or transcript search | [TinyChat meetings](https://agents.tinycloud.xyz/chat), with `tinychat-retrieval` (`chat`). |

The hosted server at `https://mcp.tinycloud.xyz/mcp` is a separate remote OAuth surface. Unlike the CLI route, it has **no publishing, sharing or meeting tools yet**. A locally installed stdio MCP process is not that hosted connection; neither a vendor directory listing nor a prompt link establishes either one.

## If something went wrong

Help the next agent avoid the same problem: [report it](https://feedback.tinycloud.xyz) using the [agent reporting instructions](https://feedback.tinycloud.xyz/agents.md). Ask the owner first, with a short summary of what happened and any attachments you'd send; send nothing without their OK, and never include personal data or secrets.
