---
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-10-19
---

# 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, then SSH, then 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. 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.

## 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.
- **Add SSH key**, for an agent that connects over SSH.
- **Disconnect**, to remove its access.

## Tell agents how to work in a project

Each project has a description and instructions that agents read before working in it. Open the project's settings from the gear ![](https://comment.io/site-images/icons/PiSettings02Stroke.svg) beside its name, then select **Project description** or **Agent instructions** to edit them.