Skip to main content

Connect an MCP Server

Add an external Model Context Protocol (MCP) server to your organization. MCP servers expose tools that your agents can use during workflow execution.

Prerequisites​

  • A running MCP server accessible via HTTP
  • Any credentials the server requires (see Add a Credential)

Steps​

1. Navigate to MCP Servers​

Open the sidebar and click Settings, then MCP Servers. You see a grid of MCP server cards for any servers already connected.

MCP Servers settings page

2. Click "New MCP Server"​

Click the New MCP Server button or card. A new server card appears, or you are taken to the creation form.

3. Enter the server name and description​

Give the server a descriptive name (e.g., "Brave Search", "GitHub Tools", "Sentry"). This name appears in the UI when browsing available tools.

Optionally, add a description to explain what the server provides. The description appears on the server's card tile in the grid view.

tip

Servers added from the "Popular MCP Servers" catalog come with a name and description already filled in.

4. Enter the server URL​

Provide the full URL where the MCP server is reachable. This is the HTTP endpoint that implements the MCP protocol.

https://mcp.example.com
http://localhost:8080
info

The URL must be reachable from the ORQO server at connection time and from the ORQO server at workflow execution time. For local development, use localhost or Docker service names.

5. Assign credentials (if required)​

If the MCP server requires authentication, assign the appropriate credential from the credential selector. The credential is passed to the server during tool discovery and execution.

6. Save and verify the connection​

Click Save. ORQO connects to the server and attempts to discover its available tools via the MCP protocol. If the connection succeeds:

  • The server card shows a verified status
  • Discovered tools appear as a list on the server card

If the connection fails, the card shows an error status with details about what went wrong (network error, authentication failure, protocol mismatch).

7. Review discovered tools​

After a successful connection, expand the server card to see all discovered MCP tools. Each tool shows:

  • Name -- The tool's identifier (used in agent configurations)
  • Description -- What the tool does

These tools are automatically bundled into a linked Skill that ORQO creates for the server. The Skill appears on the Integrations page and in the Team Builder, ready to be assigned to agents.

tip

You don't need to manually create a Skill — ORQO auto-creates one when you connect an MCP server. Just assign the Skill to your agents in the Team Builder.

8. Update or reconnect​

If the MCP server's tool set changes (new tools added, tools removed), click the server card and trigger a re-discovery. ORQO refreshes the tool list from the server.

9. Delete an MCP server​

Click the server card and then Delete. This removes the server and all its discovered tools from your organization. Any skills or agents referencing these tools will lose access to them.

App-managed servers cannot be deleted

MCP servers created by an App (e.g., Slack, GitHub) are locked. They show a "Locked" badge and cannot be edited or deleted. To remove them, uninstall the parent App from Settings > Apps.

What's next​

Learn more​