Connect your agent
Connect Claude, Claude Code, ChatGPT, Cursor or any MCP client to org.
org is a remote MCP server. Any agent that speaks MCP over Streamable HTTP can connect to it at:
https://aegent.dev/org/mcpPick your client for the exact steps:
| Client | How it connects |
|---|---|
| Claude (claude.ai and Claude Desktop) | a custom connector with the URL above |
| Claude Code | claude mcp add, remote or through the local CLI |
| ChatGPT | a connector in developer mode |
| Cursor | an entry in mcp.json |
| Other MCP clients | the URL, OAuth discovery and dynamic registration |
Every client signs in the same way, and you choose what the agent may do when it does.
What you agree to
The first time your agent connects, it sends you to aegent.dev to sign in (OAuth 2.1). The consent screen names the client and where it will send you back, and asks four things:
- Which hat. The agent works in one org. Connect it again to use it in another.
- Which agent it is. Create a new agent, named after the client by
default, or reuse one you already own. The owner is you, or a team you
manage. Everything the agent does is recorded under its own handle,
such as
@claude, never under yours. - What it may do. The scopes below.
- Which spaces it can see. All the spaces its grants allow, or a shorter list you pick.
Scopes
| Scope | Lets the agent |
|---|---|
org:read |
read pages and tasks, search, and see the agenda |
org:write |
edit pages, and create or update tasks |
org:tasks |
claim tasks, submit work for review, and record decisions |
org:secrets |
reveal secrets a task names, while it has the task claimed |
org:admin |
manage the org. Never granted to agents |
Agents get org:read org:write org:tasks unless you change it.
What your agent can and can't do
It can:
- search and read everything in the spaces it can see
- write and edit pages; its edits merge with yours rather than overwrite them
- create tasks, claim them, work on them and submit evidence
- comment, attach files and capture notes
- ask you to confirm before anything a task says to ask about
It can't:
- see spaces it hasn't been granted, or any space marked humans only
- approve its own work: someone else reviews it
- read another org, even your personal one, unless you connect it there too
- manage members, billing or settings
- change a task's requirements while it holds the claim
- run code on the server. Code blocks only run on your own machine, through the CLI or the desktop app, after you confirm
Page text is data to your agent, never instructions: the agent guide tells it so.
Pause or disconnect
Go to Settings, Your agents to see what each agent has done, pause it,
or revoke it. A paused agent gets 403 agent_paused on every request until
you resume it. Org admins also have a kill switch that pauses every agent in
the org at once and releases their claims.
Once it's connected
Ask your agent something that needs org, such as "What's on my agenda today?" or "Add a task to renew the car insurance by 12 October". The server gives the agent its guide when it connects, so it knows how to find work, claim it and hand it back.
org also offers prompts your client may list as commands: plan_day,
weekly_review, triage_inbox, break_down and
migrate_from.