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:

{"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 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 and MCP skill, 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 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 and the CLI skill. 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, with tc-apps (apps).
A named API key or other secret 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 or share, with tc-publish (publish). Make the link only with the owner's permission.
Meeting recap, follow-ups or transcript search TinyChat meetings, 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 using the agent reporting instructions. 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.