Userorbit MCP server
Connect Userorbit to Claude, Codex, ChatGPT, Cursor, and other MCP-compatible clients. Once connected, an AI assistant can work with feedback, announcements, roadmaps, help-center articles, contacts, tours, demos, surveys, checklists, workflows, and support conversations using your existing Userorbit permissions.Remote MCP server URL
https://api.userorbit.com/mcptextUse the hosted server unless your client specifically requires a local stdio integration.
Before you start
You need:- A Userorbit account with access to the workspace you want to connect.
- An MCP-compatible client.
- Permission to add custom connectors in that client. Team and enterprise clients may require an owner or administrator.
Only connect Userorbit to AI clients you trust. The client can access the workspace and scopes you approve.
Choose an access level
The authorization screen shows the scopes requested by your client:- Read — View and search workspace data. This is the best choice for analysis, reporting, summaries, and Q&A.
- Write — Create, update, publish, archive, and delete workspace content. This is optional.
Start with read access. Leave write access disabled unless you intend to make changes from the AI client. You can revoke a connection at any time from Settings → Connected Apps in Userorbit.
Connect Claude
- Open Claude and go to Settings → Connectors.
- Select Add connector → Add custom connector.
- Enter
Userorbitas the name. - Enter
https://api.userorbit.com/mcpas the remote MCP server URL. - Select Add, then Connect.
- In the browser authorization window, choose a Userorbit workspace and the scopes you want to grant.
- Select Authorize.
After the browser reports that the connection succeeded, return to Claude. If the connector screen still shows the previous state, close and reopen Connectors; Claude refreshes the status when the view is reopened.
Connect Codex
In the Codex desktop app:- Open Settings → MCP servers.
- Select Add server.
- Choose Streamable HTTP.
- Enter
Userorbitas the name andhttps://api.userorbit.com/mcpas the URL. - Save, authenticate, and complete the Userorbit authorization flow.
- Restart Codex or begin a new task so the new tools are loaded.
You can also configure the shared Codex connection from a terminal:
codex mcp add userorbit --url https://api.userorbit.com/mcp
codex mcp login userorbitBashConnect ChatGPT
If custom connectors are enabled for your ChatGPT account or workspace:- Open Settings → Connectors or Apps.
- Add a custom MCP connector.
- Enter
Userorbitas the name andhttps://api.userorbit.com/mcpas the server URL. - Choose OAuth authentication.
- Connect and approve the Userorbit workspace and scopes.
The exact menu labels depend on your ChatGPT plan and workspace settings. An administrator may need to enable custom connectors first.
Connect Cursor, Claude Code, or another MCP client
Clients that support remote OAuth can connect directly to:https://api.userorbit.com/mcptextClaude Code can add the hosted server with:
claude mcp add --transport http userorbit https://api.userorbit.com/mcpBashFor clients and CI environments that support bearer authentication, you can use a Userorbit API key:
Authorization: Bearer YOUR_USERORBIT_API_KEYhttpIf the API key belongs to more than one workspace, also send
x-team-id with the target workspace ID.What you can ask Userorbit to do
Read-only examples:- “Summarize the most common feedback themes from this month.”
- “List the announcements published this quarter.”
- “Find help-center articles about onboarding.”
- “Show unresolved support discussions and group them by topic.”
- “Analyze tour performance and identify the largest drop-off.”
Examples that require write access:
- “Create a feedback item from these interview notes.”
- “Draft a help-center article, but do not publish it.”
- “Move this feedback item to planned.”
- “Publish the approved announcement.”
For important or destructive changes, review the proposed action before approving it in your AI client.
Tool permissions and approval prompts
Userorbit labels read-only tools separately from tools that can change data. This lets MCP clients allow safe list, search, and detail requests without treating them as destructive operations.Compatibility tools that combine multiple actions remain available for existing integrations. Because those tools can also update or delete content, an MCP client may request approval even when the selected action is read-only. New prompts should prefer the read-only tool shown by the client.
When your client shows Current workspace summary, prefer it for routine orientation. The detailed workspace tool remains available for diagnostics.
Disconnect or revoke access
To revoke the Userorbit authorization:- In Userorbit, open Settings → Connected Apps.
- Find the AI client connection.
- Select Revoke.
You can also remove or disconnect Userorbit from the connector settings in the AI client. Revoking in Userorbit invalidates its access and refresh tokens.