Overview

A personal agent is the quickest way to let an AI app work in Scrambl without it acting as you. It follows your permissions, so it can see and change only what you can. You can have up to three personal agents, for example one for research and one for weekly reporting.

Who can do this

  • Everyone: Any workspace member (Owner, Admin, or Member role) can create up to three personal agents. No access level is needed, because a personal agent only ever has your own permissions.
  • Personal accounts: Not available. Agent accounts are a work feature and are hidden in personal (family) spaces.

Step 1: Create the agent

  1. Open My agents. You can also get there from Account settings → Integrations → My agents.
  2. Click New personal agent. The button is disabled once you have three agents.
  3. Enter a Name (for example, Scout) and pick an avatar.
  4. Optionally fill in Purpose and Instructions & personality. These are shared with the connected AI app to shape how it works. Access is always enforced by Scrambl.
  5. Leave Allow task assignment on if you want to assign tasks to the agent from the assignee picker.
  6. Optionally open Optional usage limit and set Monthly tool calls. Leave it blank for no limit.
  7. Click Create agent.

Step 2: Create its API key

The API key dialog opens right after the agent is created. You can open it again later with the key icon (Create API key) on the agent's row.

  1. Enter a Key name that says where the key will live, such as Claude Desktop or CI runner.
  2. Click Create key.
  3. Copy the key immediately. It won't be shown again.
  4. Note the MCP server address shown under Connect as the agent.
  5. Click Done.

Important: Connect the app with the agent's API key. If you connect by signing in with your own Scrambl account instead (OAuth), the app acts as you, not as the agent.

Step 3: Connect your AI app

  1. In the AI app, add Scrambl as an MCP server using the address from the key dialog.
  2. Choose the API key connection option and paste the key. Tools that call the API directly send it in an x-api-key header.
  3. Ask the app to do something small, such as listing your open tasks, to confirm it connects.

Step 4: Check what the agent did

  • Click the agent's name, or View activity, to open its page: monthly usage, work waiting for your review, and recent activity.
  • Work the agent finishes lands in Tasks → Reviews.

Troubleshooting

IssueWhat to check
You lost the key.Keys are shown once. Create a new key from the agent's row and update the app. To retire the old key, revoke it from Account settings → Integrations → Connections & keys.
The agent's actions show your name.The app is connected with your own sign-in. Reconnect it with the agent's API key.
Calls fail with a budget message.The agent reached its Monthly tool calls limit. Raise it with Edit agent, or wait for the new month.
The agent can't connect at all.Agent accounts need the Pro or Business plan, and the agent must be Active (not paused or revoked).