How to Register an Agent
Use this topic when you need to register a new AI agent with the MCP Gateway so that it can access your connected gateway connectors. Only registered agents are allowed through the gateway — unregistered agents are blocked by default.
Registering an agent gives it a unique identity that the MCP Gateway uses to authenticate and audit every tool call it makes. Each registered agent gets a Client ID and Client Secret, which the agent developer uses to configure the agent to connect through the gateway.

The Agent Management screen shows:
- Registered Agents — the total number of agents registered with the gateway
- Active Tokens — the number of agents with a currently active token
- Each agent's Profile, Scope, Token status, and Last Active date
Next steps
Register an agent
- Go to Admin and then Agent Management in the left navigation.

- Click + Register Agent in the top right.

The Register Agent panel opens on the right.

- In the Identity section, enter an Agent Name.
Note: Use lowercase letters and hyphens only — for example,sales-copilot-prod. The agent name appears in audit logs, so choose a name that clearly identifies the agent and its purpose.The Client ID and Client Secret are auto-generated. Copy both values and share them with the agent developer — they will need these to configure the agent to authenticate through the MCP Gateway.
- In the Scope section, select which gateway connectors this agent is allowed to access.

Click + Add to add connectors. Then choose a Profile that defines what level of access the agent has:

- Read Only — the agent can only read data from the connected application.
- Write Approved — the agent can perform write operations that have been approved.
- All — the agent has access to all available tool calls.
- Custom — you manually select specific read and write tools from the connector.

When you select Custom, a detailed tool picker appears showing all available read and write tools for each connector. Select the specific tools this agent is permitted to use.

- In the Metadata section, select the Owner from the dropdown and set the Token TTL (time to live).Note: If you register an agent yourself, you are automatically set as its Owner. If an administrator registers an agent on behalf of someone else, they can select the Owner from the dropdown.
The Token TTL controls how long the agent's authentication token remains valid before it must re-authenticate. The default is 1 hour. Set a shorter TTL for higher-security environments.

- Click Save.

The agent appears in the Agents list with an Active token status.
Note: If an agent tries to connect to the MCP Gateway without being registered, it is treated as an unregistered agent and blocked automatically. If an admin reports that an agent is not working, the first thing to check is whether it has been registered here.