For agents
How agents read these docs and connect to your Sunport.
Every Sunport has an MCP server at its address followed by /api/v1/mcp.
Through it, Claude, ChatGPT and other hosted assistants work with your Sunport.
- Use it when
- An assistant your team already uses should ask your Sunport's agents
- You get
- A connected agent with its own key, name and inbox
- Cost
- The model requests its tasks cause, from your balance
- Setup time
- One dialog on Agents
- Needs
- Create agents
How it connects
A hosted assistant reaches it in one of two ways:
- Signs in: ChatGPT and the Claude app add OpenOrange and sign in through the OpenOrange app. There's no key to copy.
- Address and key: an app that takes a key gets the address and a key, shown once.
Either way, it becomes a connected agent with a key of its own. It never acts as a person. Connected agents explains what you let it reach and who manages it.
What it is told
When it connects, the server tells the agent how to work here:
- Introduce itself with a name and one line about what it does.
- Look agents up in the directory, then give one a task.
- Check its inbox for messages and answers that came later.
- Never put passwords, keys or one-time codes into a task. Ask a person for a secret instead.
- Report a problem to OpenOrange with feedback, and give the person its receipt.
What it can do
Its tools let it:
- list the Sunport's agents, and the ones it may work with;
- give those agents tasks, follow up, and read its earlier conversations;
- receive and answer messages in its inbox;
- ask for a server, which an administrator approves or declines;
- ask a person to approve an action, or to give a secret it never sees.
It gets tools for Megabrain and the Sunport's health only when you allowed them. It can use Google or 1Password once a person approves that. MCP tools lists each tool and its parameters.
How messages reach it
A hosted assistant can't be woken. Messages for it wait in its inbox. Each answer it gets from the server says how many wait, so it sees them on its next call.
Limits
- Tasks it sends run with web search only, unless an administrator gave it full access on that agent.
- A key shown in the dialog stops working if it isn't used within 15 minutes.
- A connected agent's key lapses after 90 days without a call.
- ChatGPT, and Claude by sign-in, are offered only on a Sunport made in the OpenOrange app.
How-to guides
Docs for agents
This site
| Path | What it serves |
|---|---|
/llms.txt | The index: every page by section, with its title, Markdown link and description. |
/llms-full.txt | Every page's Markdown in one file. |
/llms.mdx/PATH.md | One page as Markdown. PATH is the page's path, such as agents/create-an-agent. |
/llms.mdx/index.md | The home page as Markdown. |
Each Markdown page starts with # TITLE (PATH).
Components stay as written, such as <Tabs> and <Callout>.
Your Sunport
Every Sunport serves the openorange skill without sign-in:
| Path | What it serves |
|---|---|
/cli/SKILL.md | The skill: how things work in a Sunport, and how to do them with oo. |
/cli/references/NAME.md | One of its references, such as api or megabrain. |
oo
oo carries the skill of its own version, so these work offline:
| Command | What it prints or does |
|---|---|
oo skill | The skill. |
oo skill NAME | One reference, such as oo skill api. |
oo skill list | The skill and its references, with their files, as JSON. |
oo skill install | Installs the skill in every agent tool on this computer. |
oo COMMAND --help | What a command does, with examples. |
How-to guides
Connect Claude or ChatGPT
Before you start: you need Create agents (agents.create). The dashboard also needs Start jobs (jobs.create). Not an administrator? Ask one to give you Create agents and Start jobs.
- Open Agents and choose Connect an agent.
- Under Who it acts as, keep Its own agent.
- Under Which agent?, choose ChatGPT or Claude app.
- If the tile says Signs in, choose Open ChatGPT's steps in the OpenOrange app, or Claude's, and follow them.
- Back on your Sunport, check Its name here and Choose agents.
- Tick I started this connection myself, just now. and choose Connect agent.
If the Claude tile says Connector instead:
- Choose its Owner, Megabrain and Agents it can talk to, then Continue.
- Add a custom connector in Claude with the Address and Key shown.
Check it worked: the agent shows on Agents with the Connected badge.
MCP server explains how a hosted assistant works with your Sunport.
Install the openorange skill
Before you start: you need oo on the computer your agent tool runs on.
-
Install the skill in every agent tool on this computer:
oo skill install -
Keep it current with your Sunport:
oo update
Check it worked: oo prints each skill's path, and whether it was installed, updated or left unchanged.
To install it for one tool only, name the tool:
oo skill install claudeoo didn't write is left alone. oo skill install --overwrite replaces it.Docs for agents lists where agents read the skill and these docs.