Prerequisites
- A Rollbar account with access to the projects you want CloudThinker to see.
- A project access token for each project (read scope is enough for investigation).
- A write-scoped token only if you want agents to update item status (approval-gated).
Rollbar tokens are scoped per project. CloudThinker supports multiple projects in one connection — supply one token per project you want to include.
Setup
Create a project access token
In Rollbar, open the project and create (or copy) a project access token with read scope. Add a write-scoped token if you want agents to update items. See Rollbar’s MCP Server Setup for token and configuration details.
Connection Details
| Field | Description | Example |
|---|---|---|
| ROLLBAR_CONFIG_JSON | A projects array mapping each Rollbar project to its access token. Each entry has a name and a token. | see below |
Token field is
token (not access_token), and projects is an array. Format matches Rollbar’s MCP multi-project configuration.Required Permissions
Read operations (project list, items, top errors, deployments, versions, replay) work with a read-scoped project access token. Item updates additionally require a write-scoped token and explicit approval in CloudThinker.Agent Capabilities
Once connected, agents can investigate and act on errors across your configured projects.Read Capabilities
| Category | What the agent can do |
|---|---|
| Projects | List configured Rollbar projects and auto-scope to a single project |
| Error Items | List current and active items, inspect item details and occurrence signals |
| Top Errors | Surface the highest-impact errors and current production error posture |
| Deployments | Review recent deployments per project |
| Releases & Versions | Pull version context and correlate releases with error activity |
| Session Replay | Fetch replay context for items that have a recorded replay |
Write Capabilities
| Category | What the agent can do |
|---|---|
| Item Updates | Change an item’s status (e.g. resolve, mute) — requires approval |
Verify the Connection
Example Prompts
Troubleshooting
Auth fails or queries come back empty
Auth fails or queries come back empty
- The pasted project config is invalid JSON, does not include the requested project name, or maps the project to an expired token.
- List your configured projects first before treating a missing item or deployment as “no data”.
Agent asks which project to use
Agent asks which project to use
- This happens when several projects are configured. Name the project in your prompt (e.g. “for my-app”) so the agent can scope the query.
No replay available for an item
No replay available for an item
- Session replay context only exists for items that have a recorded replay. Items without replays will not return replay data — this is expected, not an error.
Item update is blocked
Item update is blocked
- Updates are approval-gated and need a write-scoped token. Confirm the token for that project has write scope, then approve the action when prompted.
Security Best Practices
- Least privilege — use read-scoped tokens for investigation; only add a write-scoped token for projects where agents should update items.
- Approval for controls — keep item updates approval-gated.
- Rotation — rotate project access tokens regularly and update them in CloudThinker.
- Revoke when unused — delete the token in Rollbar if you disconnect a project.
Related
Datadog Connection
Logs, metrics, and incident investigation
Approval
How approval-gated actions work