---
title: "Connect your agent"
description: "Connect Claude Code, Codex or any other agent to your workspace, so it can read and change your documents for you."
canonical: "https://comment.io/docs/connect-your-agent"
last-updated: 2026-11-18
---

# Connect your agent

Connect Claude Code, Codex or any other agent to your workspace, so it can read and change your documents for you.

## Connect an agent

1. Open your account menu and select **Settings**, then **Agents**.
2. Under **Connect an agent**, you can type the name the agent goes by in the workspace. Leave it empty to let the agent choose.
3. Select **Copy setup prompt** and paste the prompt into your agent.

The agent picks the best way to connect it can use: MCP if your agent supports it, otherwise the HTTP API. It tells you what to approve. When it gives you a link, open it while logged in to Comment.io and approve the agent.

If the agent asks you for an API token, select **Create one** under the setup prompt, then give the token to the agent. It's shown only once.

## What your agent can do

An agent works for the person who connected it. It can open and change exactly what you can, and its comments and edits show its own name, so everyone can see what it did. Ask it what's new and it reads your [Recent changes](https://comment.io/docs/catch-up) list. When you leave a workspace, your agents leave with you.

Agents read their own guide at [llms.txt](https://comment.io/llms.txt). You can give that address to any agent to get it started.

## Let an app work as any member

In workspaces where Comment.io has turned this on, owners see **Settings → Admin → Integration token**. Select **Make token** and give the token to an app, such as a team chat bot, so it can work as any member of the workspace, with that member's access. What it does shows as that member's agent, named from **Agent name** on the same page: "{name}'s Agent" until an owner changes it, where {name} becomes the member's name, for example "Ada's Agent". Changing it, or a member changing their own name, renames their agent at once. These agents aren't listed under **Connected agents**.

The token is shown once. **Make new token** replaces it and **Revoke token** ends it; either way, every app using the old token stops working at once. The token keeps working even if the owner who made it leaves.

## Manage your agents

**Settings → Agents** lists the agents connected to the workspace under **Connected agents**. Open the menu on one of yours to:

- **Upload photo** or **Change photo**, so its comments and edits are easy to spot.
- **Create API token** or **Roll API token**, to give it a new token. Rolling replaces the old one.
- **Disconnect**, to remove its access.

## Tell agents how to work in a team

Each team has a description and instructions that agents read before working in it. Open the team's settings from the gear beside its name, then select **Description** or **Agent instructions** to edit them. My Space has its own description and instructions too.
