How it works
Stellar runs a hosted MCP server. You paste its link into your AI app, the app opens a Stellar sign-in page, and you press Allow. Sign-in is OAuth 2.1 with PKCE, and the AI app registers itself automatically, so there is no API key or client ID to copy.
Your AI then acts as you: comments it posts carry your name, it sees exactly the work orders, permits and equipment you can see, and it can do only what your role in each company allows. Approving work, closing and cancelling work orders, paying, and creating or removing accounts are not available through it.
You need
A Stellar account in a company workspace. Stellar is not a public consumer service: ask your workspace Owner for an invite.
Your AI app
Any app that can add a remote MCP server or a custom connector with OAuth sign-in: Claude, ChatGPT, Cursor, Claude Code, Gemini and others.
The link
Every app needs this one link. It is the same for everyone and carries no secret: it only works once you sign in.
https://api.workstellar.ai/functions/v1/agent-mcp
Signed in to Stellar already? The console's ? help button and the iOS app both have Connect your AI, with the same steps and a Copy link button.
Step by step
Claude (claude.ai, desktop and mobile)
- Open Claude Settings, then Connectors, and choose Add custom connector.
- Name it Stellar and paste the link.
- Under Authentication choose Sign in now. Under OAuth client choose Register automatically (Stellar's sign-in server offers automatic registration, not Claude's published identity). Leave Request headers empty, then press Add.
- A Stellar page opens. Sign in with your usual username and password, then press Allow.
- Back in Claude, ask: what work orders are open at my location?
ChatGPT
- Open ChatGPT Settings, then Security and login, and turn on Developer mode (offered on Plus, Pro, Business, Enterprise and Edu accounts).
- Go to Settings, then Connectors, and press the plus (Create) to add a custom app. It only appears once Developer mode is on.
- Paste the link, pick OAuth, and press Create.
- Sign in on the Stellar page and press Allow.
- Ask ChatGPT about a work order.
Cursor
- Open Cursor Settings, then the MCP section, and choose to add a new MCP server. Cursor opens its
mcp.json. - Add the Stellar server and save:
{ "mcpServers": { "stellar": { "url": "https://api.workstellar.ai/functions/v1/agent-mcp" } } } - The server shows that it needs a login. Choose it, and your browser opens the Stellar sign-in page. Sign in and press Allow.
- In a chat, ask: who am I in Stellar? The agent should call
whoami.
Claude Code
- In a terminal, add the server:
claude mcp add --transport http stellar https://api.workstellar.ai/functions/v1/agent-mcp
- Start Claude Code, run
/mcp, choose stellar and authenticate. Your browser opens the Stellar sign-in page: sign in and press Allow. - Ask: who am I in Stellar?
Gemini
- Open Gemini and go to Settings & help, then Connected apps.
- Choose Add a custom app, paste the link and press Next.
- Sign in on the Stellar page and press Allow.
- Back in Gemini, ask: what work orders are open at my location?
Custom apps need Keep Activity turned on (Settings & help, Activity) and a personal Google Account. On a work account, an admin adds the link under Settings & help, Manage team, Connected apps, Add MCP Server.
Any other MCP client
- Find where your app adds a remote MCP server or custom connector (transport: Streamable HTTP).
- Paste the link. If it asks how to sign in, pick OAuth and let it register itself (dynamic or automatic client registration). Leave any API key or header fields empty.
- Sign in on the Stellar page and press Allow.
What the Stellar page shows
The sign-in page names the app and says it wants to work in Stellar as you, lists what it will be able to do, and shows the workspaces and roles it would act under. Allow lets it in; Cancel sends you back with nothing granted. If someone else is signed in on that browser, use Not you? Sign out first.
What your AI can do
- • Read the work orders, threads, photos and PDFs you can see, and what is slipping on the board.
- • Post comments in your name, set dates, move tickets between working lanes, say what a ticket is waiting on, and open new work orders, if your role allows.
- • Keep the Compliance register of permits and inspections and each location's equipment list, if your role allows.
- • Answer join requests, if you may invite people. Approving lets that person into your company at once.
Each tool tells your AI app whether it only reads or changes something, so the app can run reads without interrupting you and ask before a change. Every change is logged on the work order or permit it touched, the same as if you had made it in the app.
What reaches your AI app
When your AI calls a Stellar tool, Stellar sends that app the answer: the work orders, comments, names and @handles, permits, equipment, photos and documents the call asked for, limited to what you can see. From then on that content is handled by your AI provider under its own terms and privacy policy. Read more in the Privacy Policy.
To disconnect
Remove the Stellar connector or server in your AI app (Claude: Connectors; ChatGPT: Connectors; Cursor: its MCP settings; Claude Code: claude mcp remove stellar; Gemini: Connected apps). The app can do nothing more once it no longer holds its sign-in. To have the grant revoked on Stellar's side as well, or if you think an app's sign-in leaked, email support@workstellar.ai.
Troubleshooting
The Stellar page says the request expired or is invalid
The sign-in window closed or took too long, the link was pasted with a typo, or the page was opened directly rather than by your AI app. Copy the link again and start the connection again from your AI app.
My AI says unauthorized
Its permission has expired or was revoked. Remove the app in your AI's connector settings and add it again with the same link.
It cannot find a work order I see in the app
Ask it to run whoami: it may be signed in as a different account than the one you expect. If it answered in someone else's name, remove the app, add it again, and use Not you? Sign out on the Stellar page.
Can I attach a photo I dropped into the chat?
Not from a chat app: the model sees a description of the photo, not the file. Add it in the Stellar app, or reply to an email from that work order with the photo attached. An AI with a shell or an HTTP tool (Cursor, Claude Code) can upload a file it has on disk.
What about a bot of our own?
This page is for people connecting their own account. A company bot does not sign in as anyone: a workspace Owner creates it in the console (Users, AI agents), and it gets its own restricted user and its own key.
Need help?
SP Wealth LLC (doing business as Workstellar)
Email: support@workstellar.ai
Support: workstellar.ai/stellar-support
Include your name, your workspace's name, the AI app you are connecting, and what you see.