MCP Servers

MCP Servers

MCP servers let Compass use tools from other applications in Slack. For example, you might connect an MCP server for your ticketing system, CRM, internal knowledge base, or another business tool your team uses.

To use an MCP server with Compass:

  1. Add the MCP server in the Compass Admin UI.
  2. Make it available in the Slack channels where the bot should be able to use it.

Requirements

You will need:

  • The MCP server URL
  • Any authentication details required by the MCP server
  • Admin access in Compass

Add the server

  1. Sign in to the Compass Admin UI at dagstercompass.com/login (opens in a new tab).
  2. Go to MCP Servers in the sidebar.

MCP Servers page in the Compass Admin UI

From the MCP Servers page:

  1. Click Add MCP Server.
  2. Enter a clear server name.
  3. Enter the MCP server URL.
  4. Choose the authentication method.
  5. Click Test Connection when available.
  6. Click Add Server.

Add MCP Server dialog

After the server is added, Compass can discover the tools it provides.

When choosing the authentication method, select the option that matches how your MCP server controls access:

  • Auth Headers: Use this for bearer tokens, API keys, or custom headers.
  • OAuth: Use this when each Compass user should connect their own account.
  • None: Use this only for MCP servers that do not require authentication.

For OAuth servers, users can open MCP Servers, click Connect for the server, and complete the authorization flow.

Make it available in a channel

  1. Go to Channels.
  2. Open the channel where the MCP server should be available.
  3. Find the MCP Servers section.
  4. Select the servers the bot should be allowed to use.
  5. Click Save Changes.

MCP Servers section on a channel settings page

Compass will make the selected MCP tools available to the bot in that channel.

Troubleshooting

Connection test fails

Check that the server URL is correct and reachable. If the server requires authentication, confirm the headers or token values are current.

Bot does not use the server

Confirm the MCP server is assigned to the Slack channel where you are asking the question.

User cannot use an OAuth server

Ask the user to open MCP Servers and click Connect for that server.

MCP Servers page is missing

Go to Support in the Compass UI to contact support and ask to enable MCP servers for your organization.