> For the complete documentation index, see [llms.txt](https://docs.protoboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.protoboard.xyz/agent-bridge/api-keys.md).

# API keys

Create, name, rename and revoke agent API keys for the Protoboard MCP server, and keep them safe

## Goal

Manage the keys that let external agents act on your boards.

Agent API keys live in **Settings > Developer**, under **Agent API Keys**. Every plan can create them, and there's no limit on how many.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-ed517aeb7ae99267fa8b98b8bd0d53f997dbe124%2Fmcp-developer-settings-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-67094e66fa00d8fe5c3ea2754eae705b0868f282%2Fmcp-developer-settings-light.png?alt=media" alt="Settings, Developer tab, listing agent API keys with their names, created dates, last used times and rename and revoke buttons"></picture><figcaption><p>Agent API Keys.</p></figcaption></figure>

## Create a key

{% embed url="<https://cdn.protoboard.ai/docs/clip/mcp-key?title=Create+an+agent+API+key>" %}
Create an agent API key
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/mcp-key-light.gif) · Steps:

1. Type a name in "Name your new key (e.g. Claude Code, laptop)". Names can be up to 100 characters.
2. Click **Create**.
3. Click **Copy key**. The key starts with `pb_agent_` and is shown only once.
4. Click **Done**.

Use one key per agent and machine. A clear name makes it obvious which key to revoke, and the **External** tab shows the key name next to each connected agent.

## The key list

Each key shows its status, name, created date and **Last used** time. Use **Rename** (the pencil) to change the name.

## Revoke a key

1. Click **Revoke** (the trash icon) next to the key.
2. In **Revoke API key?**, click **Revoke key**.

Agents using the key lose access immediately. A revoked key stays in the list, dimmed, until you click **Remove from list**. Revoking can't be undone; create a new key instead.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-7d503c3d1f8a30e83ba9e3f08ecbc7bc2b98b5dc%2Fmcp-revoke-dialog-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-9cc975c4d9b94764398d0c75ee18b38f6dd5c9a8%2Fmcp-revoke-dialog-light.png?alt=media" alt="The Revoke API key? dialog warning that agents using the key will lose access immediately, with a Revoke key button"></picture><figcaption><p>Revoking a key.</p></figcaption></figure>

## Keep keys safe

* Treat a key like a password: it can run any board tool on boards you can access.
* Don't commit keys. Use your client's environment-variable or secret-prompt support (see [Setup](https://docs.protoboard.xyz/agent-bridge/setup.md)).
* Revoke keys you no longer use. An old **Last used** time is a good hint.
* If a key leaks, revoke it at once and create a new one.

## Related pages

* [Setup](https://docs.protoboard.xyz/agent-bridge/setup.md)
* [Troubleshooting](https://docs.protoboard.xyz/agent-bridge/troubleshooting.md)
* [Settings](https://docs.protoboard.xyz/account/settings.md)
