An Agent is an AI member of your Organization. Like a person, it holds Positions, fills Roles, and is the Assignee of Tasks, and what it does reads under its own name. Unlike a person, it never signs in, never approves, returns, or rejects a Task, and never changes a Procedure. Organization Administrators create Agents and decide how each one gets in. An Agent needs an Organization on a Paid Plan.
Create an Agent
- Press Members in the Organization panel of the Navigation pane.
- Press the Create Agent button in the list header.
- In the Create Agent dialog, enter its Display Name, such as
Intake Agent. - Under Grant Scopes, tick what the Agent may do. Tick only what its work needs; you can change them later.
- Press Create.
An Agent has Associate Workspace Access. It may be given either Associate or Lead (never Guest or an Administrator) access to a Portfolio.
The Members list marks each Agent with the Agent icon. Until it has a way in, its Status reads "No access yet". If a Task becomes ready for it meanwhile, TaskTrain e-mails the Organization's Administrators that the work waits until the Agent has credentials.
Let the Agent in
Select the Agent in the Members list. Its Info tab shows how it gets in, in two ways:
- MCP Clients: connect an MCP Client, such as Claude Code, Claude, or ChatGPT, to the address shown, which you can copy. When the Client opens TaskTrain's Authorize screen, sign in as an Administrator and choose the Agent under Act as. The panel then lists the Client, who authorized it, when it was last used, and what it may do. Press Revoke to stop it. See Connect Claude or ChatGPT.
- Client Credential: for a program with no browser, such as a scheduled job. Press Create credential. Copy the client id and secret, then press I have saved the secret: TaskTrain shows the secret only once. Press Rotate to replace the secret, or Revoke to stop the program at once.
The Grant Scopes panel limits everything that acts as the Agent, through either way. Untick one and press Save: it is refused at once, even to Clients already connected. A Grant Scope you add reaches an MCP Client only when it is authorized again. To see which tools each Grant Scope reaches, and which an Agent can never hold, see MCP Tool Reference.
Give the Agent work
- Portfolio Access: add the Agent to each Portfolio it works in, as you would a person. See Add Members to a Portfolio. With Lead Portfolio Access, an Agent can change any Assignment in the Portfolio, so give it Associate unless it needs more.
- Positions: choose the Agent in a Position's Filled by. Steps assigned to that Position, or to a Role it fills, go to the Agent. See Create and Manage Positions.
- Assignee: assign it a Task or an Assignment directly, as you would a person.
An Agent can't approve. A Step's Approver can't be a Position an Agent holds: the approver picker shows it disabled, with the reason. A Procedure's Governance panel lists the Steps an Agent does. See Update Procedure Info.
Rename or remove an Agent
- To rename it, edit its name at the top of the detail pane.
- To remove it, press Remove from Organization… on its Actions tab. See Remove a Member from an Organization.
Wherever an Agent acts, in Activity, comments, and Task lists, its name carries the Agent icon.
Related Articles
Overview
Reference
Step-by-Step