MCP Connectors are not available on Orion trial workspaces.
Open MCP Connectors
- Click Admin Settings in the left-hand navigation menu
- Select Integrations
- Open the MCP servers card
Add an app from Browse Apps
Browse Apps is a fixed catalog of vendor-hosted servers. Filter it with the category chips or Search apps. A card says One-click sign-in when Orion registers itself with the vendor. It says Needs a Xero app, with the vendor’s name, when an admin must first create an app in the vendor’s own settings.- Click an app’s card
- Read the dialog. Requires names the vendor plan or role you need, where one applies
- Pick a Region if the dialog offers one
- Click the add button, such as Add Stripe
Add a custom server
Click Add Custom MCP in the upper-right corner of the page.- Enter the MCP server URL. It must be a public address. Orion suggests a Name and Display name from the domain and shows a favicon Preview
- Edit the Name if you like. It starts with a letter, uses only lowercase letters, numbers, and hyphens, and is at most 32 characters
- Describe the server under What it does. Orion reads this to decide when to use the server, and the field is required
- Choose Authentication and fill in what it asks for
- Click Connect, or Register server for OAuth
Header values are stored encrypted and sent on every request. You cannot view a value after saving it. Click to remove a header row. For OAuth, leave Client ID blank to register automatically when the server supports it.
If the URL is not accepted, the form says “Enter the full URL of the MCP endpoint, starting with https://.” If Orion cannot reach the server, it says “Orion could not connect to this MCP server. Check the URL and headers, then try again.” An address Orion refuses, such as a private one, shows only the generic “Failed to add the MCP server”.
Review the tools
A new server is stored with every tool turned off. Open it from Connected and use the Tools tab. Nothing runs in chat until you review the tools and save.- Search the list, or use the filter to find the tools marked Needs review
- Set each tool’s access to Read only or Writes data
- Turn off the tools you do not want. On the first review the form selects every tool, so the header reads “N of N selected”. To start from none, choose Disable all in Bulk actions
- Click Confirm tools. Once nothing needs review, the button reads Save changes
- In the review dialog, check every tool. Each reads “Will be enabled” or “Will stay disabled”. Then click Confirm tools and save
Refresh and changed tools
Click Refresh tools to check the server again. Save pending edits first, or the button is disabled. Orion then lists what is New, Changed, or Removed, or says “No changes. The tools match what you approved.” New and changed tools stay off until you review and confirm them. A server that changed a tool after you approved it shows a Tools changed badge. Its page says “This server changed its tools since you approved them. Orion will not call it until you refresh and review the tools.” On a shared-header server, an Unreachable badge means the last refresh got no answer, and Orion does not use it until you refresh.Choose who can use a server
Open the Access tab. Under Who can use this connector, choose Entire workspace or Selected groups. With Selected groups, pick at least one group. An empty selection does not grant workspace access. Access is only the first gate. Users also need an eligible role, access to their project, and their own OAuth connection when the server requires one. Viewers cannot use connectors. Tenant Admins can also assign servers from a group’s Integrations tab. The switch on each row of Connected turns a server on or off for everyone. A Tenant Admin can still try a turned-off server to test it.Turn a connector on in a project
Registering a server does not give any chat its tools. Each project opts in.- Open the project’s Settings and select the Connectors tab
- Turn on the server’s switch, such as Use Stripe in this project
Use a connector in chat
Once a server is enabled, reviewed, and opted in for the project, Orion can offer its tools in a chat in that project. To point Orion at one server, type@ in the chat input and choose it under MCP Connectors. The menu lists only servers you can use in this project, with no Unreachable or Tools changed badge and at least one enabled, reviewed tool. A Writes data tool stops until you approve it. On the web app, an approval card shows Approve and Deny. On the CLI and ask_orion, the reply carries an approval code instead, and the calling agent asks its user to confirm it. The tool runs only after approval.
Connector tools run in chat on the web app, the CLI, and ask_orion. They do not run in Slack or Gemini Enterprise, where one identity may serve several people. A Workflow step can also call a connector. See Calling a Connector.
Change or delete a server
Open the Settings tab to change the Display name, URL, What it does, headers, or OAuth fields. Click Save changes. Use Replace headers to enter new values, because stored values are never shown. Changing the URL has consequences. It clears the reviewed tools and turns every tool off until you review them again. On an OAuth server it also disconnects every account. On a shared-header server, enter the headers again, because Orion will not send the old ones to a new address. To remove a server, click Delete at the bottom left of its page and confirm. The dialog says: “Chats lose its tools right away, and workflow steps that call it will fail until they are changed. Stored credentials and account connections are deleted.”Who can do what
A project admin decides which servers a project uses. See Projects for the project roles.