In Onyx 5.0, MCP servers moved from their own admin page to Admin Panel → Plugins.
See Where things moved.
To let other MCP clients use Onyx as a server, see Onyx MCP Server.
Add an MCP server
1
Open the MCP catalog
Go to Admin Panel → Plugins, click Add, then select MCP.
Select a catalog entry to fill in the server name and URL for that vendor.
Select Add custom MCP server for any other server.

2
Enter the server details
Enter a Server Name and the MCP Server URL. Onyx checks the server and shows the authentication method,
connection transport, and client metadata document support that it detects.
The Onyx API server must be able to reach the URL. Onyx blocks private, loopback,
and link-local addresses during setup checks.

3
Set availability
On the same page, set who can use the server and where it is available:
4
Configure authentication
Select an Authentication Method. Onyx marks the method it detected as Recommended.
See Authentication for each method.
Click Connect. Onyx lists the server’s tools and opens its settings.

Authentication
With personal API keys and OAuth,
each user connects their own account from the Plugins page.
The MCP server then returns only data that the user’s account can access.
OAuth
OAuth is the best choice for most hosted vendor servers, such as Linear, Notion, Atlassian, and Sentry.
If you create your own OAuth client, set its redirect URI to:
API key

Advanced settings

- Custom Headers are sent with every request. Use
{api_key}for each user’s API key and{user_email}for the user’s email address. Any other{placeholder}asks each user for a value when they connect. - Connection transport is Streamable HTTP by default. Onyx tries Streamable HTTP first and then SSE during the setup check. Select SSE (legacy) only if the server supports SSE alone.
Manage tools

- In Available tools, turn tools on or off for the whole workspace.
- Click Refresh tools after the server adds, removes, or changes tools. Save or discard pending changes first.

Tool availability and Craft policies are separate.
A tool that you turn off in Available tools is not available anywhere.
Configuration tab

If you change the server URL, Onyx removes the stored connections for that server. Users must connect again.
To delete a server, use the trash icon on the Plugins page. The settings dialog has no delete button.