Before you start
You need:- An assistant that lists TinyCloud in its connector directory.
- A TinyCloud account. If you do not have one, you create it during sign-in with an email address, a passkey or Google.
Connect
- Open your assistant’s connector directory, find TinyCloud and choose Connect. In Claude, the directory is under Customize, then Connectors.
- Sign in with OpenKey, TinyCloud’s sign-in service. OpenKey shows the name of the assistant that is asking. Choose Allow.
- Ask the assistant to connect TinyCloud. The first time, it shows you an approval link.
- Open the link. The page is titled Authorize capabilities. Read what it asks for and choose Approve.
- The page then says “You can close this window and return to the CLI.” Close it, go back to the assistant and tell it to continue.
Whether TinyCloud appears in a directory is decided by that assistant. You
only need an address if your assistant asks you to enter one.
Approvals
The connector asks before it can do anything new. A tool that needs access returns a link instead of a result, and the assistant shows it to you.- An approval link works for 15 minutes and only once.
- An approval lasts 30 days. After that the connector asks again.
- If you decline, nothing is read or written, and the assistant stops that request.
- The approval page names the requester as “TinyCloud CLI”, whichever
assistant you use. Under “Returned to” it shows where your approval goes: an
address that starts with
https://mcp.tinycloud.xyz/and names your assistant, such ashttps://mcp.tinycloud.xyz/claude/connect/callback. - The page shows the reason for the request and says that it comes from the caller and is not verified. Approve only a link that your own assistant just showed you.
What you can ask
- “Add a todo called Review release checklist, then show it to me.”
- “What is on my todo list?”
- “Mark Review release checklist as done.”
- “Delete the todo called Old draft.”
- “Use a searchable copy to count the todos I finished this month.”
Europe/London, so that records carry your local date and time. It
does not need your city or location.
Tools
Your assistant may ask you to confirm a tool before it runs. That confirmation
is the assistant’s own; it does not replace an approval in OpenKey.
How records are kept
- An app is a group of records, such as todos. Each app has a short description of its record kinds, which the assistant creates the first time and reads before it writes.
- A record has a key, a version, a time and your data. The connector adds who wrote it.
- Before changing a record, the assistant reads it. If the record changed in the meantime, TinyCloud refuses the change and the assistant reads it again. It never overwrites a newer version silently.
- Deleting a record removes it from lists and reads. The storage node may keep the bytes of earlier versions.
Searchable copy
Reading records one folder at a time is slow for questions such as “how many did I finish this month?”. For those, the connector can keep a searchable copy of one app’s records.- It is optional and needs its own approval.
- It is a copy. Your records stay the source of truth, and a query never changes them.
- A query is one
SELECTorWITHstatement in SQLite syntax over a table namedentries, with the columnskey,kind,folder,id,day,v,at,by,dataandrec. - The first query for an app builds the copy and can take several seconds.
What the connector cannot do
- Read or write secrets, files or any data outside personal records.
- Run SQL against your other databases, or read arbitrary keys.
- Share or publish anything.
- Work with TinyCloud’s Health Log or Recipes apps. If you ask for one, the connector answers that it is not available and gives you the app’s link.
- Make payments or generate images, audio or video.
Privacy
- Do not keep passwords, API keys, payment-card numbers, government identifiers or protected health information in personal records.
- The connector’s logs hold the tool name, the outcome and the duration. They do not hold keys, values or queries.
- Disconnecting the connector in your assistant does not delete your records.
- The privacy policy describes how TinyCloud handles your account and content.
Remove access
- In your assistant: disconnect or remove the TinyCloud connector.
- In OpenKey: sign in at openkey.so and open Settings. Under Connected MCP apps, choose Disconnect for the assistant, then Disconnect app. Its access usually ends within a minute and always within five.
If something goes wrong
For anything else, write to [email protected] or
see tinycloud.xyz/support. Say which
assistant you used and what happened. Do not send passwords, codes or approval
links.
