Skip to Content
Chameleon Docs

Connect an agent

Connect your AI assistant with one prompt, or call the API with a key.

An agent is an AI assistant, or a script, acting for your account. It works on your manuals as you, within the scopes it was granted and the permissions you switch on for it. You see every agent you've connected, change its permissions and revoke it on the Agents page.

Set up with your assistant

The quickest way: copy this prompt and paste it into the AI assistant you want to connect. It adds Chameleon itself where it can, or walks you through your app's settings where it can't.

Prompt for your assistant
I want to connect you to Chameleon through its MCP server.

Server: https://www.chameleonlabs.org/api/mcp  (remote, Streamable HTTP)
Sign-in: OAuth in my browser. No API key is needed.

1. If you can add MCP servers yourself (for example Claude Code or Cursor), add this one,
   named "chameleon". Otherwise, walk me through adding it as a custom connector in your
   app's settings, step by step.
2. When a browser window asks me to sign in and approve access, I'll do that.
3. Once connected, call the guide tool, then tell me in a few lines what you can help me
   do with my manuals.

Never ask me to paste a password, code or API key into this chat.

When a browser window opens, sign in to Chameleon and approve the assistant. The consent screen shows what it asked for. There's no key to copy: the assistant keeps its own sign-in and renews it.

Once connected, the agent is told how to work through a manual: ask it for a deck, and it follows the platform's own guidance step by step.

Set it up yourself

The MCP endpoint is:

https://www.chameleonlabs.org/api/mcp

Add it to your app as a remote (Streamable HTTP) MCP server, often called a custom connector. The app opens a browser for you to sign in and approve it, as above.

An API key

An API key serves an unattended script. Create one on the Agents page; it is shown once, so store it then. Send it on every request as either header:

x-api-key: chameleon_…
Authorization: Bearer chameleon_…

A key may call the MCP endpoint and the REST API alike.

Scopes

ScopeAllows
manuals:readReading manuals, categories, assets and pages
manuals:writeEverything else

Permissions

Beyond its scopes, each agent carries the permissions you switch on for it, such as creating manuals, running builds or publishing. Reading is always on. A new agent starts from your defaults, which you set on the same page, and publishing and deleting start off.

An agent that tries something you haven't allowed is refused with permission-off, and the agent is told to ask you. Only you can turn a permission on.

On this page