Prerequisites
- A Render account that can see the workspace you want CloudThinker to investigate.
- Permission to create an API key on that account.
- A CloudThinker workspace where you can add connections.
Setup
1
Create a Render API key
In the Render Dashboard, open Account Settings → API Keys (direct link) and create a key named
cloudthinker.Copy the key right away. Render shows the full value only once.2
Add the connection in CloudThinker
In the sidebar, click More → Workspace settings → Connections. On the Builtin Connections tab, search for Render, paste the key into RENDER_API_KEY, and click Connect.Success state: the Render card shows a Connected status.
3
Run the verify prompt
Ask the prompt in Verify the connection in a new chat. Don’t skip this: Render accepts the connection handshake even with a bad key, so a wrong key only shows up when the first request runs.Success state: CloudThinker lists your Render workspaces and services by name.
Connection details
Required permissions
Render API keys aren’t scoped. A key acts as the account that created it and reaches every workspace and service that account can see.Agent capabilities
Every change an agent makes goes through your workspace’s Approvals first. On the default Auto · Rules + AI · Ask me mode, AI judgment can let a safe change run without asking — and an Allow Rule can too, once CloudThinker turns on Rule enforcement for your workspace. Choose Manual to approve every change yourself.
Postgres queries run on Render’s side: Render hosts the server CloudThinker calls (an MCP server, the standard way AI agents call a service’s tools), and it runs the SQL with your API key. CloudThinker never holds database credentials. Because a query is a read, no Rule can switch it off. To keep a database out of reach, create the key from an account that can’t see it.
Verify the connection
Example prompts
Troubleshooting
Connected, but the first prompt returns 401
Connected, but the first prompt returns 401
The key is wrong or revoked. Render’s handshake succeeds without a valid key, so the error appears at the first request. Create a new key in Account Settings → API Keys. Then open the connection, click the edit icon on the instance, click Replace… in Edit Instance, paste the key, and click Save and test.
403, or expected services are missing
403, or expected services are missing
The key’s account isn’t a member of that workspace. Ask CloudThinker to list your Render workspaces to see what the key reaches, then create the key from an account in the right workspace.
404 for a service or database
404 for a service or database
The service or database was renamed or deleted, or the name doesn’t match. Ask CloudThinker to list your Render services, then refer to the service by the name in that list.
429 rate limit
429 rate limit
Render is throttling requests. Wait a minute and retry with a narrower request, such as one service or a shorter log window.
A deploy or change didn't happen
A deploy or change didn't happen
Deploys, environment-variable updates, and new resources go through Approvals, and some wait for a person. Check the chat for a pending approval request and answer it before asking again.
Security
- Least privilege — grant only the permissions the agents need for your use case; start read-only and widen later.
- Read-only by default — use read-only credentials unless you want agents to make changes through this connection.
- Rotate credentials — rotate keys and tokens on your normal schedule; CloudThinker picks up the new value when you update the connection.
- Revoke on offboarding — remove the credential at the provider when you delete a connection or a teammate leaves.
- One-time key display: Render shows the API key in full only at creation, so store it in your password manager before you leave the page.
- Set a rotation schedule: Render API keys don’t expire, so replace the key on a fixed schedule and revoke the old one.
- Account-wide reach: because a key reaches every workspace its account can see, revoke it in Render (Account Settings → API Keys, then delete the key) as soon as you delete the connection.
Related
Approvals
Decide which Render changes run on their own and which wait for you
Heroku connection
Connect another app platform with a similar setup