Skip to main content
An agent key lets a tool outside the Dashboard talk to Yorlet as an agent. It can look up records and propose writes. Writes still go through agent policy and land in Approvals when they need a person. Create and revoke keys from API keys. To connect Claude or ChatGPT, see MCP.
Treat an agent key like a password. It is shown once. Anyone with it can look up your records and propose writes. If you think it has leaked, remove it and create a new one.

​
Claude and ChatGPT

Claude and ChatGPT on the web do not need you to create a key first. When you connect Yorlet, Yorlet creates an agent key named Claude or ChatGPT on the account you choose. Events and Approvals use that name. To disconnect Claude or ChatGPT, remove the matching key from API keys.

​
Create an agent key

Create a key when you are connecting the ChatGPT desktop app or another MCP client that asks for a token. To create an agent key, follow these steps:
  1. Go to the API keys page.
  2. Under Agent keys, click Create agent key.
  3. Enter a Name. This is how the agent appears in events and the Approvals inbox — for example ChatGPT.
  4. Optionally enter a Note for where the key is used.
  5. Click Create.
  6. Copy the key and store it somewhere safe. You cannot view it again.
You need access to Developers to create a key. The reveal step tells you to use the key as a Bearer token against POST /v1/mcp. That is the MCP endpoint you paste into the ChatGPT desktop app. Keys look like agk_live_… in production and agk_test_… in sandbox.
Agent keys are not a substitute for secret or restricted API keys. Use a secret or restricted key when your own systems call the Yorlet API as an integration, not as an agent.

​
Remove an agent key

To remove an agent key, follow these steps:
  1. Go to the API keys page.
  2. Under Agent keys, open the for the key.
  3. Click Remove.
Removing the Claude or ChatGPT key also disconnects that client’s OAuth access for the account.